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

新功能和增強事項

• 處理序隔離現在預設為開啟

  在先前的版本中，處理序隔離模式預設為關閉。從 Direct Access gateway 1.6.9 開始，預設是開啟，但僅限於全新安裝的情況。如果您正在升級，將會保留您現有的處理序隔離設定 (關閉或開啟，取決於升級前的設定)。

  若要進一步瞭解處理序隔離，請參閱緩解載入期間連接器毀損的情況

• 已移除 configuration.properties 檔案

  為了防止客戶誤修改錯誤的 configuration.properties 檔案，已從 直接存取閘道 安裝資料夾中移除 configuration.properties 範本檔案。現在，只會有一個 configuration.properties 文件，位於 C:\ProgramData\Qlik\Gateway。

已解決的問題

Direct Access gateway 1.6.9 透過區塊復原功能解決了下列問題：

• 載入後未刪除區塊

  載入後，有時候不會從磁碟中刪除處理過的區塊。

• 毀損後未刪除區塊

  直接存取閘道 毀損後，有時候不會從磁碟中刪除處理過的區塊。

• 記憶體取用量高

  在載入儲存區塊期間，有時候會出現高記憶體取用量。

如需更多關於區塊復原功能的資訊，請參閱儲存損毀或遺失的資料區塊以供將來載入

新功能和增強事項

• 資料區塊復原機制

  此版本支援傳送遺失或損毀的資料區塊。若要控制載入資料區塊的記憶體大小，新的屬性已新增至 configuration.properties 檔案：RELOAD_CACHE_MEMORY_MB

  如需瞭解如何設定此屬性，請參閱儲存損毀或遺失的資料區塊以供未來載入

• 不再需要 .NET 6.0.x

  從這個版本開始，執行 直接存取閘道 不再需要 .NET 6.0.x。在安裝 直接存取閘道 之前，新客戶應僅安裝 .NET 4.8 (安裝所需) 以及 .NET 8.0 和 ASP.NET Core Runtime (搭配使用 直接存取閘道)。

  如需更多關於 直接存取閘道 先決條件的資訊，請參閱系統先決條件

• 改善了相依流程的批次操作

  從這個版本開始，將會平行 (而非依序) 檢查相依流程，藉此避免由於在執行階段修改流程清單而導致的例外情況。

  如需更多關於流程隔離的資訊，請參閱緩解載入期間連接器毀損的情況

• 改善了疑難排解

  更多內容 (例如「流程 ID」和「認可大小」) 已新增至記錄中的資源使用警告。

已解決的問題

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

• 誤導性錯誤訊息

  重新啟動閘道 (手動或由於毀損) 後，請求可能會在連接器代理程式 (ConnectorAgent.exe) 初始化之前傳送至連接器代理程式。在這種情況下，錯誤訊息可能會產生誤導。現在，錯誤訊息將指示閘道已中斷連線。

• 由於中斷連線導致載入失敗

  若 直接存取閘道 在初始載入後中斷連線，有時候會導致後續載入失敗，並出現以下錯誤：

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Command getReloadSlot error for reload

  由於 Pod 關閉而導致載入失敗

  分析引擎有時候會快取早期工作階段的連線，並向已請求關閉的 Pod 傳送請求。這將導致載入失敗並出現以下錯誤：

  Connector error: data loading error (DirectAccess-4008)

• 重新啟動 直接存取閘道 服務後載入卡住

  在某些情境下，連接器代理程式在載入期間中斷連線後不會嘗試重新連線，因此導致以下錯誤：

  Reload web socket was aborted due to a failure (DirectAccess-1103)

• Amazon Redshift 連接器：SELECT 表格將填入重複欄

  若表格存在於從 Datashare 中建立的資料庫參考的外部結構描述中，則重複的欄將顯示在 DLE/資料管理員預覽中。

新功能和增強事項

• 使用處理序隔離時支援自動連接埠配置

  之前，使用預設連接埠號碼和範圍設定時，無法設定高於 10 的 [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT 值。自此版本開始，將會自動配置連接埠，允許大於 10 的並行載入流程數量。

• 提升使用 SQP SQL (透過 Direct Access gateway) 連接器時的中繼資料分頁

  藉由此項增強功能，擷取 10,000 個或更多表格時，將會以 10,000 為批次擷取表格，以防逾時。

已解決的問題

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

• 使用處理序隔離時不會發佈過期的載入

  使用處理序隔離時，不會為過期的載入發佈連接器流程。

• 就算取消應用程式，Amazon Redshift 工作階段仍繼續執行

  Amazon Redshift 工作階段會繼續執行，直到查詢完成為止，即使已取消執行中的 QCS 應用程式仍是如此。

• 解決安全性弱點

  • 直接存取閘道 連接器會將所有服務繫結至 0.0.0.0，允許來自本機機器上每個 IP 位址的連線，可能會將伺服器暴露於每個可能的網路。
  • 直接存取閘道 會嘗試從使用者暫存檔路徑內非現有、動態產生的目錄載入 MPR.dll。由於預期位置中缺乏 MPR.dll，攻擊者可能會在此路徑中置放惡意 DLL，安裝者之後可能會載入並執行。

• 重新啟動 直接存取閘道 服務後載入卡住

  使用非選取查詢和儲存程序時，載入會在重新啟動 直接存取閘道 服務後停頓數小時。

• 資料預覽和載入問題

  使用 ODBC (透過 直接存取閘道) 連接器存取 Microsoft Fabric 時，有時候會遇到資料預覽和載入問題。

• 新增 ORDER BY 子句時發生錯誤

  新增 ORDER BY 子句會在使用 ODBC (透過 直接存取閘道) 連接器和 SQL Anywhere 17 時造成錯誤。

新功能和增強事項

直接存取閘道 1.6.6 推出下列功能和提升事項：

• 支援透過 直接存取閘道 存取 ServiceNow

  此版本支援 ServiceNow (透過 直接存取閘道) 連接器，允許客戶透過嚴格傳出、加密和互相驗證的連線安全存取有防火牆的 ServiceNow 資料來源。

• 在使用下列 直接存取閘道 連接器時支援新的驗證方法：

  • Azure Synapse Analytics：Azure OAuth 和 Azure Active Directory
  • Azure SQL 資料庫：Azure OAuth 和 Azure Active Directory
  • Snowflake：OAuth
  • Databricks：Azure OAuth
  • MongoDB：SCRAM-SHA-256 和 LDAP

• 增強使用 ODBC 連接器時的中繼資料分頁功能

  藉由此項增強功能，擷取 10,000 個或更多表格時，將會以 10,000 為批次擷取表格，以防逾時。

• .NET 8.x 要求

  從此版本開始，客戶將需要同時安裝 .NET 6 和 .NET 8.x，才能使用 直接存取閘道。安裝或升級期間，若未安裝，設定將會自動安裝。

• 改善支援性

  為了輔助疑難排解，已新增其他記錄，衡量 直接存取閘道 請求的持續時間。

已解決的問題

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

• 若 直接存取閘道 和 Qlik Cloud 之間的連線閒置 30 秒或更長時間，載入操作有時候會失敗，並且有下列錯誤：無效的物件名稱 '#<TempTableName>' (指示 直接存取閘道 臨時表格無法使用)。

  為了補救此情況，新的 ODBC_RELOAD_SESSION_LIFE 參數已新增至 C:\ProgramData\Qlik\Gateway\<GATEWAY-INSTALL-DIR>\configuration.properties 檔案。新的參數會設定 ODBC 連接器的載入工作階段持續時間，並有 20 秒的預設值。

• 取消載入有時候會造成 ODBC 流程建立和終止迴圈。
• 直接存取閘道 和 Qlik Cloud Services 之間的連線有時候會突然結束，原因不明。

• 直接存取閘道 連線重試間隔會持續成長，但不會自行重設。重新啟動 直接存取閘道 服務會是重設重試間隔的唯一方式。

• 使用不正確的語法從 Oracle 呼叫儲存程序時，載入操作會保留數小時，而非立即終止並提供錯誤資訊。

新功能和增強事項

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 檔案中不正確的參數名稱

  對 直接存取閘道 執行新的安裝時，C:\ProgramData\Qlik\Gateway\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 參數 (用於延長載入請求逾時) 已新增至 C:\ProgramData\Qlik\Gateway\configuration.properties 檔案。參數值的測量單位是分鐘。經常遇到這些錯誤的客戶應嘗試將值設定為 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 資料閘道 - 直接存取 服務有時候會意外停止