在容器中设置 Qlik Data Gateway - Direct Access | Qlik Cloud帮助
跳到主要内容 跳到补充内容

在容器中设置 Qlik Data Gateway - Direct Access

上次更新日期:2026-11-18

本主题概述了如何设置容器化的 Direct Access gateway。本文档提供了先决条件和安装指南,并介绍了在使用容器化 Direct Access gateway 时需要了解的限制和注意事项。

信息注释自 Direct Access gateway 1.8.0 起支持。

支持的数据源

容器化安装支持以下连接器:

  • 支持以下 ODBC 连接器:
    • PostgreSQL
    • SQL Server
    • oracle
    • Amazon Redshift、Snowflake、Databricks、Google BigQuery 和 Amazon Athena
      信息注释自 Direct Access gateway 1.8.2 起支持。

    有关 ODBC 连接器的详细信息,请参阅 ODBC 数据库 ‒ Qlik Cloud (仅提供英文版本)。

  • REST 连接器 (REST 通过 Direct Access gateway)。有关 REST 数据源的更多信息,请参阅 REST 源 ‒ Qlik Cloud (仅提供英文版本)。

  • MySQL 连接器。

    信息注释自 Direct Access gateway 1.8.1 起支持。
  • SAP SQL、SAP BW、SAP ODP 和 SAP Report 连接器。有关在用于容器化安装的 Qlik Data Gateway - Direct Access 计算机上安装 SAP NetWeaver RFC SDK 的信息,请参阅 安装适用于 Qlik Data Gateway - Direct Access 的 SAP NetWeaver RFC SDK (仅提供英文版本)。

    信息注释自 Direct Access gateway 1.8.1 起支持。

什么是容器化Direct Access gateway?

您可以将 Direct Access gateway 部署到 Docker 容器中。这种类型的部署称为容器化 Direct Access gateway。支持在 Linux、macOS 和 Windows 上进行容器化 Direct Access gateway 部署。

容器化的 Direct Access gateway 为您的 Direct Access gateway 环境提供了可移植性。

使用 Qlik Data Gateway - Direct Access 时的最佳实践

为了在使用 Qlik Data Gateway - Direct Access 时获得成功体验,强烈建议遵守以下最佳实践:

  • 不要将 Direct Access gateway 用于开发、用户验收测试和生产,因为这会增加可用资源过载的风险,并影响系统稳定性。从业务角度来看,资源不足和稳定性下降的组合可能会导致生产应用程序数据的更新延迟。

  • 为了获得最佳性能,请在尽可能靠近数据源的环境中安装 Direct Access gateway。

系统先决条件

本部分介绍了使用容器化 Direct Access gateway 的要求。

软件要求

  • 宿主机上已安装 Docker Engine 20.9+ 版本和 Docker Compose 插件(docker compose,v2 语法)。

所需端口和协议

有关所需端口和协议,请参阅 所需端口和协议。

推荐硬件

  • 主机:8 核,32 GB 内存,Docker 可用 5 GB 存储空间

  • 可选:在 compose 文件中对容器设置匹配的限制,以便网关拥有专用容量,而不是与主机上的其他容器或进程竞争:

    direct-access-agent:
        image: ...
        deploy:
          resources:
            limits:
              cpus: "6"
              memory: 24G
    ...
    dcaas:
        image: ...
        deploy:
          resources:
            limits:
              cpus: "2"
    

最低硬件要求

最低硬件仅适用于使用较小的专用部署(开发、测试或生产)、持续低数据量和有限数量的并发重载的特定场景。

  • 主机:4 核,8 GB 内存,5 GB 可用于 Docker 的存储空间

  • 可选:在 compose 文件中对容器设置匹配的限制,以便网关拥有专用容量,而不是与主机上的其他容器或进程竞争:

    direct-access-agent:
        image: ...
        deploy:
          resources:
            limits:
              cpus: "2"
              memory: 4G
    ...
    dcaas:
        image: ...
        deploy:
          resources:
            limits:
              cpus: "2"
    

安装 Qlik Data Gateway - Direct Access

设置 Direct Access gateway 涉及需要在 Administration 活动中心和 Direct Access gateway 服务器上执行的步骤。

信息注释需要在 Administration 活动中心中执行的数据网关过程需要租户管理员权限。

阶段一:下载 Qlik Data Gateway - Direct Access

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

    任何现有的数据网关都将列在一个表中,其中显示了每个网关的基本信息。

  2. 单击部署工具栏按钮。

    部署数据网关对话框打开。

  3. 选择 数据网关 - 直接访问 - 容器化 Direct Access 网关,接受 Qlik 客户协议,然后点击 下载。Direct Access gateway 安装文件 (docker-compose.qlik-data-gateway-direct-access.yml) 将下载到您的计算机。

第二阶段:通过运行 Docker Compose 文件启动部署

要开始 Direct Access gateway 的部署,请运行以下命令:

docker compose -f docker-compose.qlik-data-gateway-direct-access.yml up

将 SAP NetWeaver RFC SDK 复制到容器

对于 SAP SQL、SAP BW、SAP ODP 和 SAP Report 连接器,请将 SAP NetWeaver RFC SDK 文件复制到容器中。

在包含 Linux 和 Windows SDK 二进制文件夹的目录中,运行:

docker cp . direct-access-agent-1:/usr/share/Qlik/Gateway/sap-sdk

复制文件后,重启 direct-access-agent-1 容器。

第三阶段:设置Direct Access gateway

有关详细设置说明,请参阅 第三阶段:设置Direct Access gateway。

阶段四:注册数据网关

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

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

要启动 Qlik Data Gateway - Direct Access 服务,请启动 dcaas-dg 和 direct-access-agent 容器。

阶段六:将连接添加到数据源

请参阅 阶段六:将连接添加到数据源。

环境设置

本部分列出了 docker-compose.qlik-data-gateway-direct-access.yml 文件中的特定环境变量,您可能需要配置这些变量,以便通过网关正确连接数据源。

  • ALLOW_SOURCES:以逗号分隔的主机名和 IP 地址白名单。当网关代理需要连接到您自己的服务器或本地/私有网络中的其他主机(例如 localhost 上的数据库、Docker 服务名称或私有 IP 主机)时,您需要将该地址添加到 ALLOW_SOURCES — 否则连接尝试将被拒绝。

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们!