# 對 Qlik 資料閘道 - 直接存取 進行設定和疑難排解

本主題說明設定 直接存取閘道 和解決其問題可執行的各種動作。

資訊備註本主題中所述的所有設定選項也可以透過 直接存取閘道 公用 API 執行。有關詳細資訊，請參閱 https://qlik.dev/apis/rest/direct-access-agents/

## 從您的 Qlik Cloud 租用戶設定 直接存取閘道

雖然 直接存取閘道 預設設定適用於大部分的環境，但您可能需要覆寫預設值，以改善效能、解決問題 (透過記錄設定) 或克服各種連線問題。

資訊備註

* 從 1.7.2 或更高版本開始支援從 Qlik Cloud 設定 直接存取閘道，但建議升級到最新版本，以受益於整組設定選項。

* 雖然大部分的 直接存取閘道 設定可以在 Qlik Cloud管理 活動中心進行設定，但某些設定只能透過[直接在 直接存取閘道 機器上](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Configur2)編輯設定檔，才能變更

為了能夠編輯 Qlik Cloud 中的設定，需要以下任一權限：

* 租用戶管理員和閘道空間擁有者

* 閘道空間中具有可以取用資料的租用戶成員

若要開啟閘道設定：

1. 在您的 Qlik Cloud 租用戶中，前往 管理 > 資料閘道並找到您的 直接存取閘道。

2. 按一下列末尾的 the 閘道設定 icon，並選取。

   <名稱> 的閘道設定對話方塊會開啟。

   設定分為一般設定 (如下) 和[連接器設定](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Connecto)。請注意，變更設定可能也需要您[重新啟動 直接存取閘道 服務](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Restarti)。

### 一般設定

無論您使用哪種連接器，這些設定都與 直接存取閘道 的一般功能相關。

#### 代理程式 ID

要搭配 直接存取閘道 公用 API 使用的代理程式 ID。

#### 連接器代理程式連接埠

連線至連接器代理程式時使用的連接埠。無法變更此設定。

#### 連接器代理程式健康失敗閾值

會對 直接存取閘道 元件執行定期健康檢查。健康檢查有時候一開始會失敗，之後才會成功。如果在達到指定的閾值後健康檢查仍持續失敗，直接存取閘道 服務將會重新啟動。您只能在 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)要求時變更此設定。

#### 載入請求逾時

發生網路中斷時，載入可能會失敗並有下列錯誤：

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

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

若您經常遇到上述錯誤，嘗試將逾時延長為 5-10 分鐘。

#### 連接器代理程式記錄層級

為了進行疑難排解，您可能需要變更連接器代理程式元件的記錄層級。 您只能在 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)要求時變更此設定。

#### 連接器代理程式記錄選項

若要針對特定連接器代理程式元件的問題進行疑難排解，您可能需要選取其對應的記錄檔。您只能在 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)要求時變更此設定。

#### 將連接器代理程式記錄檔大小限制為

設定連接器代理程式記錄檔在輪替至新檔案前的大小上限 (以 MB 為單位)。

#### 將連接器代理程式檔案的保留時間限制為

設定連接器代理程式記錄檔在自動刪除前保留的天數。

#### 快取資料區塊的記憶體

對於每個載入操作，直接存取閘道 可以在記憶體中快取資料區塊，並卸載到磁碟 (若超出快取的分配大小)。若您不使用自動復原，且頻繁遇到 4025、4020 和 4021 錯誤，這尤其實用。達到指定的閾值時，閘道會將下一個加密區塊卸載到 直接存取閘道 機器的磁碟。值為 0（預設值）會停用 Chunks Recovery。

#### 區塊復原持續時間閾值

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

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

#### 覆寫預設的快取目錄

設定新的快取目錄。

#### DCaaS 連接埠

連線至 DCaaS 時使用的連接埠。無法變更此設定。

#### DCaaS 記錄層級

為了進行疑難排解，您可能需要變更 DCaaS 記錄檔的記錄層級。您只能在 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)要求時變更此設定。

#### 將 DCaaS 記錄檔的保留天數限制為 (天)

您可以限制 Qlik 資料閘道 - 直接存取 保留元件記錄檔 (連接器、DCaaS、代理程式等) 的天數。超過指定天數的記錄檔會自動刪除。

#### 資料連接埠範圍起始

設定處理程序隔離的資料連接埠範圍起點。

#### 載入效能指標

這些組態屬性與負載效能結果相關。這些屬性控制要在閘道主機上保留多少資料，以及如何隨時間清理這些資料。

資訊備註支援版本 直接存取閘道 1.7.17。

* 啟用載入效能指標記錄：選擇是否保留載入效能指標。

* 啟用基準保留清理：選擇是否要自動清理基準記錄。

* 基準保留：設定在清除前要保留基準記錄的天數。

* 基準保留檢查間隔：設定檢查可清理之基準記錄的間隔時間。

* 基準保留資料庫大小：為基準記錄設定目標資料庫大小 (以 MB 為單位)。

* 基準保留清理批次大小：設定每個清理批次要刪除的基準記錄數量。

### 連接器設定

若要變更連接器設定，請選取左側的連接器類型，然後根據需要變更下方設定。

#### 連接埠

連線至資料來源時使用的連接埠。無法變更此設定。

#### 記錄層級

為了進行疑難排解，您可能需要變更連接器記錄的記錄層級。您只能在 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)要求時變更此設定。

#### 處理序隔離

資訊備註

需要 直接存取閘道 1.6.1 或更高版本。

處理序隔離允許可存取 直接存取閘道 伺服器作業系統的管理員控制每個連接器類型有多少處理程序可用於重新載入和/或中繼資料命令。在多個連接器處理程序上擴展重新載入和/或中繼資料命令會增加隔離程度，方法是減少每個連接器處理程序上同時執行的重新載入/或中繼資料命令數量。若發生連接器毀損，這反過來可以改善整體 直接存取閘道 穩定性。

透過清理安裝，依照預設會啟用處理序會隔離。每種連接器類型的並行重新載入/或中繼資料命令預設數量為 9。您可以依照下方並行重新載入/命令處理序數量中所述覆寫預設值。

下列選項可用：

* 已停用： Qlik 支援可能會要求您停用處理程序隔離，以進行疑難排解。

* 中繼資料： 僅針對中繼資料命令啟用處理程序隔離。例如，對於擁有不支援多執行緒、但想要同時執行中繼資料命令 (主要用於預覽目的) 的 ODBC 驅動程式的客戶，這會很實用。

  資訊備註從 直接存取閘道 1.7.9 開始支援。

* 重新載入 (預設)：僅針對重新載入命令啟用處理程序隔離。

* 全部：為 reload 與 metadata 命令啟用處理序隔離。

  資訊備註從 直接存取閘道 1.7.9 開始支援。

#### 同時重新載入/命令程序數量

為連接器分配的同時重新載入/命令程序數量，包括命令程序。因此，例如，值 30 表示最多 29 個並行載入/命令。請注意，此設定僅在啟用處理序隔離時才相關。

資訊備註從 直接存取閘道 版本1.6.7 開始，此值可以超過 10，無需變更其他設定。若要完全隔離特定連接器類型的載入 (即每個連接器流程不超過一次載入)，此值應至少設為 30，但您可能需要將其設為高達 60，視工作負載而定。

#### 載入工作階段壽命

資訊備註僅對 ODBC (透過 直接存取閘道) 連接器相關。

若 直接存取閘道 和 Qlik Cloud 之間的連線閒置 20 秒或更長時間，載入操作有時候可能會失敗，並有下列錯誤：

Invalid object name '#<TempTableName>' (indicating that the 直接存取閘道 temp tables are unavailable).

預設工作階段壽命為 20 秒，但若您經常遇到此錯誤，可以根據需要延長工作階段壽命。

#### 要卸載的表格數量上限

資訊備註

* 僅對 ODBC (透過 直接存取閘道) 連接器相關。

* 需要 直接存取閘道 1.7.1 或更高版本。

依照預設，最多可從資料庫卸擷取10,000 個表格。如果資料庫有超過 10,000 個表格，您可以覆寫預設值。

#### 顯示詳細錯誤訊息

資訊備註

* 僅與以 ODBC 為基礎的連接器相關。

* UI 中的可見性需要 直接存取閘道 1.7.11 或更新版本。

出於安全考慮，ODBC 驅動程式傳回的預設錯誤訊息包含最少的資訊。但是，在某些情況下，您可能需要更多資訊來解決特定問題。若要產生更詳細的錯誤訊息，請啟用此選項。解決問題後，為了獲得最佳安全性，強烈建議停用此選項。

#### 限制 直接存取閘道 使用 REST 連接器可存取的 URL

您可以限制使用 REST 連接器可存取的特定 URL 或 URL 路徑。

資訊備註您所做的任何變更 (新增、編輯或刪除 URL) 只會在重新啟動 直接存取閘道 服務後生效。

若要限制存取特定 URL，請在 允許的 URL 欄位中輸入 URL，然後按一下 新增。若要限制存取 URL 路徑，請執行相同的動作，但將星號 (\*) 附加至 URL。視需要重複。

範例

在以下範例中，允許的 URL 清單包含兩個項目：

* 第一個項目僅允許存取`https://mypublicrestservice.com/restricted/source`。

* 第二個項目允許存取`https://mypublicrestservice.com/open`以及其下的任何路徑，例如`https://mypublicrestservice.com/open/shared`

| 允許的 URL |
| --- |
| `https://mypublicrestservice.com/restricted/source` |
| `https://mypublicrestservice.com/open`\* |

編輯或刪除 URL

若要編輯 URL，請按一下列末尾的 the Edit Outline icon 按鈕，並視需要編輯 URL。然後按一下 the Tick icon 以儲存您的變更，或按一下 the Cross icon 以取消。

若要刪除 URL，請按一下列末尾的 the Bin Outline icon 按鈕。

另請參閱：[建立 REST 連線](https://help.qlik.com/en-US/cloud-services/Subsystems/REST_Connector_help/Content/Connectors_REST/Create-REST-connection/Create-REST-connection.htm) （僅提供英文版）。

#### 限制 直接存取閘道 可使用檔案連接器存取的路徑清單

您可以限制透過檔案連接器存取的路徑。您也可以將路徑與一個或多個空間配對，以進一步限制對指定路徑的存取。

資訊備註

* 配對的空間從 直接存取閘道 1.7.6 版開始支援。

* 當使用 直接存取閘道 1.7.4 或 1.7.5 版時，您所做的任何變更 (新增、編輯或刪除路徑或空間) 只有在重新啟動 直接存取閘道 服務後才會生效。

* 只有具有 可取用資料 角色或更高角色 (可編輯、可編輯應用程式中的資料、可管理) 的使用者才能存取這些路徑。

* 所有 Windows 檔案系統和網路磁碟機都受支援，包括標準 DOS 路徑和 UNC 路徑。

若要限制對特定路徑的存取，請在檔案路徑欄位中輸入路徑，然後按一下新增。視需要重複。

若要將空間與路徑配對，請在新增路徑後，按一下該列末端的the Edit Outline icon按鈕，然後從配對空間欄位中的下拉式清單選取一個或多個空間。如果路徑與空間配對，則只有屬於至少一個空間的使用者才能存取指定的路徑。請注意，指定空間的成員將能夠從他們所屬的任何空間 (即使未明確定義) 存取路徑，包括他們的個人空間。

範例

在以下範例中，檔案路徑清單包含兩個項目：

* 第一個項目允許任何具有所需角色的使用者存取 `C:\mypath\source.`

* 第二個項目僅允許 mosheSharedSpace 空間的成員存取 `C:\restricted`。

| 來源檔案路徑 | 配對空間 |
| --- | --- |
| C:\mypath\source | 沒有選取任何空間 |
| C:\restricted | mosheSharedSpace |

編輯或刪除項目

若要編輯項目，請按一下列末尾的 the Edit Outline icon 按鈕，並依需求編輯項目。然後按一下 the Tick icon 以儲存您的變更，或按一下 the Cross icon 以還原您的變更。

若要刪除項目，請按一下列末尾的 the Bin Outline icon 按鈕。

另請參閱：[檔案 (透過 直接存取閘道)](https://help.qlik.com/en-US/cloud-services/Subsystems/Web_Storage_Provider_Connectors_help/Content/Connectors_StorageProvider/Storage%20provider%20connectors/File-DG-storage-provider-connector.htm) （僅提供英文版）。

### 停用每個連線的區塊復原

資訊備註需要 直接存取閘道 1.7.16 或更新版本。

直接存取閘道 會在重新載入作業期間自動修復損毀的區塊（加密資料區段）。這有助於在網路中斷或資料來源問題導致區塊遺失時，仍能成功重新載入。

依預設，所有連線皆已啟用區塊復原。然而，如果您希望優先考量重新載入速度而非復原能力，或者您的工作負載不需要復原，您可以針對個別連線停用此功能，特性。

若要停用特定連線的區塊復原：

1. 在 Qlik Cloud 租用戶中，開啟相關連接器。
2. 尋找進階區段。
3. 將 disableDataChunksRecovery (名稱) 設定為 true (值)
4. 儲存變更。

您也可以透過 直接存取閘道 公開 API 停用區塊復原。如需 API 詳細資訊，請參閱 [Direct Access Gateway REST API](https://qlik.dev/apis/rest/direct-access-agents/#put-api-v1-direct-access-agents-agentId-connectors-connectorType-files-fileType)。

資訊備註個別連線設定優先於全域 區塊復原持續時間閾值 設定（於一般閘道設定中設定）。這可針對個別連線進行細部控制。

### 在 1.7.16 中監控重新載入效能

資訊備註需要 直接存取閘道 1.7.16 或更新版本。

直接存取閘道 1.7.16 包含針對重新載入串流輸送量的自動效能增強。這些最佳化預設為啟用，不需要進行任何設定。

包括以下改善項目：

* 執行緒集區最佳化：強化的執行緒集區管理可在高並行重新載入期間降低額外負荷，並提升資源使用率。

* WebSocket 通訊協定增強功能：改善 直接存取閘道 與 Qlik Cloud 之間的 WebSocket 處理可降低延遲並提高輸送量。

* 自適應步調：動態步調演算法會根據網路狀況和佇列深度調整資料傳輸速率，以防止壅塞與逾時。

若要驗證效能改善，請在您的環境中監控重新載入時間與記錄。相較於先前的版本，您應該會觀察到更快的重新載入完成時間。如果您遇到非預期的行為或效能降低，請聯絡 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)。

### 其他 ODBC (透過 直接存取閘道) 連接器設定

當使用 ODBC (透過 直接存取閘道) 連接器時，您可以限制特定 DSN 和驅動程式的使用，並覆寫預設資料類型對應。

資訊備註

* 僅對 ODBC (透過 直接存取閘道) 連接器相關。

* UI 中的可見性需要 直接存取閘道 1.7.11 或更新版本。

#### 僅允許特定 DSN

基於安全性或管理原因，您可能希望限制某些 DSN 的使用。

若要執行此動作

1. 從連接器清單中選取 ODBC 並向下捲動至 DSNs 區段。

2. 開啟僅限您要允許的 DSN。

   在 ODBC (透過 直接存取閘道) 連接器對話方塊中，當選取 系統 DSN 時，僅限允許的 DSN 會顯示在 ODBC 來源下拉式清單中。

3. 重新啟動 Qlik 資料閘道 - 直接存取 服務。

#### 僅允許特定驅動程式

基於安全性或管理原因，您可能想要限制某些驅動程式的使用。

若要執行此動作

1. 從連接器清單中選取ODBC ，並向下捲動至驅動程式 區段。

2. 只開啟您要允許的驅動程式。

3. 重新啟動 Qlik 資料閘道 - 直接存取 服務。

   在 ODBC (透過 直接存取閘道) 連接器對話方塊中，當選取 ODBC 驅動程式 時，只有允許的驅動程式會顯示在 ODBC 來源 下拉式清單中。

#### 覆寫預設的 Qlik Cloud 資料類型對應

有時候，由於廠商 ODBC 驅動程式處理來源資料類型時存在問題，載入期間會出現錯誤，或者會將不正確的資料載入到 Qlik Cloud。在這種情況下，您可以覆寫來源資料類型與 Qlik Cloud 資料類型之間的預設對應。

若要執行此動作

1. 從連接器清單中選取ODBC ，並向下捲動至驅動程式 區段。

2. 找到您的驅動程式，並按一下資料列結尾的![](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/arrow_down.svg)以展開該區段。

3. 按一下新增資料類型對應。

   將顯示下列欄 (屬性)：

   * 來源資料類型： 來源資料類型。

   * Qlik Cloud 資料類型： 來源資料類型將對應到的 Qlik Cloud 資料類型。

   * 大小： Qlik Cloud 上對應資料類型的大小 (精確度)。

   * IsBit：對應的資料類型是否為 bit (儲存 1 或 0 的值)。

4. 設定每個屬性並儲存您的設定。

   對應將會儲存，如下列範例所示：

   | 來源資料類型 | Qlik Cloud 資料類型 | 大小 | IsBit |
   | --- | --- | --- | --- |
   | 具有時區的時間戳記 | 日期時間 | 27 | false |

5. 重新啟動 Qlik 資料閘道 - 直接存取 服務。

6. 重新載入資料。

警告備註雖然可以簡單地將 QlikDataType 變更為 String，以此解決許多問題，但如果無法這麼做，我們建議聯絡 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)以獲得來源資料類型可以對應到的 Qlik Cloud 資料類型相關指導。

編輯和刪除對應

編輯對應

* 按一下列結尾的 ![](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/edit.svg)，並視需要編輯欄位。

刪除對應

* 按一下列末尾的 ![](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/delete.svg)。

### 變更設定後重新啟動 直接存取閘道

某些設定只有在 直接存取閘道 服務重新啟動後才會套用。在這種情況下，當您儲存設定時，系統會提示您重新啟動服務。如果有作用中的載入，則在完成之前，您將無法重新啟動服務。若沒有作用中的載入，您可以隨時以下列方式重新啟動服務：

1. 在您的 Qlik Cloud 租用戶中，前往 管理 > 資料閘道並找到您的 直接存取閘道。

2. 按一下列末尾的 the 重新啟動服務 icon，並選取。

您也可以直接在 直接存取閘道 機器上重新啟動服務，如 [開始、停止或重新啟動服務](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Starting) 中所述

## 直接在 直接存取閘道 機器上設定 直接存取閘道

雖然大部分的 直接存取閘道 設定可以在 [Qlik Cloud 進行設定](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Configur)，但某些設定只能透過直接在 直接存取閘道 機器上編輯設定檔，才能變更。

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

資訊備註需要 直接存取閘道 1.7.1 或更高版本。

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

資訊備註為了確保穩定性和最佳化效能，最佳做法是僅使用本機路徑。

要執行的操作：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 找到 OVERRIDE\_CHUNKS\_CACHE\_DIR 屬性並將其設定為您選擇的目錄。

   範例：

   OVERRIDE\_CHUNKS\_CACHE\_DIR=C:\tmp

   資訊備註請勿將路徑括在引號中。

3. 儲存 configuration.properties 檔案。

4. 視安裝工作流程而定，執行下列其中一個動作：

   * Windows 伺服器安裝：

     按 Qlik 資料閘道 - 直接存取 中的說明重新啟動 [對 Qlik 資料閘道 - 直接存取 進行設定和疑難排解](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Managing) 服務。

   * 容器化安裝：

     重新啟動 direct-access-agent 容器。

另請參閱： [快取資料區塊的記憶體](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Memory)

### 強制 直接存取閘道 重新連線到 Qlik Cloud

預設情況下，如果 直接存取閘道 與 Qlik Cloud 中斷連線，則應在 45 秒後重新連線。如果您發現花費的時間明顯更長，您可以強制閘道盡快重新連線。

要執行的操作：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。此檔案包含 Qlik Cloud 資料類型的來源範例。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 在檔案開頭的 AGENT\_PONG\_TIMEOUT\_SECONDS=<time-in-seconds> 區段新增 # Connector Agent。

   範例：

   AGENT\_PONG\_TIMEOUT\_SECONDS=30

   資訊備註最短時間為 30 秒。

3. 儲存 configuration.properties 檔案。

4. 視安裝工作流程而定，執行下列其中一個動作：

   * Windows 伺服器安裝：

     按 Qlik 資料閘道 - 直接存取 中的說明重新啟動 [對 Qlik 資料閘道 - 直接存取 進行設定和疑難排解](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Managing) 服務。

   * 容器化安裝：

     重新啟動 direct-access-agent 容器。

### 非同步執行載入資料請求

資訊備註

需要 直接存取閘道 1.7.5 或更高版本。

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

若要啟用非同步載入資料請求：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 如果檔案中尚不存在，請新增以下行：

   OPTIONAL\_CAPABILITIES=AsyncLoadDataRequest

   如果 OPTIONAL\_CAPABILITIES= 已與另一個參數 (例如，AsyncLoadSlotRequest) 存在，只需將其附加到現有參數，以逗號分隔，不含空格。

   範例：

   OPTIONAL\_CAPABILITIES=AsyncLoadSlotRequest,AsyncLoadDataRequest

3. 儲存 configuration.properties 檔案。

4. 僅限容器化安裝：重新啟動 direct-access-agent 容器。

提示備註下次載入時變更就會生效，因此不需要重新啟動 直接存取閘道 服務。所有變更都將記錄到 connector-agent\_logs\_[date].txt 檔案。

若要停用非同步載入資料請求：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 設定 OPTIONAL\_CAPABILITIES=None，或者如果還有其他 AsyncLoadDataRequest 參數，則直接刪除 OPTIONAL\_CAPABILITIES。

3. 儲存 configuration.properties 檔案。

4. 僅限容器化安裝：重新啟動 direct-access-agent 容器。

### 非同步下載檔案

資訊備註從 直接存取閘道 1.8.1 開始支援。

AsyncFileDownloadRequest 是檔案連接器下載的選用功能。若未協商此功能，檔案下載將維持同步。

若要啟用非同步檔案下載請求：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 如果檔案中尚不存在，請新增以下行：

   OPTIONAL\_CAPABILITIES=AsyncFileDownloadRequest

   如果 OPTIONAL\_CAPABILITIES= 已與另一個參數 (例如，AsyncFileDownloadRequest) 存在，只需將其附加到現有參數，以逗號分隔，不含空格。

   範例：

   OPTIONAL\_CAPABILITIES=AsyncLoadDataRequest,AsyncFileDownloadRequest

3. 儲存 configuration.properties 檔案。

提示備註下次載入時變更就會生效，因此不需要重新啟動 直接存取閘道 服務。所有變更都將記錄到 connector-agent\_logs\_[date].txt 檔案。

若要停用非同步檔案下載請求：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 設定 OPTIONAL\_CAPABILITIES=None，或者如果還有其他 AsyncFileDownloadRequest 參數，則直接刪除 OPTIONAL\_CAPABILITIES。

3. 儲存 configuration.properties 檔案。

### 非同步請求載入插槽

資訊備註

需要 直接存取閘道 1.7.7 或更新版本。

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

資訊備註您應僅在 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)指示時啟用此功能。

若要啟用非同步載入時段請求：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 如果檔案中尚不存在，請新增以下行：

   OPTIONAL\_CAPABILITIES=AsyncLoadSlotRequest

   如果 OPTIONAL\_CAPABILITIES= 已與另一個參數 (例如，AsyncLoadDataRequest) 存在，只需將其附加到現有參數，以逗號分隔，不含空格。

   範例：

   OPTIONAL\_CAPABILITIES=AsyncLoadDataRequest,AsyncLoadSlotRequest

3. 儲存 configuration.properties 檔案。

提示備註下次載入時變更就會生效，因此不需要重新啟動 直接存取閘道 服務。所有變更都將記錄到 connector-agent\_logs\_[date].txt 檔案。

若要停用非同步載入時段請求：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 設定 OPTIONAL\_CAPABILITIES=None，或者如果還有其他 AsyncLoadSlotRequest 參數，則直接刪除 OPTIONAL\_CAPABILITIES。

3. 儲存 configuration.properties 檔案。

### 設定連接器啟動

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

資訊備註您應僅在 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)指示時啟用此功能。

資訊備註

需要 直接存取閘道 1.7.7 或更新版本。

若要調整連接器啟動參數：

1. 使用文字編輯器，以管理員身分開啟下列檔案。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

   * Windows 伺服器安裝：

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * 容器化安裝：

     /usr/share/Qlik/Gateway/configuration.properties

2. 將以下行新增至檔案：

   # CONNECTOR STARTUP TIMEOUT between 30 and 120 seconds

   CONNECTOR\_STARTUP\_TIMEOUT\_SECONDS=your-value

   # CONNECTOR STARTUP MAX ATTEMPTS between 1 and 5

   CONNECTOR\_STARTUP\_MAX\_ATTEMPTS=your-value

   資訊備註為防止命令管道壅塞，調整這些值需要啟用 AsyncLoadDataRequest，如上方 非同步請求載入插槽 中所述。這些設定在 AsyncLoadSlotRequest 停用時，將分別還原為固定的舊版值 30 和 3。

3. 儲存 configuration.properties 檔案。

4. 僅限容器化安裝：重新啟動 direct-access-agent 容器。

### 覆寫程序隔離設定的預設起始連接埠

啟用程序隔離時，您現在可以覆寫 直接存取閘道 用於與所有隔離的連接器程序進行程序間通訊的預設起始連接埠 (49152)。若另一個程序使用了預設連接埠，這會很實用。

資訊備註

* 您應僅在 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)指示時啟用此功能。

* 需要 直接存取閘道 1.7.8 或更高版本。

* 此功能也透過[公用 API](https://qlik.dev/apis/rest/direct-access-agents/) 受到支援。

要執行的操作：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

2. 在 # Connector Agent 區段之下，將以下行新增至檔案：

   DATA\_PORT\_RANGE\_START=port-value

   其中 port-value 是預設的起始連接埠。

3. 儲存 configuration.properties 檔案。

4. 視安裝工作流程而定，執行下列其中一個動作：

   * Windows 伺服器安裝：

     按 Qlik 資料閘道 - 直接存取 中的說明重新啟動 [對 Qlik 資料閘道 - 直接存取 進行設定和疑難排解](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Managing) 服務。

   * 容器化安裝：

     重新啟動 direct-access-agent 容器。

## 度量收集器

在常見的客戶環境中，大量的資料載入每天通過 直接存取閘道 進入 Qlik Cloud 分析。若能夠記錄和監控受這些載入影響的資源取用和使用情況，將有助於客戶據此規劃其載入。

新的指標收集器 (在 直接存取閘道 機器上於背景執行) 提供由 直接存取閘道、連接器和作業系統所產生的資源使用情況的基本記錄和監控。指標收集器可以在 JSON 檔案中進行本機設定，或透過[公用 API](https://qlik.dev/apis/rest/direct-access-agents/) 設定。

### 設定度量收集器

在 直接存取閘道 機器上，開啟下列檔案並視需要進行設定：

* Windows 伺服器安裝：

  <INSTALL\_DIR>\ConnectorAgent\MetricsCollector\metricscollectorsettings.json

* 容器化安裝：

  /usr/runMetricsCollector/metricscollectorsettings.json

#### 設定收集器設定 (MetricsCollectorSettings)

* `Enabled`：設定為`true` (預設) 以啟用指標收集，或`false`以停用它。

* `BaseScrapeIntervalSeconds`：輪詢連接器指標的頻率 (以秒為單位)。每個連接器都有自己的輪詢間隔。

* `Port`：由 API 或指標連接器使用的連接埠 (透過直接存取閘道的 REST)。

* `LocalDataRetentionDays`: 超過指定值的資料將從本機資料庫中刪除。

* `localDataRetentionDatabaseSizeInMb:` 要儲存在閘道機器上的指標資料總大小 (以 MB 為單位)。預設值為 500 MB。將會刪除舊資料，以確保不會超過配額。

  資訊備註

  * 需要 直接存取閘道 1.7.10 或更新版本。

  * 大量並行重新載入可能需要增加預設值。例如，一個有 60 個並行重新載入的租用戶可能需要高達 1 GB。

* `DataRetentionCheckIntervalMinutes`: 保留檢查的頻率。

* `LocalDatabaseFileLocation`: 本機資料庫的位置。這也可以是 UNC 路徑。預設位置如下：

  * Windows 伺服器安裝：

    C:\ProgramData\Qlik\Gateway\tmp

  * 容器化安裝：

    /usr/share/Qlik/Gateway/tmp

#### 配置連接器設定 (連接器組態)

對於所有 直接存取閘道 連接器，您可以設定度量輪詢間隔 (`ScrapeIntervalSeconds`)，並啟用 (`true`) 或停用 (`false`) 度量收集。

#### 範例 metricscollectorsettings.json 檔案

```
{
  "MetricsCollectorSettings": {
    "Enabled": true,
    "BaseScrapeIntervalSeconds": 1,
    "Port": 5052,
    "LocalDataRetentionDays": 30,
    "localDataRetentionDatabaseSizeInMb": 500,
    "DataRetentionCheckIntervalMinutes": 60,
    "LocalDatabaseFileLocation": ""
  },
  "ConnectorConfigurations": {
    "OdbcConnector": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "SystemMetrics": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "ConnectorAgent": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "RestConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapSqlConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapBwConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapPackageConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "FileConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    }
  }
}
```

### 載入度量

使用 REST (透過 直接存取閘道) 連接器，以從 直接存取閘道 機器收集度量。

要執行的操作：

1. 在 REST (透過 直接存取閘道) 連線設定中，啟用 允許使用 localhost 連線。

   如需詳細資訊，請參閱[建立 REST 連線](https://help.qlik.com/en-US/cloud-services/Subsystems/REST_Connector_help/Content/Connectors_REST/Create-REST-connection/Create-REST-connection.htm) （僅提供英文版）。

2. 將 http://localhost:5052/api/metrics 新增至允許的 URL 清單。

   請參閱上方 [限制 直接存取閘道 使用 REST 連接器可存取的 URL](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Limiting)。

3. 重新啟動 直接存取閘道 服務。

4. 建立應用程式，並從 http://localhost:5052/api/metrics 載入計量，透過 REST (透過 直接存取閘道) 連線。

### 支援的指標

* 系統指標：

  * network\_bytes\_sent\_total: 自系統啟動以來，透過 直接存取閘道 傳輸的位元組總數

  * network\_bytes\_received\_total: 自系統啟動以來，透過 直接存取閘道 接收的位元組總數

* 連接器指標：

  * process\_start\_time\_seconds: 自程序啟動以來經過的時間（以秒為單位）。

  * process\_cpu\_seconds\_total: CPU 處於特定狀態的累計秒數

  * process\_virtual\_memory\_bytes: 程序消耗的虛擬記憶體目前大小（以位元組為單位）。

  * process\_working\_set\_bytes: 處理程序工作集的目前大小（以位元組為單位）。

  * process\_private\_memory\_bytes: 處理程序所耗用之私用記憶體的目前大小 (以位元組為單位)。

  * process\_num\_threads: 處理程序使用的執行緒數量。

## 檢視和下載記錄檔案

記錄檔案提供關於 直接存取閘道 操作的資訊。Qlik 支援可能會請您提供記錄檔案以供故障排除。您可以在記錄檢視器中檢視或下載記錄檔案。在一般情況下，沒有理由要檢驗記錄檔案，但若您遇到重複故障或其他問題，記錄檔案通常有助於查明原因。

資訊備註檢視並下載記錄需要可以取用資料角色。

若要開啟記錄檢視器：

1. 在 管理 活動中心內，前往資料閘道並找到 直接存取閘道。

2. 按一下列末尾的 the 檢視記錄 icon，並選取。

   就會開啟記錄檢視器視窗。

3. 從左上方的下拉式清單，選擇 Qlik 支援要求您檢視或下載的記錄類型。

   下列記錄可用：

   * 直接存取閘道 記錄 (DirectAccessAgent)

   * DCaaS 記錄 (dcaas\_logs)

   * 以 ODBC 為基礎的連接器記錄 (odbc-connector\_logs)

   * SAP BW 連接器記錄 (QvSAPBwConnector-<date + timestamp>)

   * SAP SQL 連接器記錄 (QvSqlBwConnector-<date + timestamp>)

   * 連接器代理程式記錄 (connector-agent\_logs\_<date>)

   * SAP ODP 和 SAP 報表連接器記錄 (QvSapConnectorPackage-<process\_id>)

   * REST 連接器記錄 (rest-connector\_logs\_ < timestamp>)

   * 檔案連接器記錄 (file-connector\_logs\_<timestamp>)

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

4. 從鄰近的下拉式清單，選取您要檢視或下載的記錄。從最新 (目前作用中的記錄檔案) 到最舊排序記錄檔案。選取記錄檔案後，您可以使用 the 箭頭可捲動至頂端 icon 和 the 箭頭可捲動至底部 icon 按鈕分別跳至記錄檔案的開始或結尾。

   提示備註記錄檔檢視不會自動更新最新訊息。若要更新檢視，請按一下 the 箭頭可捲動至底部 icon 跳至記錄檔案的結尾，會以最新訊息更新。

5. 若要下載記錄檔案，按一下下載。

   檔案將會下載至您的電腦或將會提示您儲存，視您的瀏覽器設定而定。

### 在 直接存取閘道 機器上開啟 直接存取閘道 記錄

除了能夠從 管理 活動中心下載 直接存取閘道 (DirectAccessAgent) 記錄，您也可以直接從 直接存取閘道 機器開啟。

在預設安裝下，這些記錄位於：

C:\Program Files\Qlik\ConnectorAgent\data\logs

* Windows 伺服器安裝：

  C:\Program Files\Qlik\ConnectorAgent\data\logs

* 容器化安裝：

  /usr/data/logs

#### 變更 DirectAccessAgent 記錄層級

出於疑難排解目的，您可能需要變更 DirectAccessAgent 記錄的記錄層級。DirectAccessAgent 負責連線到 Qlik Cloud 服務。要檢視和變更 DirectAccessAgent 記錄的記錄詳細資訊層級，請從 ConnectorAgent 子資料夾 (預設安裝為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) 執行下列命令：

* 如要檢視目前的記錄層級，請執行：

  * Windows 伺服器安裝：

    connectoragent configuration getloggers

  * 容器化安裝：

    dotnet ConnectorAgent.dll configuration getloggers

* 如要將記錄層級設定為「追蹤」，請執行：

  * Windows 伺服器安裝：

    connectoragent configuration setloggers -l Root -v DEBUG

  * 容器化安裝：

    dotnet ConnectorAgent.dll configuration setloggers -l Root -v DEBUG

* 如要將記錄層級設定為「詳細資訊」，請執行：

  * Windows 伺服器安裝：

    connectoragent configuration setloggers -l Root –v DETAILED\_DEBUG

  * 容器化安裝：

    dotnet ConnectorAgent.dll configuration setloggers -l Root –v DETAILED\_DEBUG

有關其他記錄選項，請參閱下面 Qlik Cloud 中的設定 直接存取閘道。

## 更新註冊金鑰

在金鑰損毀這種不太可能發生的事件中，或者若您懷疑未獲授權的使用者存取資料閘道伺服器，可能有必要變更註冊金鑰。

若要更新註冊金鑰：

1. 視您的安裝工作流程而定，執行下列其中一個動作：

   * Windows 伺服器安裝：

     在直接存取閘道伺服器上，以管理員身分開啟命令提示字元並將工作目錄變更為 ConnectorAgent 子資料夾 (預設安裝為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)。

   * 容器化安裝：

     在 direct-access-agent 容器中開啟主控台。

2. 執行下列命令：

   * 產生新的金鑰：

     * Windows 伺服器安裝：

       connectoragent qcs generate\_keys

     * 容器化安裝：

       dotnet ConnectorAgent.dll qcs generate\_keys

   * 顯示金鑰：

     * Windows 伺服器安裝：

       connectoragent qcs get\_registration

     * 容器化安裝：

       dotnet ConnectorAgent.dll qcs get\_registration

     就會顯示金鑰：

     ![Direct Access 註冊金鑰影像](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/da_reg_key.png)

3. 複製整個金鑰，如上面範例所示。

4. 在 管理 活動中心內，按一下相關列末尾的 the 編輯 icon 按鈕並選取，以開啟資料閘道設定。

5. 在金鑰欄位中貼上金鑰 (取代目前金鑰) 並儲存設定。

6. 返回 Direct Access gateway 伺服器，並視安裝工作流程而定進行下列事項之一：

   * Windows 伺服器安裝：

     按 Qlik 資料閘道 - 直接存取 中的說明重新啟動 [對 Qlik 資料閘道 - 直接存取 進行設定和疑難排解](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Managing) 服務。

   * 容器化安裝：

     重新啟動 direct-access-agent 容器。