# 設定 Qlik 資料閘道 - 直接存取

您可以在 Windows 伺服器或容器化環境中設定 Qlik 資料閘道 - 直接存取。為了順利完成設定，請確保您熟悉特定設定工作流程的先決條件、安裝說明、限制與考量事項。

資訊備註

如需 Qlik 資料閘道 - 直接存取 的 AWS PrivateLink 模式，請參閱 [為 Qlik 資料閘道 - 直接存取 設定 AWS PrivateLink](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-aws-privatelink.htm)。此模式不會取代本主題中的標準先決條件與網路需求。

## 設定工作流程

選擇下列工作流程之一：

* [在 Windows 伺服器上設定 Qlik 資料閘道 - 直接存取](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)
* [在容器中設定 Qlik 資料閘道 - 直接存取](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm)

## 系統必要條件

### 軟體需求

視您的設定方法而定，請參閱下列其中一項：

* Windows伺服器[軟體必要條件](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software)：

* 容器化：[軟體需求](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#SoftwareReq)

### 通用需求

這些需求同時適用於 Windows 伺服器與容器化安裝。

#### 必要的連接埠和通訊協定

下列區段列出所需連接埠。

#### 傳出連接埠

應開啟 HTTPS/TCP-443 以對 <tenant-id>.<region>.qlikcloud.com 進行傳出通訊。

#### 內部連接埠

下面是透過內部資料閘道流程通訊用於連接埠的清單。若另一個應用程式正在使用其中任何連接埠，請設定其他應用程式或解除安裝。

一般連接埠

* 5050 (連接器 Agent REST API)
* 9027 (DCAAS REST API)

ODBC 連接埠

* 3005 (ODBC 連接器 REST API)
* 50260 (ODBC 連接器 gRPC)

SAP 連接埠

* 3015 (SAP BW 連接器 REST API)

* 50270 (SAP BW 連接器 gRPC)

* 3025 (SAP SQL 連接器 REST API)

* 50280 (SAP SQL 連接器 gRPC)

* 3035 (SAP ODP 連接器 REST API)

* 50290 (SAP ODP 連接器 gRPC)

* 3035 (SAP 套件連接器 REST API)

* 50290 (SAP 套件連接器 gRPC)

REST 連接埠

* 3055 (REST 連接器 REST API)
* 50310 (REST 連接器 gRPC)

檔案連接埠

* 3045 (檔案連接器 REST API)
* 50300 (檔案連接器 gRPC)

#### WSS 通訊協定

除了 HTTPS，直接存取閘道也會使用 WSS (WebSocket Secure) 通訊協定。因此，請確認防火牆和 Proxy 伺服器 (若您打算使用) 設定為允許傳出 WSS 連線。

### 建議硬體

視您的設定方法而定，請參閱下列其中一項：

* Windows伺服器[建議硬體](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#RecHardware)：

* 容器化：[建議硬體](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#RecHardware)

### 系統密碼編譯 (僅限 Windows 伺服器安裝)

請參閱 [系統密碼編譯](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#System)。

## 安裝 Qlik 資料閘道 - 直接存取

### 第一階段：下載 Qlik 資料閘道 - 直接存取

視您的設定方法而定，請參閱下列其中一項：

* Windows伺服器[階段一：下載 Qlik 資料閘道 - 直接存取](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage5)：

* 容器化：[階段一：下載 Qlik 資料閘道 - 直接存取](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage1)

### 第二階段：安裝或部署 直接存取閘道

視您的設定方法而定，請參閱下列其中一項：

* Windows伺服器[階段二：在保護資料來源之防火牆後方的伺服器上安裝 直接存取閘道](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage4)：

* 容器化：[階段二：透過執行 Docker Compose 檔案啟動部署](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage2)

### 階段三：設定 直接存取閘道

此階段包括設定 Qlik Cloud 租用戶 URL、選擇性設定 Proxy 伺服器以及產生註冊金鑰。您將需要將金鑰複製到 管理 活動中心內的資料閘道設定 (在以下的階段三)。金鑰用來建立直接存取閘道和 Qlik Cloud 租用戶之間的已驗證連線。

資訊備註

不支援連線到 Qlik 匿名租用戶 (瑞典地區)。

自 直接存取閘道 1.7.16 起，現已支援加拿大地區。部署閘道安裝檔案時，在 管理 活動中心部署期間選取加拿大地區。

在 Direct Access gateway 機器上，視您的安裝工作流程而定，進行下列事項之一：

* Windows 伺服器：以系統管理員身分開啟命令提示字元，並將工作目錄變更為 ConnectorAgent 子資料夾 (在預設安裝下為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)。

* 容器化：在 direct-access-agent 容器內開啟主控台。

然後，繼續如下所述。

#### 設定 Qlik Cloud 租用戶

設定要連線至哪個 Qlik Cloud 租用戶。若要透過 Proxy 伺服器連線至租用戶，將相關參數新增至命令，如下所示。

在不使用 Proxy 伺服器的情況下設定 Qlik Cloud 租用戶的命令：

* Windows 伺服器安裝

  * 語法：connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url

  * 範例： connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

* 容器化安裝

  * 語法：dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url

  * 範例： dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

使用 Proxy 伺服器設定 Qlik Cloud 租用戶的命令：

* Windows 伺服器安裝

  * 語法：connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password

  * 範例： connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

* 容器化安裝

  * 語法：dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password

  * 範例： dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

如需 Proxy 限制的資訊，請參閱 [透過 Proxy 伺服器連線至 Qlik Cloud](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Connecti)。

#### 設定 CA 搭售

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

誰需要設定 CA 搭售？

只有在您是下列身分時，才需要設定 CA 搭售：

* Qlik Cloud 政府 客戶
* 使用作為 Proxy 運作的安全性設備並以自己的 CA 根憑證取代從網際網路收到的憑證資訊的 Qlik Cloud 商務客戶

我應該使用哪個搭售？

客戶應使用 Qlik CA 搭售或攜帶自己的 CA 搭售，如下所示：

* Qlik 提供 CA 搭售： 應由具有標準環境的 Qlik Cloud 政府 客戶使用。標準環境沒有作為 Proxy 運作的安全性設備，並以自己的 CA 根憑證取代從網際網路收到的憑證資訊。

  在預設 直接存取閘道 安裝中，CA 搭售檔案可見於下列位置：

  * Windows 伺服器安裝：C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg\_ca\_bundle.pem

  * 容器化安裝：/usr/share/Qlik/Gateway/ssl/qcg\_ca\_bundle.pem

  資訊備註您可以重新命名 CA 搭售檔案，但請確認這具有 .pem 副檔名 (例如 qlikcerts.pem)。然後執行以下描述的命令。

* 客戶自備 CA 搭售：若客戶的環境所使用的安全性設備充當代理，並以其自有的 CA 根憑證取代從網際網路接收到的憑證資訊，則應使用此選項。若這些憑證是自行簽署，則除了設定 CA 搭售的命令，您也需要執行命令以允許 CA 搭售。以下描述這兩種命令。這適用於 Qlik Cloud 政府 客戶和 Qlik Cloud 商務客戶等。

設定 CA 搭售的命令

執行下列命令以設定 CA 憑證搭售：

語法 (Windows 伺服器安裝)：

connectoragent qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file

語法（容器化安裝）：

dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file

範例 (Windows 伺服器安裝)：

connectoragent qcs qcs set\_config --ca\_bundle\_path c:\ca\cacerts.pem

範例 (容器化安裝)：

dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_path c:\ca\cacerts.pem

允許 CA 搭售的命令

有些環境使用作為 Proxy 運作的安全性設備，並以自己的 CA 根憑證取代從網際網路收到的憑證資訊. 只有在安全性設備本身使用自行簽署的憑證時，才需要執行此命令。在此情況下，CA 搭售可能不受信任，除非您執行下列命令：

* Windows 伺服器安裝：

  connectoragent qcs set\_config --ca\_bundle\_allow\_invalid\_certs true

* 容器化安裝：

  dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_allow\_invalid\_certs true

資訊備註若您不確定您的環境是否使用這種安全性設備，請聯絡 IT 管理員。

#### 產生並顯示註冊金鑰

金鑰用來建立直接存取閘道和 Qlik Cloud 租用戶之間的已驗證連線。

產生註冊金鑰的命令

* Windows 伺服器安裝：

  connectoragent qcs generate\_keys

* 容器化安裝：

  dotnet ConnectorAgent.dll qcs generate\_keys

顯示註冊金鑰的命令

dotnet ConnectorAgent.dll qcs get\_registration

* Windows 伺服器安裝：

  connectoragent qcs get\_registration

* 容器化安裝：

  dotnet ConnectorAgent.dll qcs get\_registration

就會顯示金鑰。

![](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/da_reg_key.png)

複製整個金鑰，如上面範例所示。您將需要在下一階段的 管理 活動中心內貼上。

### 階段四：註冊資料閘道

下一步是註冊資料閘道。 這可以透過 管理 活動中心或在命令列上完成。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)選項 1：透過 管理 活動中心

警告備註註冊 直接存取閘道 會自動在 管理 活動中心建立 身分識別提供者 (多雲端) 項目，以進行安全的閘道對租用戶通訊。身分識別提供者 描述包含閘道 ID (簽發者 gateway\_id)，可讓您輕鬆在 資料閘道 區段 (位於 管理 活動中心) 中找到相關聯的閘道。刪除閘道 身分識別提供者 將會中斷閘道連線，因此您應該只在絕對確定不再需要該閘道時才執行此動作。如果您不小心刪除了 身分識別提供者，重新啟動 直接存取閘道 將會還原項目並重新連線閘道。

1. 在 管理 活動中心內，選取 資料閘道。

   任何現有資料閘道將列於[顯示關於每個閘道基本資訊的表格](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing-console.htm#gateprop)。

2. 按一下建立工具列按鈕。

   就會開啟建立資料閘道對話方塊。

   ![](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_da-gate-create.png)

3. 指定資料閘道的名稱。

4. 或者，提供資料閘道的描述。

5. 從資料閘道類型下拉式清單中，選取直接存取。

6. 從相關空間下拉式清單中，選取空間。

   聯結直接存取閘道與空間時，您應注意下列事項：

   * 只能在共用或受管理空間中建立資料閘道

   * 若要在一個使用另一個空間中資料閘道的空間中建立資料連線，您在資料閘道空間中必須有可以取用資料角色。

   * 若要建立資料閘道，您必須是空間擁有者或擁有可以管理角色。對於基於使用者的訂閱，您也需要專業權利。如需詳細資訊，請參閱[管理使用者權利](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-user-allocations.htm)。

   * 資料閘道只能與單一空間聯結。

7. 在金鑰欄位中貼上您之前產生的註冊金鑰。

8. 按一下建立。

   可將資料閘道新增至 資料閘道 清單。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)選項 2：使用命令列自動註冊

您也可以透過命令列自動註冊 直接存取閘道，而無需使用 管理 活動中心。

資訊備註

若要自動註冊並移除自動註冊的閘道，您需要下列權限：

* 自動註冊：您需要將 註冊 Direct Access gateway 管理員權限設定為 允許。

* 移除自動註冊的閘道：您需要將 註冊 Direct Access gateway 管理員權限設定為 允許。

如需權限的詳細資訊，請參閱 [預設權限與自訂角色](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/permissions-scopes-capacity-model.htm)。

如需操作說明，請視您的安裝工作流程參閱下列其中一項：

* Windows 伺服器安裝：[選項 2：使用命令列自動註冊](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#StageAuto)

* 容器化安裝：[選項 2：使用命令列自動註冊](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#StageAuto)

### 階段五：在 Direct Access gateway 伺服器上啟動 Qlik 資料閘道 - 直接存取 服務

接下來，您需要啟動 Qlik 資料閘道 - 直接存取 服務。

視您的設定方法而定，請參閱下列其中一項：

* Windows 伺服器安裝：[階段五：在 Direct Access gateway 伺服器上啟動 Qlik 資料閘道 - 直接存取 服務](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage3)

* 容器化安裝：[階段五：在 Direct Access gateway 伺服器上啟動 Qlik 資料閘道 - 直接存取 服務](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage5)

### 階段六：將連線新增至資料來源

在 資料閘道 清單中找到閘道並驗證其狀態為「已連線」(您可能需要重新整理瀏覽器以查看目前狀態)。然後您可以繼續將連線新增至資料來源。

有數種方法可以從資料來源中載入資料：

* [從空間新增並管理資料來源](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/managing-data-resources-spaces.htm)

* [使用資料管理員載入和管理資料](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/managing-data.htm)

* [使用指令碼載入和轉換資料](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/introduction-data-modeling.htm)

可用資料來源的清單將包含支援閘道連線性之資料來源的複製項目。可以透過「透過直接存取閘道」文字識別符合閘道的資料來源，這顯示在來源類型後的括號中。

符合閘道的來源連線範例

符合閘道的來源連線範例

符合閘道的來源連線範例 ![符合閘道的來源連線範例](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/da-source-example.png)

資訊備註符合閘道之資料來源的新增資料連線對話方塊具有額外的直接存取閘道欄位，可讓您選取要使用哪個閘道。

## 一般限制和考慮事項

* 直接存取閘道 只能連線至單一租用戶。

* 如果由於任何原因，在 Qlik 應用程式載入期間重新啟動 直接存取閘道 伺服器，載入將會失敗。重新啟動 Qlik 應用程式載入以重新整理資料。

* 載入指令碼查詢不可超過 500,000 個字元。

  如需關於載入指令碼的資訊，請參閱 [執行指令碼](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/reloading-scripts.htm)。