跳到主要内容 Skip to complementary content

安装 Qlik DataTransfer

Qlik DataTransfer是一个轻量级 Windows 应用程序,它允许您将本地数据源中的数据上传到 Qlik Sense SaaS 租户,而无需防火墙隧道。服务帐户所有者 (SAO) 或租户管理员从租户生成一个 API 密钥,然后该密钥用于验证 Qlik DataTransfer。经过身份验证后,您可以计划自动重新加载数据或手动上传数据。

Qlik Sense Enterprise SaaS Government 注释Qlik DataTransfer 支持加密通信,但不符合 FIPS(联邦信息处理标准)。Qlik Sense Enterprise SaaS - Government (US) 用户可以在实施过程中使用它,等待自己的风险审查。

Qlik DataTransfer 可用于以下类型的数据源:

  • 应用程序数据
  • 连接数据
  • 文件夹

有关对于 Qlik DataTransfer 可用的数据类型的信息,请参阅通过 Qlik DataTransfer 上传本地数据

Qlik DataTransfer 的安装只能分配给单个 Qlik Sense SaaS 租户。

Qlik DataTransfer 系统要求

Qlik DataTransfer 要求
平台
  • Microsoft Windows Server 2012 R2
  • Microsoft Windows Server 2016
  • Microsoft Windows Server 2019
  • Microsoft Windows Server 2022

仅用于开发和测试目的:

  • Microsoft Windows 10(仅限 64 位版本)
信息注释这些操作系统由 Qlik Sense 提供支持。第三方软件可能需要安装服务包。
处理器 (CPU)

多核 64 位兼容处理器。我们建议至少 4 核。

内存

最小 8 GB

Qlik Sense 产品的内存需求与所分析的数据量密切相关。

磁盘空间 最小 2 GB
存储空间

对于部署中的大量应用程序和内容,需要足够的存储空间。

PowerShell 5.1 或更高版本
TLS 1.2 或更高版本

在开始之前

下载并运行 Qlik DataTransfer 安装程序之前,请确保满足以下要求:

  • 您具有对于 Qlik Sense SaaS 租户的访问权限。
  • 您必须在自己的租户上拥有 Professional 访问权限。
  • 您在该租户上分配了 Developer 角色。
  • 您可以访问向其上传来自 Qlik DataTransfer 的数据的所有空间。有关更多信息,请参阅管理空间
  • 您对有权访问本地数据源的 Windows 计算机具有管理员权限。
  • 您的 Windows 计算机满足以下系统要求: Qlik DataTransfer 的系统要求 (仅提供英文版本)
  • 管理控制台 禁用了 API 密钥。有关启用 API 密钥的信息,请参阅管理 API 密钥
  • 策略 SSL 配置设置必须设置为仅支持正在安装 Qlik DataTransfer 的计算机上的 IANA 格式的密码。

    如果要在 Windows Server 2012 R2 上安装或升级到 Qlik DataTransfer May 2021 或更高版本,则必须更新 TLS 密码套件。Qlik DataTransfer May 2021 或更高版本不支持 Windows Server 2021 R2 默认安全策略中包含的默认密码。必须提供以下密码套件:

    • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

    • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

    • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

    有关在系统中更新 TLS 密码套件或在 Qlik DataTransfer 环境中禁用弱密码的说明,请参阅以下社区文章:https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406

  • Qlik DataTransfer 需要 Windows 用户帐户。建议您使用专用用户帐户来运行 Qlik DataTransfer 服务。如果专用用户是管理员,则可以作为该用户登录来安装 Qlik DataTransfer。如果专用用户不是本地管理员,则必须使用管理员帐户才能安装 Qlik DataTransfer

    如果要在已安装 Qlik Sense Enterprise on Windows 的Windows服务器上安装或升级 Qlik DataTransfer,则 Qlik DataTransfer 必须与 Qlik Sense 安装中使用的 Qlik Sense服务用户一起安装。

  • 安装 Qlik DataTransfer 的用户帐户必须具有使用 RemoteSigned 执行策略执行 PowerShell 脚本的权限

  • 如果在使用租户配置 Qlik DataTransfer 后更改服务登录帐户,则必须重新配置租户和连接。然后在 %ProgramData%/Qlik/DataTransfer/DataUpload/storage 中,删除 token.json。重启 Qlik DataTransfer 服务。

  • 对于 February 2021 SR1,建议在与 Qlik Sense Enterprise on WindowsQlikView Server 不同的服务器上安装 Qlik DataTransfer。如果 Qlik DataTransfer 安装在 Qlik Sense Enterprise on Windows 服务器 或 QlikView Server 上,则 Qlik DataTransfer 使用本地系统用户帐户运行。如果更改服务用户帐户,它将停止 Qlik DataTransfer 或停止 Qlik Sense 服务调度器

提示注释Qlik DataTransfer 安装程序包括 Qlik associative engine、Simba ODBC 连接器和 Qlik DataTransfer 代理的实例。启动时,它会消耗额外的内存和处理资源,如果您的服务器正在与其他应用程序共享资源,则必须考虑这些资源。对于生产环境,建议您在其自己的服务器上安装 Qlik DataTransfer

正在确认安装用户帐户执行策略

安装 Qlik DataTransfer 的用户帐户必须具有使用 RemoteSigned 执行策略执行 PowerShell 脚本的权限。如果您没有权限分配用户帐户权限,请与管理员联系,为安装用户帐户授予这些权限。

  1. 以管理员模式打开 PowerShell。

  2. 运行Get-ExecutionPolicy。它应当为 RemoteSigned。如果为 Restricted Disabled,则继续下个步骤。

  3. 运行Set-ExecutionPolicy RemoteSigned

  4. 选择 Y

下载并运行安装程序

信息注释

如果要在已安装 Qlik Sense Enterprise on Windows 的Windows服务器上安装或升级 Qlik DataTransfer,则 Qlik DataTransfer 必须与 Qlik Sense 安装中使用的 Qlik Sense服务用户一起安装。

  1. 从以下任一位置下载 Qlik DataTransfer.exe 文件:

    • Qlik下载站点
      有关更多信息,请参阅下载安装文件

    • Qlik Cloud. 在右上角单击您的简档图标,然后单击简档设置。在其他下,单击工具

      Qlik Sense Enterprise SaaS Government 注释该选项在 Qlik Sense Enterprise SaaS - Government (US) 中不可用。
  2. 运行安装程序并接受 Qlik 用户许可协议。默认安装路径为 %Program Files%\Qlik\DataTransfer。输入服务凭据时,用户名的格式必须为 domain\username。

    信息注释

    如果输入的用户名长度超过 20 个字符,则必须采用用户主体名称 (UPN) 格式,并且必须包含完整的域名。例如,longusername@full.domain.name

    信息注释

    如果您在同一服务器上安装了 Qlik Sense Desktop 或另一个 Qlik 平台,则必须关闭它们,并在您安装 Qlik DataTransfer 之前停止 Qlik 服务。

    Qlik DataTransfer 安装程序屏幕

    一旦安装,按以下顺序重新启动 Qlik 服务:

    1. Qlik Sense 服务调度器

    2. Qlik Logging Service

    3. Qlik Sense 存储库服务

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense 排程器服务

    7. Qlik Sense 打印服务

  3. 服务凭据窗口中,输入要用于运行 Qlik DataTransfer 服务的帐户的用户名和密码。

  4. 请参阅配置 Qlik DataTransfer以自定义 services.config 文件中的其他设置。

安装程序创建了桌面快捷方式,用于启动 Qlik DataTransfer 应用程序。

生成 API 密钥

API 密钥过期。默认过期时间可能不适合您的业务需要。在生成 API 密钥之前,请考虑更改 管理控制台 设置中的最大令牌过期时间。相关信息,请参阅在租户中启用 API 密钥

信息注释要生成 API 密钥需要许可证。

执行以下操作:

  1. 登录您的 Qlik Sense SaaS 租户。
  2. 在云应用中心内,于右上角单击您的简档图标,然后单击简档设置
  3. 选择 API 密钥
  4. 选择生成新的密钥

    云应用中心设置菜单,生成 API 密钥
  5. 输入API 密钥的名称并选择到期剩余时间
  6. 单击生成

    生成新的 API 密钥屏幕

  7. 单击复制并关闭将 API 复制到剪贴板。

    信息注释务必保存 API 密钥。您需要该密钥来验证 Qlik DataTransfer
    API 秘钥摘要屏幕

    现在您有了 API 密钥,可以在 Qlik DataTransferQlik Sense SaaS 租户之间创建安全连接。API 密钥用于在向租户上传数据时验证 Qlik DataTransfer。由于 API 有过期时间,因此您需要创建一个新的 API 密钥,并在该密钥过期时重新验证 Qlik DataTransfer。如果 API 密钥过期,则不需要重新创建数据连接。

验证 Qlik DataTransfer

执行以下操作:

  1. 打开 Qlik DataTransfer

    第一次打开 Qlik DataTransfer 时,将显示设置 Qlik DataTransfer 验证屏幕。

    Qlik dataTransfer API 秘钥连接屏幕
  2. 输入连接的名称。
  3. 输入指向 Qlik Sense SaaS 租户的 URL。
  4. 粘贴从租户生成的 API 密钥。

  5. 单击应用以验证租户。

  6. 当 API 密钥过期或对另一租户验证 Qlik DataTransfer 时,单击 以输入新的 API 密钥,然后单击确认

一旦验证了 Qlik DataTransfer,可以将本地数据上传至 Qlik Sense SaaS 租户。有关如何使用 Qlik DataTransfer 的信息,请参阅 通过 Qlik DataTransfer 上传本地数据

信息注释 如果在使用租户配置 Qlik DataTransfer 后更改服务登录帐户,则必须重新配置租户和到 ODBC 数据源的连接。

升级 Qlik DataTransfer

Qlik DataTransfer 在有新版本可用时显示通知横幅。Qlik DataTransfer 未自动升级至较新的版本。

警告注释

如果您为存储配置文件选择了不同的位置,或者从配置文件 Service.conf 选择了运行 Qlik DataTransfer 的不同端口,则升级将覆盖它。在升级之前备份 Service.conf 文件,并在升级完成后将其复制到默认配置文件夹以保留设置。

如果 Qlik DataTransfer 正在使用本地系统帐户,则不会提示您输入服务用户凭据并继续使用本地系统。

Qlik DataTransfer 升级横幅

执行以下操作:

  1. 从应用程序中横幅或 Qlik下载站点 下载站点下载 Qlik DataTransfer 的新版本。
  2. 关闭 Qlik DataTransfer 的当前版本。
  3. 运行 Qlik DataTransfer 安装程序。

    信息注释

    如果要在已安装 Qlik Sense Enterprise on Windows 的 Windows 服务器上安装 Qlik DataTransfer,则 Qlik DataTransfer 必须用 Qlik Sense 安装中使用的 Qlik Sense服务用户升级。

  4. 单击升级

    升级 QlikDataTransfer 窗口

卸载 Qlik DataTransfer

信息注释当卸载 Qlik DataTransfer 时,安装程序会移除所有 Qlik DataTransfer 文件和文件夹。您应当保存自己希望保存到新位置的任何文件或文件夹。

执行以下操作:

  1. 运行 Qlik DataTransfer 安装程序。

    信息注释

    如果您在同一服务器上安装了 Qlik 平台,则必须停止其他 Qlik 服务,然后才能卸载 Qlik DataTransfer

  2. 单击卸载
  3. 一旦卸载,如果适用,按以下顺序重新启动 Qlik 服务:

    1. Qlik Sense 服务调度器

    2. Qlik Logging Service

    3. Qlik Sense 存储库服务

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense 排程器服务

    7. Qlik Sense 打印服务

限制

Qlik DataTransfer 存在以下限制:

  • 从 October 2020 或更高版本升级时,存储配置文件的位置和用于运行 Qlik DataTransfer 的端口在配置文件 Service.conf 中更改为默认位置。如果未使用存储配置文件的默认位置或用于运行 Qlik DataTransfer 的默认端口,则将丢失这些设置。要保留您的设置,请在升级之前备份 Service.conf,并在升级完成后从备份文件中重做 Service.conf 中的设置。

  • 如果未使用默认位置在 Service.conf 中存储配置文件,则需要手动删除所选文件夹中的文件。