升級並解除安裝 Qlik 資料閘道 - 直接存取

新功能和增強功能

支援 SAP 報告連接器

從此版本開始，客戶現在可以透過 Qlik 資料閘道 - 直接存取 存取其 SAP 報告連接器。

使用 SAP 報告連接器 （僅提供英文版）

支援 直接存取閘道 搭配 Qlik Cloud Government DoD

此版本新增了對使用 直接存取閘道 搭配 Qlik Cloud Government DoD 的支援。

緩解 DNS 解析所造成的延遲

從這個版本開始，服務對服務通訊將會使用 IPv4 迴路位址 (127.0.0.1) 而非 localhost 執行。這應該能有效消除任何來自 DNS 解析的延遲。

設定連接器啟動參數

您現在可以增加連接器啟動的逾時值和嘗試次數。當執行大量並行重新載入時，這可能很有用。增加這些參數將給予 直接存取閘道 更多時間和額外嘗試，以在因失敗而退出並需要重新啟動之前執行連接器。

配置連接器啟動

非同步請求載入插槽

此版本引入了非同步請求載入插槽的選項。非同步請求載入插槽可緩解在建立重新載入資料 WebSocket 到 Qlik Cloud 期間，到 直接存取閘道 的暫時命令管道擁塞。這在執行大量並行重新載入時可能很有用。

非同步請求載入時段

安裝日誌的新位置

安裝日誌檔案現在將位於<直接存取閘道 installation folder>\data\logs，這與其他直接存取閘道日誌檔案的位置一致。

在舊版中，安裝日誌檔案位於C:\Users\<user>\AppData\Local\Temp。此資料夾中仍存在的任何記錄檔將在升級期間複製到新位置。

已解決的問題

直接存取閘道 1.7.7 解決下列問題：

• 支援在為 ODBC (透過 Direct Access gateway) 連接器定義自訂類型對應時減少欄位大小

  新增支援在為 ODBC (透過 Direct Access gateway) 連接器定義自訂類型對應時，減少驅動程式回報的欄位大小。在舊版中，欄位大小只能增加。

• 命令逾時

  執行時間超過預設 45 秒 pong 逾時的長時間執行命令會導致命令管道中斷連線。此問題已透過防止逾時在 Qlik Cloud Service Connection Broker 將命令轉發至 直接存取閘道 Connector Agent 時觸發來解決。

• 組態 UI - 儲存按鈕已停用

  由於 MAX_PROCESSES_COUNT 值無效，儲存 按鈕將會停用。此問題已透過自動填入有效值至欄位中來解決。

• 組態 UI - 預設值與初始值之間的不一致

  • 並行重新載入程序數欄位的初始值與下列連接器在 UI 中顯示的預設值不同：ODBC、SAP BW、SAP SQL、SAP ODP 和 REST。

  • 檔案連接器的程序隔離模式欄位初始值與 UI 中顯示的預設值不同。

• Microsoft SQL Server NTLM 驗證模式無法運作

  Microsoft SQL Server NTLM 驗證模式在使用 直接存取閘道 1.7.6 時停止運作。

• 高負載下的重新載入失敗

  執行高負載時，重新載入有時候會因下列錯誤而失敗：

  Connector error: The gRPC connection to the connector failed. ... (DirectAccess-1510)

  此問題已透過新增重試機制解決。

• 在某些情況下間歇載入失敗

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

  • DirectAccess-4002：此問題已透過將 AGENT_DATA_PING_SKIP_THRESHOLD_SECONDS 屬性的預設值從 60 秒減少到 15 秒來解決。

  • DirectAccess-2208：此問題已透過新增重試機制來解決。

檔案 (透過 直接存取閘道) 連接器：限制檔案系統存取特定空間

使用檔案 (透過 直接存取閘道) 連接器時，您現在可以限制檔案系統或網路磁碟機存取特定空間。將每個路徑與 Qlik Cloud 租用戶中的空間配對，表示只有具有 可取用資料 角色或更高角色的空間成員才能存取指定路徑。如果未設定任何空間，則所有空間都可存取指定的路徑。

新組態可透過公用 API 進行，或直接在閘道伺服器上的組態檔中進行。

公用 API

檔案 (透過 直接存取閘道) 連接器 （僅提供英文版）

支援套用變更，無需重新啟動閘道

從此版本開始，更新檔案 (透過 直接存取閘道) 和 REST (透過 直接存取閘道) 連接器的允許路徑/URL 時，您不再需要重新啟動 直接存取閘道 服務即可套用變更。當變更下列 ODBC (透過 直接存取閘道) 屬性時，此情況也適用：

• 允許的驅動程式

• 允許的 DSN

• 自訂類型對應

Oracle (透過 直接存取閘道) 連接器：支援 Oracle TNS 名稱連線方法

此版本新增了使用 TNS 名稱存取 Oracle 的支援。

建立 Oracle 連線 （僅提供英文版）

檔案 (透過 直接存取閘道) 連接器：預設啟用處理程序隔離

執行 直接存取閘道 的全新安裝時，處理程序隔離現在將預設啟用，並將 並行重新載入處理程序數 設定為 10。

處理序隔離

允許使用 REST (透過 直接存取閘道) 連接器連線至 localhost

您現在可以允許 REST (透過 直接存取閘道) 連接器連線至 localhost。這有助於使用本機 (閘道伺服器) REST 端點，例如使用 連接器代理程式/ 狀態 端點來判斷代理程式上的作用中載入數。

這也可以使用公共 API 進行配置，當將本地 URL (例如 http://localhost:5050/status) 添加到 restconnector_allowed_urls.txt 檔案時。

允許使用 REST (透過 直接存取閘道) 連接器連線到 localhost

公共 API

支援使用公共 API 非同步執行「載入資料」請求

在代理程式上非同步執行載入資料請求可顯著縮短雲端服務需要等待代理程式回應的時間。

此功能在 直接存取閘道 1.7.5 中引入，現在可透過公共 API 使用 OPTIONAL_CAPABILITIES 參數。

公共 API

高負載情境下的程序隔離增強功能

當閘道器在資源有限的情況下承受高負載時，已進行增強以防止以下問題：

• 啟用程序隔離時的連接器埠衝突

• 過於頻繁地嘗試啟動連接器程序

已解決的問題

直接存取閘道 1.7.6 解決下列問題：

• Oracle (透過 直接存取閘道) 或 ODBC (透過 直接存取閘道) 連接器：重複的中繼資料呼叫

  當使用 Oracle (透過 直接存取閘道) 或 ODBC (透過 直接存取閘道) 連接器時，如果未選取閘道，部分連接器屬性會進行重複的中繼資料呼叫。

• 因閘道度量擷取時間過長導致效能降低

  對於每個重新載入要求，都會擷取閘道度量。擷取度量所需的時間 (約 200 毫秒) 會影響重新載入持續時間。此問題已透過每 15 秒擷取度量一次，而非每個載入要求都擷取來解決。

• AWS Athena (透過 直接存取閘道) 連接器：嘗試重新載入包含日文字元的資料表或欄位名稱時重新載入失敗

  當使用 AWS Athena (透過 直接存取閘道) 連接器時，嘗試重新載入包含日文字元的資料表或欄位名稱會導致下列錯誤：

  Unable to show the preview column data. User does not have permission to access data, or column data type is not supported.

• Google BigQuery (透過 直接存取閘道) 連接器：使用資料管理員新增資料失敗

  當使用 Google BigQuery (透過 直接存取閘道) 連接器時，嘗試使用資料管理員新增資料時會發生「新增資料失敗」錯誤。

• 在 LocalSystem 帳戶下安裝 直接存取閘道 時的密碼澄清

  直接存取閘道 安裝程式中的 密碼 欄位讓一些客戶誤以為在 LocalSystem 使用者帳戶下安裝 直接存取閘道 時總是需要密碼。為了解決此問題，已將下列澄清文字新增至安裝程式中：

  A password is only required if you are not using the default local system account.

已將記錄內容新增至中繼資料預覽呼叫

為了協助解決載入失敗的問題，在中繼資料預覽呼叫的記錄中新增了以下欄位：requestguid、sessionid 和 datasourceid。

為 MongoDB (透過 直接存取閘道) 和 Google BigQuery (透過 直接存取閘道) 連接器新增了對「使用者定義認證」的支援

使用者定義的認證欄位已新增至 MongoDB (透過 直接存取閘道) 和 Google BigQuery (透過 直接存取閘道) 連接器，藉此讓這些內容與對應的非 直接存取閘道 連接器保持一致。

若選取了使用者定義的認證，任何想要存取連線的使用者都需要在選取表格或載入資料之前輸入自己的認證。這些認證屬於一個使用者，而非一個連線。可在相同連接器類型的多個連線儲存並使用使用者定義的認證。

支援含有載入資料請求的 AsyncCommand

在代理程式上非同步執行載入資料請求可顯著縮短雲端服務等待代理程式回應的時間。

非同步執行載入資料請求

支援變更 AGENT_LOG_OPTIONS 屬性，而無需重新啟動 直接存取閘道 服務

現在可以修改 AGENT_LOG_OPTIONS 屬性，而無需重新啟動 直接存取閘道 服務。只有在 Qlik 支援提出請求時才應修改此屬性。

已解決的問題

直接存取閘道 1.7.5 解決了以下問題：

• 有效操作傳回的錯誤

  連接器代理程式有時候會對有效載入和事件呼叫傳回「500」錯誤。

• 設定 API：

  • 已更新 REST 和 FILE 連接器的「最大流程計數」屬性，涵蓋 2-100 之間的值

  • 已將預設值新增至 AGENT_LOG_OPTIONS 屬性

  • DCaaS 記錄層級值已更新

• 保持運作中事件：

  • 有時候不會加密保持運作中事件

  • 若代理程式上的工作階段不再處於作用中狀態，就會對釋出雲端資源傳送不正確的回應

支援在安裝過程中覆寫預設 Windows 服務帳戶

在先前的 直接存取閘道 版本中，只能在安裝後變更 Windows 服務帳戶，並且只能以互動方式 (在每個 直接存取閘道 機器上) 變更。直接存取閘道 1.7.4 採用了在非預設 Windows 服務帳戶下安裝 直接存取閘道 的功能。使用安裝精靈以及執行無訊息安裝時，可以使用此選項。

如需更多資訊，請參閱階段二：在保護資料來源之防火牆後方的伺服器上安裝 直接存取閘道

支援 Windows Server 2025

直接存取閘道 版本 1.7.0 及更高版本經過認證，可在 Windows Server 2025 上安裝。

已解決的問題

直接存取閘道 1.7.4 解決了以下問題：

• 安全性強化

  使用檔案 (透過 直接存取閘道) 連接器時，所有檔案操作都會在「NT AUTHORITY\SYSTEM」Windows 服務帳戶之下執行。在安裝過程中新增了覆寫預設 Windows 服務帳戶的功能，藉此解決了此問題。

• Google BigQuery (透過 直接存取閘道) 連接器：處理特定範圍之外的時間戳記資料時發生錯誤

  處理 1400-9999 (年) 範圍之外的時間戳記資料時，會出現以下錯誤：

  The data contains unsupported data type or row content. Invalid row status.

• 升級後沒有維護自訂 Windows 服務帳戶

  升級後，指定的 直接存取閘道 服務帳戶將改回預設本機帳戶 (LocalSystem)。

• 載入錯誤

  在載入期間，由於與 keepAlive 事件 (從 Qlik Cloud 傳送至閘道) 加密相關的問題，有時會出現以下錯誤：

  Internal error. (Connector error: Reload web socket was aborted due to a failure (DirectAccess-1103))

疑難排解改善事項

• 直接存取閘道 機器指標 (核心、磁碟空間、記憶體、CPU 等) 現在將傳播到遠端記錄以協助進行疑難排解。
• 現在，所有記錄 (SAP 連接器的記錄除外) 的記錄訊息時間戳記都將採用 UTC 格式。
• 檔案 (透過 直接存取閘道) 連接器記錄名稱現在包含連接埠號碼 (而不是流程 ID)。
• 檔案 (透過 直接存取閘道) 連接器記錄訊息現在包含流程 ID 欄。

ODBC (透過 直接存取閘道) 連接器增強

使用 ODBC (透過 直接存取閘道) 連接器時，ANSI ODBC 驅動程式 (不受支援) 現在將從連接器中顯示的 ODBC 驅動程式清單中排除。

已解決的問題

直接存取閘道 1.7.3 解決了以下問題：

• REST (透過 直接存取閘道) 連接器：載入失敗

  載入大型資料結構有時候會因下列錯誤而失敗：

  Received message exceeds the maximum configured message size.

• REST (透過 直接存取閘道) 連接器：過度限制 URL 允許清單

  將會不正確地封鎖沒有後置斜線的 URL，而會允許具有後置斜線的相同 URL。

• ODBC (透過 直接存取閘道) 連接器：記憶體消耗過多

  在載入指令碼中使用多項選取時，將不會釋出來源系統上的 VRAM 記憶體，並且會隨著每次載入而不斷增長。

• MySQL (透過 直接存取閘道) 連接器：資料類型問題

  使用 MySQL (透過 直接存取閘道) 連接器載入具有「int(9) unsigned」資料類型的表格時，該欄的資料將傳回為 -1。

• SAP SQL (透過 直接存取閘道) 連接器：混合模式無法運作

  MixedMode 連線字串屬性無法如期運作。

• SQL 類型資料來源：載入指令碼問題

  連線到 SQL 類型資料來源時，載入指令碼中的「TableName」會錯誤地置於資料表定義的中間，而不是置於載入指令碼的開頭。

• Databricks (透過 直接存取閘道) 連接器：安全性強化

  透過 Databricks (透過 直接存取閘道) 連接器載入的資料現在將一律使用 SSL 進行通訊和傳輸資料。已移除先前啟用或停用 SSL 的選項。

• 安全性強化

  對於從 Qlik Cloud 管理活動中心傳回客戶託管記錄的記錄命令裝載，不會相互強制執行端對端加密。

設定區塊復原恢復閾值

現在您可以為區塊復原持續時間設定閾值 (以分鐘為單位)。如果在達到復原持續時間閾值時尚未恢復載入，則會失敗並顯示適當的訊息。

此選項對於長時間復原後可能超過三小時限制的載入很實用。例如，假設從資料庫擷取資料需要 90 分鐘，但是一旦開始載入，其中一個區塊就會損毀。在這種情況下，所有區塊都將儲存在快取中，並從快取傳送。在這種情況下，整個載入流程 (儲存在快取中 + 實際載入) 可能需要三個小時才能完成。

另請參閱設定區塊復原持續時間閾值。

已解決的問題

直接存取閘道 1.7.2 解決了下列問題：

• 遺失 REST (透過 直接存取閘道) 連接器的設定

  直接存取閘道 1.7.1 中的 configuration.properties 檔案中遺失了 REST_MAX_PROCESS_COUNT 參數

• 直接存取閘道 流程的自動重啟未如預期運作

  直接存取閘道 流程損毀或以其他方式終止時，有時候不會自動重新啟動。

• 在錯誤位置建立了區塊復原快取資料夾

  若 configuration.properties 檔案中的 OVERRIDE_CHUNKS_CACHE_DIR 設定是空的，則會在 [安裝資料夾]\ConnectorAgent 資料夾而不是 C:\ProgramData\Qlik\Gateway\tmp (預設資料夾) 中建立區塊復原快取資料夾。

• 區塊復原模式下載入失敗

  在區塊復原模式下運作時，載入偶爾會失敗並出現 DirectAccess-4021 錯誤。該問題是由於 EODAck 在 EODAck 逾時後不久抵達代理程式所引起。稍微增加 EODAck 逾時時間後，此問題已解決。

• 檔案 (透過 直接存取閘道) 連接器記錄層級問題

  會忽略檔案 (透過 直接存取閘道) 連接器的 DEBUG 記錄層級。

• 從未清除 [直接存取閘道 安裝資料夾]\data\logs\reloads 資料夾的內容

  從未清除 [直接存取閘道 安裝資料夾]\data\logs\reloads 資料夾中的舊 JSON 檔案。大量記錄的累積可能會隨著時間的推移取用大量的磁碟空間。此外，備份此資料夾 (可能包含數千個記錄檔案) 也將帶來挑戰。

• 安全性強化

  此項改善為 Qlik Cloud 和 直接存取閘道 之間傳送的事件和訊息 (其中包含 Pod IP 和閘道 ID 等敏感資料) 新增了額外的加密層。

新功能和增強事項

• REST 連接器

  新的REST (透過 Direct Access gateway) 連接器透過 直接存取閘道 提供安全的私人 REST API 端點存取權限，可讓您將資料直接串流到 Qlik Sense 應用程式中。

  如需更多資訊，請參閱 REST 資料來源 （僅提供英文版）。

  資訊備註

  REST (透過 Direct Access gateway) 連接器將分四個階段推廣到 Qlik Cloud 區域，其中第四階段計畫於 2 月 17 日完成。

  • 階段 1：SE (瑞典)、JP (日本) 和 UK (英國)
  • 階段 2：DE (德國)、SG (新加坡)、AP (亞太地區) 和 IN (印度)

  • 階段 3：US (美國) 和 Qlik Cloud 政府

  • 階段 4：EU (歐盟)
    

• 覆寫預設的區塊快取目錄

  對於每個載入操作，直接存取閘道 可以在記憶體中快取資料區塊，並卸載到磁碟 (若超出快取的分配大小)。如果系統磁碟機上沒有足夠的磁碟空間，您可以覆寫預設的區塊快取目錄 (C:\ProgramData\Qlik\Gateway\tmp) 目錄。

  如需更多資訊，請參閱覆寫預設的區塊快取目錄。

• 覆寫使用 ODBC (透過 直接存取閘道) 連接器時擷取的預設表格數量

  預設情況下，會擷取 10,000 個表格以供選取，但在處理非常大的資料庫時這可能不夠。此版本增加 直接存取閘道 configuration.properties 檔案中 ODBC_TABLES_LIMIT_FOR_GENERICODBC 屬性，藉此採用了覆寫預設內容的功能。

  如需詳細資訊，請參閱要卸載的表格數上限。

• Google BigQuery (via 直接存取閘道) Connector 的多目錄支援

  Google BigQuery (via 直接存取閘道) Connector 現在支援在單一連線中存取多個目錄 (相當於 Google BigQuery 專案)。

  如需更多資訊，請參閱建立 Google BigQuery 連線 （僅提供英文版）。

• 透過 Databricks (via 直接存取閘道) Connector 支援 Unity 目錄

  Databricks (via 直接存取閘道) Connector 現在支援存取 Databricks 上 Unity 目錄中的資料。

  如需更多資訊，請參閱建立 Databricks 連線 （僅提供英文版）。

• 緩解使用 ODBC (透過 直接存取閘道) 連接器時 ODBC 驅動程式引起的資料錯誤

  有時候，由於廠商 ODBC 驅動程式處理來源資料類型時存在問題，載入期間會出現錯誤，或者會將不正確的資料載入到 Qlik Cloud。在這種情況下，您可以覆寫 Qlik Cloud 資料類型或其規格 (例如比例或精確度)。

  如需更多資訊，請參閱使用 ODBC (透過 直接存取閘道) 連接器時覆蓋預設的 Qlik Cloud 資料類型。

• 重新定位連接器啟動、退出和重新啟動事件記錄事件

  從 直接存取閘道 1.7.1 起，連接器啟動、退出和重新啟動事件將寫入 直接存取閘道(DirectAccessAgent) 記錄檔案。在先前的版本中，這寫入到連接器代理程式記錄 (connector-agent_logs_ < date>) 記錄檔案。

已解決的問題

直接存取閘道 1.7.1 解決了以下問題：

• 在某些情況下，啟用 RELOAD_CACHE_MEMORY_MB 選項 (在出現問題時快取資料以便載入) 時會影響載入效能。

• 若啟用 RELOAD_CACHE_MEMORY_MB 選項，載入有時候會失敗，並出現以下錯誤，表示存取遭拒或找不到檔案：

  (Connector error: data loading error (DirectAccess-4008) (DirectAccess-4001))

• 在某些情況下，主要是如果無法使用連接器所需的連接埠，則即使啟用了流程隔離，連接器仍會繼續毀損。

• 即使載入已成功完成，直接存取閘道 有時候仍會嘗試重新連線至資料來源。

• 連接器代理程式嘗試從磁碟讀取已載入到記憶體的區塊時，有時候會遇到「Could not find file」錯誤。

• 使用 SAP BW 連接器時，會出現以下錯誤：

  Error when parsing '0TCT_C03': The given key 'CHABASNM' was not present in the dictionary.

  對於沒有 CHABASNM 中繼資料欄位的舊版傳輸新增了支援，藉此修正了問題。

• 當 configuration.properties 檔案包含重複項目時，會無法啟動 直接存取閘道 服務。

• 嘗試使用 Azure Active Directory 驗證方法連線至 Azure SQL 資料庫 (透過 Direct_Access gateway) 資料來源時，測試連線操作會失敗，並出現以下錯誤：

  Communication link failure - ERROR [08S01] [Qlik][SqlServer] Connection broken unexpectedly

• 在某些情況下，當 直接存取閘道 與 Qlik Cloud 中斷連線時，最多可能需要 10 分鐘才能重新連線。在此期間，不會開始任何載入。此時間已縮短至 45 秒。

  如果您注意到 直接存取閘道 重新連線所花費的時間明顯超過 45 秒，您可以強制其重新連線，如強制 直接存取閘道 重新連線至 Qlik Cloud 中所述。

新功能和增強事項

• 檔案連接器

  新的檔案 (透過 Direct Access gateway) 連接器透過 直接存取閘道 提供安全的檔案系統存取權限，可讓您將資料直接串流到 Qlik Sense 應用程式中。

  如需更多資訊，請參閱檔案 (透過 Direct Access gateway) （僅提供英文版）。

• 透過非同步命令支援提高效能

  非同步命令支援讓 直接存取閘道 能夠同時處理多個命令 (而不是一次處理一個命令)，藉此提高效率。

   

已解決的問題

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

• Snowflake 連接器

  載入含有特殊字元的資料將會失敗，並出現「SQL 編譯錯誤」。

• 無訊息安裝

  無訊息安裝 直接存取閘道 將啟動互動式提示，以修復必備軟體。

• Oracle (透過 Direct Access gateway) 連接器效能

  使用 Oracle (透過 Direct Access gateway) 連接器載入資料會比直接使用 ODBC 驅動程式慢得多。

• ODBC (透過 Direct Access gateway) 連接器毀損

  由於 SQL Server Simba 驅動程式錯誤，ODBC (透過 Direct Access gateway) 連接器有時候會毀損。

• 間歇載入失敗

  多個應用程式的載入會間歇失敗，並出現以下錯誤 (摘錄)：

  Connector Datagateway Space:SQLCLUSTER01 not found (Requested endpoint could not be provisioned due to failure to acquire a load slot: The response body of the connector load info request was empty.

新功能和增強事項

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

  在先前的版本中，處理序隔離模式預設為關閉。從 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 的同時載入流程數量上限。自此版本開始，將會自動配置連接埠，允許大於 10 的並行載入流程數量。

• 提升使用 SAP 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 連接器的載入工作階段持續時間，並有 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)

  為了緩解此問題，在 直接存取閘道 設定中新增了載入請求逾時參數 (用於延長載入請求逾時時間)。

  經常遇到這些錯誤的客戶應嘗試將值設定為 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 資料閘道 - 直接存取 服務有時候會意外停止