查看和修改 Looker (Google Cloud Core) 实例的详细信息

您可以在 Google Cloud 控制台中查找和修改项目的 Looker (Google Cloud Core) 实例的相关信息。

查看实例信息

与所选 Google Cloud 项目关联的 Looker (Google Cloud Core) 实例会列在 Google Cloud 控制台的实例页面上，包括贵组织中其他用户创建的实例。

所需角色

如需查看实例页面上的信息，您必须拥有 Looker Admin (roles/looker.admin) 或 Looker Viewer (roles/looker.viewer) 角色。

您或许还可通过自定义角色或其他预定义角色获取此权限。

“实例”页面

实例页面会显示各实例的以下信息：

  • 状态：
    • 如果实例已成功创建且处于活跃状态，则会显示一个带对勾标记的绿色圆圈。
    • 如果实例正在创建中，系统会显示加载图标。
  • 名称：创建实例时，由实例创建者提供的实例的名称。点击该名称可转到详细信息标签页，其中会显示有关所选实例的更多信息。

  • 实例网址：可以访问使用公共 IP 的实例的网址。默认情况下，实例网址采用 https://hostname.looker.app 格式，其中主机名是随机分配的。点击网址以导航到实例。

  • 版本：在实例上运行的 Looker 版本。

  • 区域：托管实例的区域。

  • 创建日期：创建实例的日期。

实例标签页

在实例页面中，点击实例名称以查看该实例的更多信息。点击该名称后，系统会显示一个实例配置页面，其中包含以下标签页中的信息：

详情标签页

详情标签页显示了其他实例元数据：

  • 平台版本：实例的版本。选项包括标准、企业版和嵌入。
  • 创建时间：创建实例的时间。
  • 更新时间：实例最近更新的时间。
  • 已启用公共 IP：是否为公共 IP 启用实例的网络连接。如果已启用，则会显示 true。如果未启用，则显示 false。
  • 已启用专用 IP：是否对实例的网络连接启用了专用 IP。如果已启用，则会显示 true。如果未启用，则显示 false。
  • 出站流量公共 IP：出站流量公共 IP 地址，在创建实例时自动分配（适用于使用公共 IP 网络连接的实例）。如果未分配值，系统会显示无值。
  • 入站流量公共 IP：入站流量公共 IP 地址，在创建实例时自动分配（适用于具有公共 IP 网络连接的实例）。
  • 入站流量专用 IP：创建实例时指定的入站流量专用 IP 地址（适用于具有专用 IP 网络连接的实例）。如果实例是通过公共 IP 网络连接创建的，则会显示无值。
  • Associated Network：选择用于建立专用连接的网络（适用于具有专用 IP 网络连接的实例）。如果实例是通过公共 IP 网络连接创建的，则会显示无值。
  • 分配的 IP 范围：创建实例时由实例创建者或 Google 分配的 IP 地址范围（适用于使用专用 IP 网络连接的实例）。如果实例是通过公共 IP 网络连接创建的，则会显示无值。
  • 维护窗口：Looker (Google Cloud Core) 安排维护的时段和时段（如果已为您的实例定义了维护窗口）。维护窗口会持续一小时。如果维护窗口未定义，系统会显示无值。
  • 计划维护：即将对您的实例进行维护的计划日期和时间。如果尚未安排维护，系统会显示无值。
  • 拒绝维护期：如果您已为自己的实例配置了拒绝维护期，Looker (Google Cloud Core) 不会安排维护的时间段。
    • 开始日期：拒绝维护期的开始日期。如果尚未安排拒绝维护期，系统会显示无值。
    • 结束日期：拒绝维护期的结束日期。如果尚未安排拒绝维护期，系统会显示无值。
    • 时间：拒绝维护期的开始和结束时间，在您指定的开始日期和结束日期。如果尚未安排拒绝维护期，系统会显示无值。
  • 上一个拒绝维护期：最近一次拒绝维护期的开始日期和结束日期。您必须在任意两个拒绝维护期之间至少留出 14 天的维护时间。
    • 开始日期：最近一次拒绝维护期的开始日期。如果之前未安排拒绝维护期，系统会显示无值。
    • 结束日期：拒绝维护期的结束日期。如果之前未安排拒绝维护期，系统会显示无值。
    • 时间：前一个拒绝维护期开始和结束的时间，在该拒绝维护期的开始日期和结束日期。如果之前未安排拒绝维护期，系统会显示无值。
  • 加密：Looker (Google Cloud Core) 实例的加密类型。如果实例是使用默认 Google 管理的加密创建的，则会显示 Google 管理的加密密钥。如果实例是使用 CMEK 创建的，则系统会显示客户管理的加密密钥 (CMEK)，以及密钥标识符和指向相应密钥的链接。您可能需要对正在使用的密钥拥有 Cloud KMS IAM 角色或权限，才能查看 CMEK 加密密钥的状态。
  • 电子邮件网域许可名单：电子邮件网域许可名单设置定义了 Looker (Google Cloud Core) 用户可以通过电子邮件将 Looker 内容传送到哪些电子邮件网域，包括Looks、信息中心、含可视化图表的查询或提醒通知。默认情况下，在创建实例时，许可名单中没有任何网域，并且具有可通过电子邮件发送内容所需的相应 Looker 权限的 Looker (Google Cloud Core) 用户可以将内容通过电子邮件发送到任何网域。如需限制向特定网域中的电子邮件地址发送内容并接收提醒通知，请修改实例配置，限定用户可以向哪些网域发送电子邮件。

自定义网域标签页

自定义网域标签页提供自定义网址（可选），以便使用自定义网域访问实例。

Looker Studio Pro 标签页

在 Looker Studio Pro 标签页中，您可以接受已分配给您的 Looker (Google Cloud Core) 实例的免费 Looker Studio Pro 许可。如果接受 Looker Studio Pro 许可切换开关处于启用状态，则表示您已接受免费许可。

此标签页还指明了托管 Looker Studio Pro 订阅内容的 Google Cloud 项目的名称。

修改 Looker (Google Cloud Core) 实例设置

所需角色

如需获取修改 Looker (Google Cloud Core) 实例设置所需的权限， 请让管理员授予您 Looker Admin (roles/looker.admin) IAM 角色，该角色针对创建了实例的项目的项目。 如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

修改设置

如需修改实例设置，请选择以下选项之一：

控制台

在实例详细信息标签页上，点击修改以修改以下设置：

  • OAuth 应用凭据：在修改此设置之前，请务必设置新凭据，并将实例的网域添加到 OAuth 客户端中的已获授权的重定向 URI 字段。

  • 网络连接：您的实例配置必须指定网络连接。如果您为实例的网络连接同时选择了公共 IP 和专用 IP，则只能停用公共 IP 选项。创建实例后，您无法将网络连接从公共 IP 更改为专用 IP，或者从专用 IP 更改为公共 IP。

  • 维护窗口：您可以视需要指定 Looker (Google Cloud Core) 安排维护的时间（星期几和时段）。维护窗口会持续一小时。默认情况下，维护窗口中的首选时段选项会设置为任意时段。

  • 拒绝维护期：您可以视需要指定 Looker (Google Cloud Core) 不安排维护的时间段。拒绝维护期最长可达 60 天。在拒绝维护窗口之间，您必须至少留出 14 天的维护时间，

  • 电子邮件网域许可名单：如果电子邮件网域许可名单中没有网域，则电子邮件网域不受限制。要限制网域，请以 domain.suffix 格式输入允许的网域，然后点击键盘上的 Enter 键。如果您对实例的电子邮件网域许可名单进行更改，则 Looker (Google Cloud Core) 实例必须重启；如果实例中有任何正在运行的永久性派生表，这些表也会重新生成。

完成更改后，点击保存。

gcloud


gcloud looker instances update (INSTANCE_NAME : --region=REGION)
    [--allowed-email-domains=[ALLOWED_EMAIL_DOMAINS,...]] [--async]
    [--oauth-client-id=OAUTH_CLIENT_ID]
    [--oauth-client-secret=OAUTH_CLIENT_SECRET] [--public-ip-enabled]
    [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
      --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
      --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME]
    [--maintenance-window-day=MAINTENANCE_WINDOW_DAY
      --maintenance-window-time=MAINTENANCE_WINDOW_TIME]

替换以下内容：

  • INSTANCE_NAME：您的 Looker (Google Cloud Core) 实例的名称；它未与实例网址相关联。
  • REGION：托管您的 Looker (Google Cloud Core) 实例的区域。
  • ALLOWED_EMAIL_DOMAINS：当 --allowed-email-domains 中没有网域时，电子邮件网域不受限制。要限制网域，请按照 domain.suffix 格式添加要允许的网域。如果您对某个实例允许的电子邮件域名进行更改，则 Looker (Google Cloud Core) 实例必须重启；如果实例中有任何正在运行的永久性派生表，这些表也会重新生成。
  • OAUTH_CLIENT_ID 和 OAUTH_CLIENT_SECRET：您使用 OAuth 客户端设置的 OAuth 客户端 ID 和 OAuth 密钥。
  • DENY_MAINTENANCE_PERIOD_START_DATE 和 DENY_MAINTENANCE_PERIOD_END_DATE：必须采用 YYYY-MM-DD 格式。
  • MAINTENANCE_WINDOW_TIME 和 DENY_MAINTENANCE_PERIOD_TIME：必须采用 24 小时制 UTC 时间（例如 13:00, 17:45）。
  • MAINTENANCE_WINDOW_DAY：必须是以下各项之一：friday、monday、saturday、sunday、thursday、tuesday、wednesday。如需详细了解维护窗口设置，请参阅管理 Looker (Google Cloud Core) 的维护政策文档页面。

您还可以添加以下标记：

  • --public-ip-enabled 启用公共 IP。
  • --no-public-ip-enabled 会停用公共 IP。

如果您为实例的网络连接同时选择了公共 IP 和专用 IP，则只能停用公共 IP 选项。创建实例后，您无法将网络连接从公共 IP 更改为专用 IP，也无法从专用 IP 更改为公共 IP。

在更新 OAuth 凭据之前，请务必设置新凭据，并将实例的网域添加到 OAuth 客户端中的已获授权的重定向 URI 字段。

后续步骤