设置 Qlik Cloud 访问
上次更新日期:2026/10/14在部署到 Qlik Cloud 之前,租户管理员必须启用 API 密钥生成并为用户帐户分配正确的角色。
启用 API 密钥访问
执行以下操作:
- 在“管理”活动中心,转到 管理用户 > 权限。
- 创建自定义角色(例如,API 密钥管理器)。
- 展开 功能和操作 > 开发者 并将 管理 API 密钥 设置为
Allowed。 - 保存角色。
- 前往用户,并将该角色分配给需要 API 访问权限的用户。
- 如果用户拥有已弃用的开发者角色,请移除该角色。
分配角色后,每个用户都可以生成 API 密钥。
要生成 API 密钥,请前往 个人资料 > API 密钥,然后点击 生成新密钥。复制并安全地存储密钥。密钥仅显示一次。
在个人空间中启用应用程序创建
要在个人空间中创建应用程序,需要私人分析内容创建者角色。
执行以下操作:
- 在管理控制台,转到用户。
- 将 私有分析内容创建者 角色分配给用户。
当部署到共享空间而非个人空间时,用户必须拥有目标空间上的可编辑权限。
内联身份验证
当同时提供 --qlikTenantUrl 和 --qlikApiKey 时(或等效的 环境 变量 QV2QS_QLIK_TENANT_URL 和 QV2QS_QLIK_API_KEY),QV2QS 会直接进行身份验证,而无需创建或读取 qlik-cli 上下文文件。API 密钥作为持有者令牌注入到每个 qlik-cli 调用中,并且不写入磁盘。
这种方法推荐用于:
- CI/CD 流水线,其中预先创建上下文会增加一个额外的步骤。
- 多租户自动化,其中多个并发调用针对不同的租户。每个进程都在内存中携带自己的凭据,因此没有共享的上下文文件会发生冲突。
- 合作伙伴集成,它们以编程方式调用 QV2QS,并且每次请求使用不同的凭据。
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output ^
--qlikTenantUrl https://my-tenant.us.qlikcloud.com ^
--qlikApiKey eyJhbG... ^
--qsAppName "Sales" --autoBinary --reload --plain
信息注释
当同时提供 --qlikTenantUrl 和 --qlikApiKey 时,--setupQlikAuth 标志不是必需的。