跳到主要内容 跳到补充内容

设置 Qlik Cloud 迁移工具

Qlik Cloud 迁移工具可帮助您规划和执行到 Qlik Cloud 的迁移。

下载并安装 Qlik Cloud 迁移工具

工具集中包括:

  • Qlik Sense 到 SaaS 迁移应用程序 - 用于管理迁移顺序和监控的 Qlik Sense 应用程序。

  • QlikView 到 SaaS 迁移应用程序 - 用于管理迁移顺序和监控的 QlikView 应用程序。利用 QlikView 管理仪表板

  • 迁移工作表 - 此 Microsoft Excel 电子表格用于收集用户、角色、安全规则、许可证、空间等的列表。

  • 迁移脚本 - 用在迁移到 Qlik Cloud 的流程中。

警告注释

这些工具为您的组织迁移到 Qlik Sense Enterprise SaaS 提供了一般指导。这些工具提供的信息是一般指南,任何针对您组织需求的 Qlik Sense Enterprise SaaS 迁移路径评估都需要额外的尽职调查。

工具提供的建议仅供参考,并不代表 Qlik 对最适合您业务需求和偏好的实际 Qlik Sense Enterprise SaaS 部署的保证或陈述。这些建议是基于客户提供的信息,客户提供的任何信息的不准确或更改都可能导致显著不同的评估和结果。如果 ESR 工具的使用结果与 Qlik 的标准文档之间存在任何冲突,应以 Qlik 标准文档的条款为准。

修订历史记录

下表总结了 Qlik Cloud 迁移工具的更改。

日期 注释
2022 年 5 月 10 日

初始版本

2022 年 7 月 12 日

更新的迁移应用程序

新迁移脚本

2022 年 10 月 20 日 错误修正
2023 年 3 月 7 日 迁移工作表已更新,以支持用户角色的更改
2023 年 6 月 29 日

添加了 QlikView 迁移的工具。

更新的迁移应用程序

新迁移脚本

2023 年 10 月 31 日

已修订 7_migrateapps.ps1。该脚本现在可以导入包含“工作表”、“书签”和“故事”的公共、社区和个人内容的应用程序,并自动分配给所有者。

对脚本进行了一些小的修订,以使用新的 qlik-cli 命令保持更新。

2023 年 11 月 28 日 用于容量模型分析的附加工作表。
2024 年 5 月 21 日

更新的迁移应用程序:

  • 添加了在有或没有云租户的情况下加载应用程序的功能。

  • 增加了限制向列出的数据流加载的功能。

2024 年 8 月 20 日 更新的迁移应用程序
2025 年 3 月 11 日 更新的迁移应用程序

下图显示了如何执行迁移,以及迁移工具如何帮助您将用户和资产移动到云。来自 Qlik Sense 客户端托管 的数据和来自 Qlik Cloud 的元数据被拉入迁移应用程序。迁移数据表保存到 CSV 文件中,并使用 qlik-cli 脚本导入 Qlik Cloud。然后重新加载迁移应用程序以反映迁移状态。对于要迁移的所有项目,此过程基本相同。

将数据从 Qlik Sense 客户端托管 迁移到 Qlik Cloud 的过程
迁移应用程序将连接到客户端管理的部署和云部署。

迁移脚本

使用迁移应用程序下载 .csv 元数据文件。这些脚本用于将客户端管理的资产导入云中。要了解更多信息,请参阅使用迁移脚本

信息注释为了能够运行脚本,您必须浏览到脚本所在的文件夹。脚本需要按顺序运行,因为它们之间存在依赖关系。

迁移准备

以下项目将有助于您的迁移,并提供推荐的工作程序。

  • 主题:计划您的朝向 Qlik Cloud 的迁移。评估和准备对于成功迁移至关重要。

  • Qlik Cloud 迁移工具 — Zip 文件,其中包含:

    • Qlik Cloud 迁移应用程序,用于管理迁移的顺序和监控。
    • 迁移工作表:Excel 文件。使用此电子表格收集用户、角色、安全规则、许可证、空间等的列表。
    • 用于将项目从 Qlik Sense 客户端托管 迁移到 Qlik Cloud 的迁移脚本。
  • qlik-cli:命令行界面 (CLI),可用于 Qlik Developer: qlik-cli

评估和规划后,执行以下操作:

  1. 设置迁移应用程序:将应用程序 SaaS Migration 1.x.qvf 导入 Qlik Management Console (QMC),设置 REST 连接器、修改加载脚本,然后重新加载应用程序。

  2. 查找租户的 ID。您可以在用户配置文件菜单的 Qlik Cloud关于下找到它。

  3. 配置迁移脚本。

  4. 创建标签并将其应用于应用程序和数据连接。

设置迁移应用程序

本节介绍如何导入迁移应用程序、创建API密钥和设置REST连接,以及修改应用程序中的加载脚本。要了解更多信息,请参阅设置迁移应用程序

 

导入迁移应用程序

执行以下操作:

  1. QMC 中,打开应用程序

  2. 单击搭配

  3. 导航到已下载的应用程序 SaaSMigration 1.x.qvf

  4. 单击搭配

该应用程序当前在应用中心中可用。

设置 REST 连接

信息注释要创建 API 密钥,您必须具有开发者角色。该角色在租户的 Administration 活动中心分配。

首先在云租户中创建 API 密钥。

执行以下操作:

  1. 在云租户的 Administration 活动中心中,打开 API 密钥

  2. 单击新生成

  3. 单击生成新密钥

  4. 输入密钥描述并设置密钥的有效期。

  5. 单击生成

  6. 复制 API 密钥并安全地将其存储。

下一步是在 Qlik Sense Enterprise on Windows 中配置 REST 连接器

执行以下操作:

  1. Qlik Sense Enterprise on Windows 中,创建新的数据连接并选择 REST 作为数据源。

    信息注释如果没有其他说明,请保留默认值。
  2. 按以下格式输入 URL:https://<tenant>.<region>.qlikcloud.com/api/v1/items

  3. 其他请求参数 > 查询头部分中,在名称字段中输入 Authorization,在字段中输入'Bearer',后跟前面生成的 API 密钥。注意 'Bearer ' 和 API 密钥之间的空格。

  4. 分页 > 分页类型部分,选择下一个 URL,并对“下一 URL”路径输入 root/links/next/href

  5. 输入连接名称,例如,REST for Qlik Cloud

  6. 单击创建

修改加载脚本

执行以下操作:

  1. Qlik Sense 应用中心中,打开应用程序 SaaSMigration 1.x.qvf

    将显示应用程序概述。

  2. 打开数据加载编辑器

  3. 打开**配置**部分。

  4. 在行 Set vu_tenant_fqdn 中,输入租户的完全限定域名。

    示例:Set vu_tenant_fqdn = 'my_tenant.eu.qlikcloud.com';

  5. Set vu_rest_connection_SaaS 行中,输入 Qlik Cloud 租户的 REST 连接的名称。

    示例:Set vu_rest_connection_SaaS = 'MyRESTConnection for SaaS';

  6. 在行 SET vu_central_node_host_name 中,输入中心节点主机名或计算机名。

    示例 1:SET vu_central_node_host_name = 'sense-central-node'

    示例 2:SET vu_central_node_host_name = 'my-central-node.domain.com'

  7. 如果虚拟代理具有前缀,则需要在行 SET vu_virtual_proxy_prefix = ''; 中输入该前缀
    示例:SET vu_virtual_proxy_prefix = 'my-virtual-proxy-prefix';

加载脚本修改示例

设置 qlik-cli 并配置迁移脚本

执行以下操作:

  1. 安装 qlik-cli,这是 Qlik Sense SaaS 的命令行界面。它通过命令行提供对所有公共 API 的访问,使编写新工作流和旧工作流的脚本和自动化更加容易。有关详细说明,请参阅qlik-cli 安装指南

  2. 确保 qlik.exe 位于 Windows 执行路径中。根据您安装 qlik cli 的方式,默认情况下,qlik.exe 可能不在 Windows 路径中。

  3. 按照 Qlik Cloud 身份验证设置中的步骤,配置与 Qlik Cloud 的连接。

  4. 配置到 Qlik Sense 客户端托管 的连接,请参阅 Qlik Sense:如何设置 JWT 身份验证

  5. 编辑 0_globals.ps1 并且设置上下文名称以用于:

    • $QlikSaaSContext

    • $tenantid

      您的 TenantID 位于您的用户简档 > 关于下。

    • $MIGRATIONFROM = “Qlik Sense”

    0_globals.ps1 的上下文名称配置

    PowerShell 中的上下文名称配置
信息注释脚本需要按 1 至 7 的顺序运行,因为它们之间存在依赖关系。例如,脚本 2_setspaces.ps1 假设运行脚本 1_setusers.ps1 后,用户已经在系统中。
提示注释要了解更多信息,请参阅设置和配置 Qlik CLI

创建和应用标签

向可以评估和标记应用程序和数据连接的人提供内容管理权限是不错的做法。

  1. QMC标记部分中为 Qlik Sense 客户端托管 创建以下标签:

    • Con 状态 - 05 已选择

    • Con 状态 - 10 已配置

    • Con 状态 - 20 已测试

    • Con 状态 - 30 已完成

    • Con 状态 - 99 非必需

    • Con 类型数据文件

    • Con 类型数据网关 - 数据访问

    • Con 类型原生连接器

    • 应用程序 - 05 经由多云迁移

    • 应用程序 - 05 指向 Qlik Sense Windows 的 URL 链接

    • 应用程序 - 10 已为迁移审核选择

    • 应用程序 - 20 需要迁移补救

    • 应用程序 - 30 准备好迁移

    • 应用程序 - 40 迁移完成

    • 应用程序 - 99 将不会迁移

  2. 评估应用程序和数据连接,并相应地应用标签。

  3. QMC 应用程序部分,选择具有相同标签的应用程序。

  4. 单击编辑并选择相应的标签。

可以一次迭代使用几种不同的应用程序类型,并在 SaaS 迁移应用程序的应用程序 SaaS 迁移状态工作表中查看迁移进度,请参阅迁移应用程序

Visit the discussion forum at community.qlik.com

本页面有帮助吗?

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