为 Looker (Google Cloud Core) 实例接受免费数据洞察 Pro 许可

注意： Looker（原始）实例也可使用免费的数据洞察 Pro 许可。如需了解如何为 Looker（原始版本）实例接受免费数据洞察 Pro 许可，请参阅管理员设置 - 数据洞察 Pro。

重要提示： 对于在 2026 年 8 月 1 日之后创建的 Looker (Google Cloud Core) 实例，无法使用免费数据洞察 Pro 许可。

作为 Looker 客户，您可以根据 Looker 协议获得免费的数据洞察 Pro 许可。如需开始使用数据洞察 Pro，您必须设置订阅、接受免费许可并将其分配给用户。

您的 Looker 协议决定了分配给您的 Looker 账号的免费数据洞察 Pro 许可数量。如需详细了解此优惠的条款，请参阅免费数据洞察 Pro 许可优惠详情。

本文档介绍了如何为 Looker 实例执行以下任务：

1. 接受免费的数据洞察 Pro 许可
2. 选择一个 Google Cloud 项目来托管您的订阅
3. 向数据洞察 Pro 订阅添加用户
4. 将免费许可转移到其他订阅

准备工作

重要提示： Looker 账号通过托管数据洞察 Pro 内容的 Google Cloud 项目与数据洞察 Pro 订阅相关联。建议您专门使用一个 Google Cloud 项目来托管数据洞察 Pro 内容，并在接受免费许可时指明此项目。

如果您尚未订阅数据洞察 Pro，建议您在接受账号分配的免费许可之前，先为数据洞察内容设置 Google Cloud 项目。如需详细了解 Google Cloud 项目要求和设置新的数据洞察 Pro 订阅，请参阅开始新的 Pro 订阅文档页面。

每个拥有 Looker Viewer (roles/looker.viewer) 角色且使用数据洞察 Pro 的用户还必须是拥有受管理的 Google 账号的 Google Workspace 或 Cloud Identity 用户。

每个 Looker (Google Cloud Core) 实例只能与一个数据洞察 Pro 订阅相关联。

所需的角色

您需要不同的权限才能执行以下任务：

• 接受免费数据洞察 Pro 许可
• 设置数据洞察 Pro 的自助订阅

如需获得接受免费数据洞察 Pro 许可和更新 Looker (Google Cloud Core) 实例信息的权限，请让管理员为您授予一个 IAM 角色，该角色包含 Looker (Google Cloud Core) 实例所在的 Google Cloud 项目的 looker.instances.update 权限。Looker Admin (roles/looker.admin) IAM 角色默认包含此权限，但您也可以通过自定义角色或其他预定义角色获取此权限。如需获得设置数据洞察 Pro 自助订阅的权限，请让管理员为您授予一个 IAM 角色，该角色包含 Looker (Google Cloud Core) 实例所在 Google Cloud 项目的 lookerstudio.pro.manage 权限。Looker Studio Pro Manager (roles/lookerstudio.proManager) 和 Owner (roles/owner) IAM 角色默认包含此权限，但您也可以通过自定义角色或其他预定义角色获得此权限。

接受数据洞察 Pro 许可

默认情况下，Looker (Google Cloud Core) 实例包含 50 个免费数据洞察 Pro 许可。

如需接受这些许可，请在 Google Cloud 控制台或 Google Cloud CLI 中按照以下步骤操作：

控制台

1. 前往 Looker (Google Cloud Core) 实例所在的 Google Cloud 项目的实例页面。
2. 选择要与数据洞察 Pro 搭配使用的 Looker (Google Cloud Core) 实例的名称。
3. 选择数据洞察 Pro 标签页。如果您的 Looker (Google Cloud Core) 实例是在 2026 年 8 月 1 日之后创建的，则此标签页不可见。
4. 选择接受数据洞察 Pro 许可。

gcloud

借助 Google Cloud CLI，您可以使用 --linked-lsp-project-number 标志一步接受免费数据洞察 Pro 许可并关联数据洞察 Pro Google Cloud 项目。继续执行选择 Google Cloud 项目，然后按照 gcloud 说明操作。

接受这些免费许可，即表示您同意Google Cloud 服务条款。使用数据洞察 Pro（即使连接到 Looker）时须遵守 Google Cloud的使用协议，而非您的 Looker 协议。

选择一个 Google Cloud 项目

接受免费数据洞察 Pro 许可后，您必须将 Looker (Google Cloud Core) 实例与数据洞察 Pro 订阅使用的Google Cloud 项目相关联。您可以使用 Google Cloud 控制台或 Google Cloud CLI 指定数据洞察 ProGoogle Cloud 项目：

控制台

在 Looker (Google Cloud Core) 实例设置的数据洞察 Pro 标签页中，按照以下步骤操作：

1. 点击选择项目。
2. 在选择资源对话框中，从列表中选择您的项目，然后点击选择项目。
3. 在 Looker (Google Cloud Core) 实例设置的数据洞察 Pro 标签页中，点击保存。

项目名称字段现在会显示所选 Google Cloud项目 ID。

gcloud

1. 获取托管数据洞察 Pro 订阅的 Google Cloud 项目的项目编号：

   gcloud projects describe DSP_PROJECT_ID \
       --format="value(projectNumber)"
   

   将 DSP_PROJECT_ID 替换为托管您的数据洞察 Pro 订阅的 Google Cloud 项目的项目 ID。此项目必须与 Looker (Google Cloud Core) 实例属于同一 Google Cloud 组织。

2. 接受免费许可，并将数据洞察 Pro 项目关联到您的 Looker (Google Cloud Core) 实例：

   gcloud looker instances update INSTANCE_NAME \
       --project=PROJECT_ID \
       --region=REGION \
       --linked-lsp-project-number=DSP_PROJECT_NUMBER
   

   替换以下内容：

   • INSTANCE_NAME：Looker (Google Cloud Core) 实例的名称。
   • PROJECT_ID：托管 Looker（Google Cloud 核心）实例的Google Cloud 项目的项目 ID。
   • REGION：Looker (Google Cloud Core) 实例所在的区域。
   • DSP_PROJECT_NUMBER：您的数据洞察 Pro Google Cloud 项目的项目编号。

3. 验证您的 Looker (Google Cloud Core) 实例是否已关联到数据洞察 Pro 项目：

   gcloud looker instances describe INSTANCE_NAME \
       --project=PROJECT_ID \
       --region=REGION \
       --format="value(linkedLspProjectNumber)"
   

注意：保存项目后，请注意以下影响：

• 仅更改项目编号不会将您的免费许可转移到其他项目。您必须在数据洞察 Pro 订阅设置中转移许可。
• 如果您不想再将 Looker (Google Cloud Core) 实例关联到数据洞察 Pro 项目，请参阅从实例中解除免费数据洞察 Pro 许可的关联。

向数据洞察 Pro 订阅添加用户

如需完成新数据洞察 Pro 订阅的设置，请向订阅添加用户并为其分配许可。您可以在 Google Cloud 控制台或数据洞察中完成这些步骤。如果您在接受免费许可之前已完成数据洞察 Pro 订阅的设置，则您的许可已自动应用于现有的数据洞察 Pro 用户。

控制台

如需在 Google Cloud 控制台中完成新的数据洞察 Pro 订阅设置，请按以下步骤操作：

1. 在 Google Cloud 控制台中打开数据洞察 Pro 首页，方法是点击 Looker 实例的数据洞察 Pro 页面或标签页上的添加用户，或者直接前往关联的 Google Cloud 项目的 Google Cloud 控制台中的数据洞察页面。
2. 点击订阅，打开购买数据洞察 Pro 许可面板：
   
   • 当前免费 Pro 许可订单项会显示已分配给 Looker (Google Cloud Core) 实例的免费数据洞察 Pro 许可数量。
3. 在添加用户 / 群组字段中，将用户或群组的邮箱添加到您的订阅中。
   • 许可总数字段会显示支持您添加的用户数量所需的许可总数。
   • 选择为添加到群组的新用户自动分配许可，以便为添加到数据洞察订阅下的 Google 群组的用户分配可用许可。
4. 点击购买。

注意：如果您添加的用户数量超过了分配给 Looker 实例的免费数据洞察 Pro 许可数量，每月总费用订单项会显示您购买的额外许可的费用。

数据洞察

如需在数据洞察中完成新的数据洞察 Pro 订阅设置，请按以下步骤操作：

1. 打开数据洞察（或在 Looker 实例的数据洞察 Pro 页面或标签页中点击在数据洞察 Pro 中添加用户）。
2. 按照向订阅添加用户文档页面中所述的步骤，向订阅添加用户。

移除许可或用户

每位数据洞察 Pro 用户都需要一个数据洞察 Pro 许可。如果您需要减少数据洞察 Pro 订阅使用的许可数量，则还需要移除相应数量的用户。

如需在 Google Cloud 控制台中从数据洞察 Pro 订阅中移除许可和用户，请按以下步骤操作：

1. 在托管数据洞察 Pro 订阅内容的 Google Cloud 项目中，前往数据洞察页面。
2. 选择管理访问权限。
3. 选择要从订阅中移除的用户或群组。
4. 选择删除 删除。在随即显示的对话框中，再次选择删除。
5. 关闭管理访问权限窗口。
6. 选择添加 / 移除许可。
7. 在许可总数字段旁边，选择移除 减少许可数量，以减少数据洞察 Pro 订阅下的许可数量。
8. 选择确认。

如需了解详情，请参阅从 Pro 订阅中移除用户。

将免费数据洞察 Pro 许可转移到其他订阅

在 Looker 实例中保存为数据洞察 Pro 许可选择的项目后，我们强烈建议您不要修改所选项目。您的免费许可必须与您的数据洞察 Pro 订阅关联到同一 Google Cloud 项目。如果您需要将许可从一个数据洞察 Pro 订阅转移到另一个订阅，请按以下步骤操作：

1. 基于其他项目设置新的数据洞察 Pro 订阅。
2. 向新订阅添加用户。
3. 为与旧订阅关联的团队工作区中任何“无主”内容转移所有权。
4. 取消旧订阅。

接下来，如需将您的免费数据洞察 Pro 许可与新的数据洞察 Pro 订阅相关联，请按以下步骤操作：

控制台

1. 前往 Looker (Google Cloud Core) 实例设置的数据洞察 Pro 标签页。
2. 点击选择项目。
3. 在选择资源对话框中，从列表中选择新选项，然后点击选择项目。
4. 选择与新数据洞察 Pro 订阅关联的 Google Cloud 项目。
5. 在 Looker (Google Cloud Core) 实例设置的数据洞察 Pro 标签页中，点击保存。

项目名称字段现在会显示与新数据洞察 Pro 订阅关联的 Google Cloud 项目 ID。

gcloud

1. 获取与新数据洞察 Pro 订阅关联的 Google Cloud 项目的项目编号：

   gcloud projects describe NEW_DSP_PROJECT_ID \
       --format="value(projectNumber)"
   

   将 NEW_DSP_PROJECT_ID 替换为 Google Cloud 托管新数据洞察 Pro 订阅的项目的 ID。

2. 更新 Looker (Google Cloud Core) 实例以关联新项目：

   gcloud looker instances update INSTANCE_NAME \
       --project=PROJECT_ID \
       --region=REGION \
       --linked-lsp-project-number=NEW_DSP_PROJECT_NUMBER
   

   替换以下内容：

   • INSTANCE_NAME：Looker (Google Cloud Core) 实例的名称。
   • PROJECT_ID：托管 Looker（Google Cloud 核心）实例的Google Cloud 项目的项目 ID。
   • REGION：Looker (Google Cloud Core) 实例所在的区域。
   • NEW_DSP_PROJECT_NUMBER：上一步中的项目编号。

3. 验证您的 Looker (Google Cloud Core) 实例是否已关联到新项目：

   gcloud looker instances describe INSTANCE_NAME \
       --project=PROJECT_ID \
       --region=REGION \
       --format="value(linkedLspProjectNumber)"
   

重要提示： Google Cloud 会自动将免费许可应用于新数据洞察 Pro 订阅中的用户。如果新订阅中的用户数量少于旧订阅中的用户数量，则一些未使用的免费许可仍会附加到旧的数据洞察 Pro 订阅。 Google Cloud 会将这些未使用的许可转换为付费许可，并按照数据洞察 Pro 价格收费。为避免产生费用，请取消旧订阅。

解除免费数据洞察 Pro 许可与实例的关联

如果您不想再将 Looker (Google Cloud Core) 实例关联到数据洞察 Pro Google Cloud 项目，可以使用 Google Cloud 控制台或 Google Cloud CLI 解除项目关联。

警告：如果您将数据洞察 Pro 项目与 Looker (Google Cloud Core) 实例解除关联，您的免费数据洞察 Pro 许可将变为付费许可，并需遵守 数据洞察 Pro 价格。此转换通常会在 24 小时内完成。如果您不想再使用免费许可，建议您取消关联的数据洞察 Pro 订阅。如需详细了解取消数据洞察订阅后会发生什么情况，请参阅取消数据洞察 Pro 订阅的影响。

控制台

1. 在 Looker (Google Cloud Core) 实例设置的数据洞察 Pro 标签页中，停用接受数据洞察 Pro 许可切换开关。
2. 点击保存。

gcloud

1. 通过将 --linked-lsp-project-number 标志设置为 0，解除数据洞察 Pro 项目与 Looker (Google Cloud Core) 实例的关联：

   gcloud looker instances update INSTANCE_NAME \
       --project=PROJECT_ID \
       --region=REGION \
       --linked-lsp-project-number=0
   

   替换以下内容：

   • INSTANCE_NAME：Looker (Google Cloud Core) 实例的名称。
   • PROJECT_ID：托管 Looker（Google Cloud 核心）实例的Google Cloud 项目的项目 ID。
   • REGION：Looker (Google Cloud Core) 实例所在的区域。

2. 验证数据洞察 Pro 项目是否已解除关联：

   gcloud looker instances describe INSTANCE_NAME \
       --project=PROJECT_ID \
       --region=REGION \
       --format="value(linkedLspProjectNumber)"
   

   解除项目关联后，该命令会返回空输出。

取消数据洞察 Pro 订阅的影响

如果数据洞察 Pro 订阅被取消，Looker 将不再识别该订阅。虽然 Google Cloud 控制台仍会显示 Looker 实例和数据洞察 Pro 订阅已关联，但您无需再为 Google Cloud 项目中的数据洞察 Pro 用量付费。如果您恢复订阅（在 30 天宽限期内）或发起新订阅，您的 Looker 实例的数据洞察 Pro 许可仍然可用。您也可以使用免费版数据洞察。

如需详细了解取消数据洞察 Pro 订阅或删除与已取消订阅关联的 Google Cloud 项目会产生哪些影响，请参阅取消数据洞察 Pro 订阅。

免费许可问题排查

注意： 通过支持团队请求的手动许可数量调整通常需要 7 到 10 个工作日才能完全反映在您的数据洞察 Pro 订阅中。

在接受免费数据洞察 Pro 许可或向数据洞察 Pro 订阅添加用户时，可能会出现错误。请参阅下表，了解如何排查与接受许可相关的错误。

出错提示	解决步骤	示例
You have reached your license limit. To add more users, either delete some existing users/groups or purchase additional licenses.	在数据洞察中，从左侧导航栏中选择 Pro 订阅，打开数据洞察 Pro 订阅列表。 数据洞察会显示托管 Looker (Google Cloud Core) 实例的 Google Cloud 项目可用的免费许可数量。在操作下，为该项目选择管理订阅。 前往查看并确认数据洞察 Pro 许可步骤，然后在要购买的许可数量字段中查看许可数量。 输入您要使用的许可总数，包括订阅可用的免费许可数量。	如果有 10 个免费许可可用，请向您的订阅添加 10 位用户，以使用所有许可。如果您添加 11 位用户，则需要为 1 个额外许可付费。如果您将要购买的许可数量字段中的值增加到 11，则需要支付 1 个额外许可的费用，您可以在日后分配该许可。