升級Qlik 資料閘道 - 直接存取

新功能和增強事項

Direct Access gateway 1.6.5 推出下列功能和提升事項：

• 支援 SAP ODP 連接器

  此版本推出透過 直接存取閘道 存取 SAP ODP 來源的功能。若要促進使用這項功能，新的資料閘道欄位已新增至 SAP ODP 連接器。新的欄位允許客戶選擇要使用哪個閘道來存取 SAP ODP 來源。

  另請參閱：SAP ODP 連接器 （僅提供英文版）

• 延伸記錄功能

  此版本推出新的記錄器，Qlik 支援可用來解決特定閘道元件的問題。

• 新支援的區域

  日本現在作為 Qlik Cloud 租用戶區域受到支援。

• 效能提升

  改善加密工作階段的記憶體分配。

已解決的問題

Direct Access gateway 1.6.5 解決了下列問題：

• 安全性弱點

  使用 ODBC 連接器時，密碼會寫入到 DCAAS 記錄。

• 流程隔離效能

  在負載較重的情況下，流程會需要較長時間才能開始。

• 不正確的安裝路徑

  安裝 直接存取閘道 一律會將 Qlik 設定為根資料夾，即使使用者在設定精靈中選擇不同的資料夾也是如此。

新功能和增強事項

• 支援從 管理主控台 檢視和下載記錄檔案

  此版本推出在 管理主控台 檢視 直接存取閘道 記錄檔案以及與 Qlik 支援共用 (如有需要) 的功能。在一般情況下，沒有理由要檢視記錄檔案，但若您遇到重複故障或其他問題，記錄檔案通常有助於查明原因。

  另請參見：檢視和下載記錄檔案

• 支援無訊息安裝 直接存取閘道

  客戶現在可以無訊息安裝 直接存取閘道，若您需要在組織各處的數個機器安裝 直接存取閘道，這很實用。

  另請參見：無訊息安裝 直接存取閘道

• 改善工作階段持續性

  載入工作階段到期後，有時候會發生 DirectAccess-1012 錯誤。現在，直接存取閘道 將會更頻繁地檢查 Qlik Cloud 連線情況，以嘗試讓載入工作階段保持運作。

已解決的問題

Direct Access gateway 1.6.4 解決了下列問題：

• configuration.properties 檔案中不正確的參數名稱

  對 直接存取閘道 執行新的安裝時，configuration.properties 檔案中的 EXTEND_FIRST_REQUEST_TIMEOUT 參數名稱會變成不正確的 FIRST_REQUEST_TIME_EXTENSION。

• 載入 Pod 可用性

  若多個載入共用了相同的載入 ID，QCS 中的載入 Pod 數量會達到上限。

直接存取閘道 1.6.3 包括下列提升事項和錯誤修正：

• 資料遺失預防

  在之前的版本中，為了預防潛在的資料損失，Direct Access gateway 在載入期間不會自動重新連線至資料來源。從此版本中，Direct Access gateway 現在將會根據需求，自動重新連線至資料來源。為了預防資料損失，將會在重新連線之前驗證已完成的載入摘要。若偵測到資料損失，載入將會失敗。

• 重新載入工作階段逾時

  在罕見的情況下，載入工作階段會永遠保持運作。為了預防這類情況，此版本對載入工作階段採用了三小時逾時。

• 載入要求逾時延期

  載入有時候會因下列錯誤而失敗：

  Connector error: The session does not exist (DirectAccess-1509)

  Connector error: The stream session expired for the load data request (DirectAccess-1012)

  為了減輕此問題，EXTEND_FIRST_REQUEST_TIMEOUT 參數 (用於延長載入請求逾時) 已新增至 configuration.properties 檔案。預設為「0」。經常遇到這些錯誤的客戶應嘗試將逾時設定為 5-10 分鐘。

• 詳細連線錯誤訊息支援

  新增了透過 Direct Access gateway 連接器使用 ODBC 時對檢視詳細連線錯誤訊息的支援。客戶現在可以在進階連接器設定中將 ShowErrorDetailMessage 參數設定為「True」，以查看 ODBC 驅動程式傳回的完整錯誤。詳細錯誤訊息將會顯示在資料載入編輯器中。

  資訊備註錯誤訊息由您正在使用的資料來源完整提供。Qlik 不會對錯誤訊息附加任何其他資訊或以任何方式編輯錯誤訊息。

• 使用相同重新載入 ID 處理多個重新載入

  從此版本，引擎工作階段 ID 將會用來以相同的載入 ID 分辨多個載入。這將可預防潛在衝突，造成因下列錯誤而載入失敗：

  Connector error: data loading error (DirectAccess-4008

直接存取閘道 1.6.2 解決了在處理序隔離模式下工作時，有時候會造成連接器代理程式毀損的問題。

新功能和改善事項

Direct Access gateway 1.6.1 推出數個重要功能和加強事項，改善整體穩定性和效能。

• 支援在多個連接器處理程序擴張載入

  連接器處理程序隔離已新增至 Direct Access gateway。此為選擇加入的功能，因此預設為關閉。 流程隔離允許可直接存取閘道伺服器作業系統的管理員控制每個連接器類型有多少處理程序可用於載入。在多個連接器處理程序上擴展載入會增加隔離程度，方法是減少每個連接器處理程序上同時執行的載入次數。若發生連接器毀損，這反過來可以改善整體 直接存取閘道 穩定性。

  另請參閱：遷移連接器在載入期間毀損

• 已新增在使用 SAP BW (透過 Direct Access gateway) 連接器時停用區塊化的功能

  此版本為 SAP BW (透過 Direct Access gateway) 連接器推出 BEX_ONE_CHUNK 應用程式參數。直接從 Qlik Cloud (亦即不是透過 Direct access gateway) 存取 SAP BW 時，若要最佳化效能，結果集合會在 SAP 後端分為區塊，並讀取為獨立的執行緒。不過，透過 Direct access gateway 存取 SAP BW 時，將結果集合分為區塊沒有實際優點。相反地，這會在 SAP 中取用更多共用記憶體，因為這需要為資料傳輸的持續時間建立其他暫存表格。可以 (雖然通常不需要) 在 appsettings.json 檔案 (這位於 SAP 連接器二進位資料夾) 中設定 BEX_ONE_CHUNK:false，以開始區塊化。

• SAP BW (透過 Direct Access gateway) 和 SAP SQL (透過 Direct Access gateway) 連接器的診斷改善事項

  對於 SAP BW (透過 Direct Access gateway) 和 SAP SQL (透過 Direct Access gateway) 連接器記錄，已在記錄檔副檔名之前新增 _port 後置詞，且 ProcessID=### 訊息已新增至連接器的記錄檔，以辨別事件與聽取相同連接埠之連接器的新執行個體。

• 重新連線改善事項

  已改善載入期間的重新連線機制，因此 Direct Access gateway 不再需要連線至啟動載入的 Pod (之前是如此)。現在，不必重複嘗試連線至啟動載入的 Pod (通常會造成載入失敗)，而會連線至第一個可用的 Pod。

已解決的問題

Direct Access gateway 1.6.0 解決了下列問題：

• 透過 Direct Access gateway 的 ODBC 連接器記錄：

  從不同的資料來源執行載入時，來自一個資料來源的處理程序會錯誤出現在其他資料來源的記錄中。

• 設定中遺漏的檔案

  在 Direct Access gateway 安裝期間不會複製 configuration.properties 檔案。

• Qlik Cloud 資源擴充期間發生載入錯誤

  Qlik Cloud 資源擴充有時候會造成 DirectAccess-1006 錯誤。已進行加強事項，針對發生在透過 Direct Access gateway 執行之應用程式載入期間的特定 Qlik Cloud 資源擴充情境，改善處理情況。

• Snowflake 連線失敗

  透過 ODBC (透過 Direct Access gateway) 連接器連線至 Snowflake 會失敗。

• DLE 中的偵錯應用程式指令碼失敗

  資料載入編輯器 (DLE) 中啟用限制結果選項的偵錯應用程式指令碼有時候會失敗，並具有下列錯誤：

  Connector error: Invalid load request (DirectAccess-1006).

已解決的問題：

• ODBC (透過 Direct Access gateway) 連接器：連接器有時候會在取消載入大型表格時毀損。已進行改善，以協助預防此狀況。

• Microsoft SQL Server (透過 Direct Access gateway) 連接器：嘗試與託管於較舊 Windows Server 版本的 SQL Server 建立連線時，連線會由於 TLS 相容性問題而失敗，並傳回下列錯誤：

  Please check the values for Username‚ Password‚ Host and other properties. Description: Client unable to establish connection - ERROR [08001] [Qlik][SqlServer] Problem establishing connection to the server.

  已更新 SQL Server 驅動程式，以校正該問題。

• SAP SQL (透過 Direct Access gateway) 連接器：嘗試預覽表格時，有時候會發生下列錯誤：

  Exception of Type System.OutOfMemoryException

• SAP SQL (透過 Direct Access gateway) 連接器：嘗試預覽表格有時候會在幾分鐘後逾時，並有下列錯誤：

  Request could not be completed.

• SAP SQL (透過 Direct Access gateway) 和 SAP BW (透過 Direct Access gateway) 連接器：已將診斷資訊新增至記錄，以協助解決多個並行請求。

新功能和增強事項：

• 為新的 ODBC (透過 Direct Access gateway) （僅提供英文版） 連接器提供支援。

• 管理主控台 中的版本欄現在將顯示 直接存取閘道 版本，而非 RepAgent (子元件之一) 版本。

已解決的問題：

• 升級 直接存取閘道 會將進階 ODBC 連接器記錄設定 (例如記錄檔保留和大小上限) 重設為預設。
• 在罕見的情況下，ODBC 連接器會毀損，並可能透過 直接存取閘道 代理程式重新啟動。
• 若連線失敗或 SQL 查詢無效，會傳回一般的「位移和長度超出範圍...」錯誤，而非實際的錯誤原因。
• 在罕見的情境下，對於大於 3 GB 且延長延遲或在初始閘道查詢後處理的應用程式，中心載入會失敗，並具有「DirectAccess-4008」錯誤。已新增其他記錄，以協助識別任何相關問題。

已解決的問題：

• 變更 C:\ProgramData\Qlik\Gateway\configuration.properties 檔案中的 ODBC_LOG_LEVEL 值不會有影響。

• 若在幾分鐘內未使用作用中的直接存取閘道連線，載入會失敗，並具有下列錯誤：

  Connector error: Invalid load request (DirectAccess-1006)

  若工作階段仍在進行，只要不逾時，就能解決問題。

• 從 MySQL 和 PostgreSQL 載入具有多欄的表格有時候會失敗，並具有下列錯誤：

  System.InvalidOperationException: Failed to HPACK encode the headers

• 若使用者對於包含直接存取閘道的受管理空間沒有權限，會顯示下列不明確的錯誤：

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Object reference not set to an instance of an object.

  已使用更精確的問題描述改善該則錯誤訊息。

• 多次載入嘗試有時候會因為記憶體取用量過多而失敗。

功能和增強事項：

直接存取閘道 定期檢查其健康狀態。從此版本開始，若五分鐘沒有回應，健康狀態檢查將會重新開始 直接存取閘道 服務。

已解決的問題：

• 若透過立即傳回中繼資料但僅在幾分鐘後傳回第一個資料區塊的查詢開始載入，有時候會發生下列錯誤：

  Connector error: data loading error (DirectAccess-4008)

• 在特定情境下，直接存取閘道 不會在載入中斷時重新連線至 Qlik Cloud。

• 在罕見情況下，會在載入期間遇到下列錯誤：

  No connection could be made because the target machine actively refused it.

• 連線至 SQL Server 時，不會正確編碼密碼中的特殊字元，進而產生下列錯誤：

  Command test connection returned non-success: Error message: Please check the values for Username‚ Password‚ Host and other properties. Description: Access credentials are not valid for this connection.

• 若在查詢傳回資料時從使用者介面中止載入活動，ODBC 連接器有時候會損毀。

• 在與大量載入相關的罕見情況下，載入有時候會失敗，並具有下列錯誤：

  Connector error: Unknown reason:. Index was outside the bounds of the array. (DirectAccess-1500)

已更新驗證 Qlik Cloud 租用戶所需的 CA 憑證。

此版本解決下列問題：

Qlik 資料閘道 - 直接存取 1.3.1 在特定情境下容易過度使用 CPU。版本 1.3.2 解決了此問題，不含其他變更。為了預防 CPU 相關故障，我們鼓勵所有客戶立即升級至版本 1.3.2。

此版本包括 Qlik Cloud 政府 的 CA 搭售並解決數個問題。

Qlik Cloud 政府 的 CA 搭售檔案

CA 搭售驗證 Qlik Cloud 租用戶的身分，藉此確保受信任的連線。

在之前的 直接存取閘道 版本中，適用於 Qlik Cloud 政府 客戶的 CA 搭售檔案由 Qlik 根據需求提供。從此版本起，CA 搭售檔案會納入安裝中。

在預設設定中，CA 搭售檔案會安裝於下列位置： C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

已解決的問題

• 已識別安全性弱點，藉此用於 Proxy 連線性的 HTTP 用戶端會按照重新導向。

• 直接存取閘道 代理程式有時候會隨著下列錯誤而損毀：

  Unable to write data to the transport connection: An established connection was aborted by the software in your host machine

• 例外情況有時候會發生在記錄初始化期間，這會導致 直接存取閘道 等待重新啟動。
• 已改善載入工作階段處理，以防不必要的逾時。
• 管理主控台 中的 直接存取閘道 版本欄會指示錯誤版本。
• 使用者停止任務或達到配額限制之後，代理程式會繼續將資料傳送至閘道。
• 依照預設，不會啟用資料閘道的端對端加密且透過執行階段旗標控制。

此版本解決下列問題：

• Qlik 資料閘道 – 直接存取版本 1.2 可能會由於數位簽章問題而無法安裝。
• 會在升級期間覆寫設定檔案，造成變更遺失

功能和增強事項：

• 新增對 SAP BW 和 SAP SQL 來源的支援。如需關於設定與這些來源的連線性的資訊，請參閱 SAP NetWeaver （僅提供英文版）。

已解決的問題：

• 改善 Qlik 資料閘道 - 直接存取 服務的穩定性和恢復能力，不需要手動重新啟動服務
• 支援覆寫預設 直接存取閘道 安裝和設定參數

功能和增強事項：

• 已新增 Windows Server 2022 支援

已解決的問題：

• 已解決與在設定期間選擇自訂路徑有關的潛在穩定性問題

1.1.0

2022 年 10 月 18 日

功能和增強事項：

• 支援 Oracle Wallet
• 支援 Google BigQuery
• 改善錯誤訊息

已解決的問題：

• 改善驅動程式當機後的系統復原能力
• Qlik 資料閘道 - 直接存取 服務有時候會意外停止