# 设置 Qlik Data Gateway - Direct Access

您可以在 Windows 服务器上或在容器化环境中设置 Qlik Data Gateway - Direct Access。为确保设置成功，请确保您熟悉适用于您特定设置工作流的前提条件、安装说明、限制和注意事项。

信息注释

有关 Qlik Data Gateway - Direct Access 的 AWS PrivateLink 模式，请参阅 [为 Qlik Data Gateway - Direct Access 配置 AWS PrivateLink](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-aws-privatelink.htm)。该模式并不能替代本主题中的标准先决条件和网络要求。

## 设置工作流

选择以下工作流之一：

* [在 Windows 服务器上配置 Qlik Data Gateway - Direct Access](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)
* [在容器中配置 Qlik Data Gateway - Direct Access](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm)

## 系统先决条件

### 软件要求

请根据您的设置方法参考以下内容之一：

* Windows服务器：[软件前提条件](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software)

* 容器化：[软件要求](https://help.qlik.com/zh-CN/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（连接器代理 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) 协议。因此，请确保防火墙和代理服务器（如果您打算使用）设置为允许出站 WSS 连接。

### 建议的硬件

请根据您的设置方法参考以下内容之一：

* Windows服务器：[推荐硬件](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#RecHardware)

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

### 系统加密（仅限 Windows 服务器安装）

参见 [系统密码](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#System)。

## 安装 Qlik Data Gateway - Direct Access

### 第一阶段：下载 Qlik Data Gateway - Direct Access

请根据您的设置方法参考以下内容之一：

* Windows服务器：[阶段一：下载 Qlik Data Gateway - Direct Access](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage5)

* 容器化：[阶段一：下载 Qlik Data Gateway - Direct Access](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage1)

### 第二阶段：安装或部署 Direct Access gateway

请根据您的设置方法参考以下内容之一：

* Windows服务器：[阶段二：在保护数据源的防火墙后面的服务器上安装 Direct Access gateway](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage4)

* 容器化：[阶段二：通过运行 Docker Compose 文件启动部署](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage2)

### 阶段三：设置 Direct Access gateway

此阶段包括设置 Qlik Cloud 租户 URL、可选地设置代理服务器以及生成注册密钥。您需要将密钥复制到 Administration 活动中心中的数据网关设置（在下面的阶段三中）。密钥用于在直接访问网关和 Qlik Cloud 租户之间建立经过身份验证的连接。

信息注释

不支持连接至 Qlik 匿名租户（瑞典区域）。

自 Direct Access gateway 1.7.16 起，现已支持加拿大区域。在部署网关安装文件时，在 Administration 活动中心部署期间选择加拿大区域。

在 Direct Access gateway 计算机上，根据您的安装工作流程执行以下操作之一：

* Windows 服务器：以管理员身份打开命令提示符，并将工作目录更改为 ConnectorAgent 子文件夹（在默认安装中为 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent）。

* 容器化：在 direct-access-agent 容器内打开控制台。

然后，继续下面的操作。

#### 设置 Qlik Cloud 租户

设置要连接的 Qlik Cloud 租户。要通过代理服务器连接到租户，请将相关参数添加到命令中，如下所示。

在不使用代理服务器的情况下设置 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

使用代理服务器设置 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@

有关代理限制的信息，请参阅[通过代理服务器连接到 Qlik Cloud](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Connecti)。

#### 设置 CA 捆绑包

CA 捆绑包验证 Qlik Cloud 租户的身份，从而确保可信连接。

谁需要设置 CA 捆绑包？

只有在以下情况下才需要设置 CA 捆绑包：

* Qlik Cloud 政府 客户
* 一个 Qlik Cloud 商业客户使用安全设备作为代理，并用其自己的 CA 根证书替换从互联网接收的证书信息

我应该使用哪个捆绑包？

客户应使用 Qlik CA 捆绑包或自带 CA 捆绑包，如下所示：

* Qlik 提供 CA 捆绑： 应由拥有标准环境的 Qlik Cloud 政府 客户使用。标准环境是一种没有安全设备的环境，该安全设备充当代理，并将从互联网接收的证书信息替换为其自己的 CA 根证书。

  在默认 Direct Access gateway 安装中，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 捆绑包的命令

某些环境使用安全设备作为代理，并用其自己的 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-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/da_reg_key.png)

复制整个密钥，如上面的示例所示。您需要在下一阶段将其粘贴到 Administration 活动中心中。

### 阶段四：注册数据网关

下一步是注册数据网关。 这可以通过 Administration 活动中心或在命令行中完成。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)选项 1：通过 Administration 活动中心

警告注释注册 Direct Access gateway 会在 管理活动中心自动创建一个 身份提供程序（多云）条目，用于安全的网关到租户通信。身份提供程序描述包含网关 ID (issuer gateway\_id)，这使您可以轻松地在 数据网关部分（管理活动中心）中找到关联的网关。删除网关 身份提供程序 将断开网关连接，因此只有在您绝对确定不再需要该网关时才应执行此操作。如果您不小心删除了 身份提供程序，重新启动 Direct Access gateway 将恢复条目并重新连接网关。

1. 在 Administration 活动中心中，选择数据网关。

   任何现有的数据网关都将列在[一个表中，其中显示了每个网关的基本信息](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing-console.htm#gateprop)。

2. 单击创建工具栏按钮。

   创建数据网关对话框打开。

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

3. 指定数据网关的名称。

4. （可选）提供数据网关的描述。

5. 从数据网关类型下拉列表中，选择直接访问。

6. 从关联空间下拉列表中，选择一个空间。

   将 Direct Access gateway 与空间关联时，您应该注意以下事项：

   * 数据网关只能在共享或托管空间中创建

   * 为了在一个空间中创建使用另一个空间的数据网关的数据连接，您必须在数据网关空间中具有可以使用数据角色。

   * 要创建数据网关，您必须是空间所有者或具有可以管理角色。对于基于用户的订阅，您还需要专业用户权限。有关更多信息，请参阅[管理用户使用权](https://help.qlik.com/zh-CN/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，而无需使用 Administration 活动中心。

信息注释

要自动注册和移除自动注册的网关，您需要以下权限：

* 自动注册：您需要将 注册 Direct Access gateway 管理员权限设置为 允许。

* 移除自动注册的网关：您需要将 注册 Direct Access gateway 管理员权限设置为 允许。

有关权限的详细信息，请参阅 [默认权限和自定义角色](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/permissions-scopes-capacity-model.htm)。

有关说明，请根据您的安装工作流参阅以下内容之一：

* Windows 服务器安装：[选项 2：使用命令行自动注册](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#StageAuto)

* 容器化安装：[选项 2：使用命令行自动注册](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#StageAuto)

### 阶段五：在 Direct Access gateway 服务器上启动 Qlik Data Gateway - Direct Access 服务

接下来，您需要启动 Qlik Data Gateway - Direct Access 服务。

请根据您的设置方法参考以下内容之一：

* Windows 服务器安装：[阶段五：在 Direct Access gateway 服务器上启动 Qlik Data Gateway - Direct Access 服务](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage3)

* 容器化安装：[阶段五：在 Direct Access gateway 服务器上启动 Qlik Data Gateway - Direct Access 服务](https://help.qlik.com/zh-CN/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)

可用数据源列表将包含支持网关连接的数据源的重复条目。与网关兼容的数据源可以通过文字“via Direct Access Gateway”（通过 Direct Access gateway ）来识别，该文字出现在源类型后面的括号中。

兼容网关的源连接示例

兼容网关的源连接示例

兼容网关的源连接示例 ![兼容网关的源连接示例](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/da-source-example.png)

信息注释兼容网关的数据源的添加数据连接对话框有一个额外的直接访问网关字段，允许您选择要使用的网关。

## 一般限制和考虑事项

* Direct Access gateway 只能连接到单个租户。

* 如果由于任何原因，Direct Access gateway 服务器在 Qlik 应用程序重新加载过程中重新启动，则重新加载将失败。重新启动 Qlik 应用程序重新加载以刷新数据。

* 重载脚本查询不能超过 500000 个字符。

  有关重载脚本的信息，请参阅[运行脚本](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/reloading-scripts.htm)。