查看和修改 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) 角色。

您也可以使用自定义角色或其他预定义角色来获取此权限。

“实例”页面

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

  • 状态：
    • 如果实例已成功创建并处于有效状态，系统会显示一个带对勾标记的绿色圆圈。
    • 如果实例创建正在进行中，系统会显示一个加载图标。
  • 名称：实例创建者在创建实例时提供的实例名称。点击该名称可前往详细信息标签页，其中会显示所选实例的其他信息。

  • 实例网址：可用于访问使用公共安全连接的实例的网址。默认情况下，实例网址采用 https://hostname.looker.app 格式，其中主机名是随机分配的。点击相应网址即可前往实例。

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

  • 区域：实例所在的区域。

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

实例标签页

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

详细信息标签页

详细信息标签页会显示其他实例元数据：

  • 平台版本：实例的版本。选项包括标准版、企业版和嵌入版。
  • 发布渠道：实例的发布渠道。选项包括快速、常规和无渠道。此功能处于预览阶段。
  • 创建时间：实例的创建时间。
  • 更新时间：实例最近一次更新的时间。
  • 已启用公共 IP：实例的网络连接是否已启用公共安全连接。如果已启用，则会显示 true。如果未启用，则会显示 false。
  • 已启用专用 IP：实例的网络连接是否已启用专用连接（专用服务访问通道）连接。如果已启用，则会显示 true。如果未启用，则显示 false。如果实例的网络连接使用 Private Service Connect，此设置会显示 false。
  • 已启用 PSC：实例的网络连接是否已启用 Private Service Connect。如果已启用，则显示 true。如果未启用，则显示 false。

  • PSC 配置：如果已启用 PSC 为 true，则会显示此设置以及以下子设置：

    • Looker 服务连接 URI：此设置会显示 Looker (Google Cloud Core) 的 Private Service Connect 服务连接的 URI。
    • 允许的 VPC：此设置包含已授权北向访问 Private Service Connect 实例的 VPC 的列表。

    • PSC 端点：如果 Looker (Google Cloud Core) 实例使用 Private Service Connect 建立与已发布服务的出站（出口）连接，则会显示此设置。您可以使用以下子设置：

      • 本地 FQDN：实例连接到的已发布服务的完全限定域名。
      • 目标服务连接 URI：Looker (Google Cloud Core) 实例要连接到的已发布服务的服务连接 URI。

      • 连接状态：连接的状态，可以是以下状态之一：

        • ACCEPTED：连接已建立且正常运行。
        • PENDING：连接未建立（Looker 租户项目未列入许可清单）。
        • 需要注意：目标服务连接存在问题，例如 NAT 子网已用尽。
        • REJECTED：未建立连接（Looker 租户项目明确位于拒绝列表中）。
        • CLOSED：目标服务连接不存在，或缺少前提条件，例如代理专用子网的 Cloud NAT、TCP 健康检查，或服务连接许可清单中的 Looker 租户项目 ID。此状态为终止状态。如果连接状态达到 CLOSED，您必须使用 --psc-service-attachment 标志重新运行 gcloud looker instances update 命令，以强制 Looker (Google Cloud Core) 重新触发连接尝试。
        • UNKNOWN：未指定连接状态。

    • 受控出站流量已启用：如果 Looker (Google Cloud Core) 实例使用 HTTPS 协议连接到 Looker Marketplace 或具有全局 FQDN 的外部服务，则此字段会显示 true。否则，该字段会显示 false。

    • 受控出站流量配置：如果已启用与 Looker Marketplace 或全局 FQDN 的连接，则会显示此部分。系统会显示以下字段：

      • Marketplace Enabled：如果已创建到 Looker Marketplace 的出站连接，此字段会显示 true；否则，会显示 false。
      • 出站 FQDN：此字段显示已设置出站连接的任何全局 FQDN 的完全限定域名。
      • 出站流量 IP：此字段显示启用受控出站流量时用于互联网出站流量的 IP 地址。这些 IP 地址对于您的 Looker (Google Cloud Core) 实例是唯一的。这些 IP 地址是动态的，可能会在不发出警告的情况下发生变化。

  • IP 许可名单配置：对于使用公共安全连接的实例，系统会显示 IP 许可名单配置部分。系统会显示以下子设置：

    • IP 许可清单已启用：如果在实例的修改页面上选中了启用 IP 许可清单复选框，则此字段会显示 true。如果未启用该复选框，此字段会显示 false。
    • Google Services Enabled：如果在实例的修改页面上选中了将 Google 服务与此实例关联复选框，则此字段会显示 true。
    • IP 许可清单规则：每条许可清单规则都会在此部分中显示为可展开或可收起的项。每个项都包含一个说明字段（即规则的名称）和一个 IP 范围字段（即规则的 IP 范围）。

  • 出站公共 IP：此字段提供有关具有公共安全连接的实例的信息。它显示了在创建实例时自动分配的出站公共 IP 地址。如果未分配任何值，则会显示无值。

  • 入站流量公共 IP：此字段提供有关具有公共安全连接的实例的信息。其中显示了入站流量公共 IP 地址，该地址是在创建实例时自动分配的。

  • 入站专用 IP：此字段提供有关使用专用服务访问通道的专用连接实例的信息。显示实例的入站专用 IP 地址。如果实例是使用公共安全连接或 Private Service Connect 创建的，则会显示无值。

  • 关联的网络：此字段提供有关使用专用服务访问通道建立专用连接的实例的信息。其中显示了为建立专用连接而选择的网络。如果实例是使用公共安全连接创建的，则会显示无值。

  • 分配的 IP 范围：此字段提供有关使用专用服务访问通道的专用连接实例的信息。它会显示实例创建者或 Google 在创建实例时分配的 IP 地址范围。如果实例是使用 Private Service Connect 或公共安全连接创建的，则会显示无值。

  • 电子邮件网域许可清单：电子邮件网域许可清单设置会显示 Looker (Google Cloud Core) 用户可以通过电子邮件传送 Looker 内容（Look、信息中心、包含可视化图表的查询）或提醒通知的电子邮件网域。默认情况下，在创建实例时，许可清单中没有任何网域，并且具有相应 Looker 权限的 Looker (Google Cloud Core) 用户可以通过电子邮件发送内容，可以将内容发送到任何网域。若要将内容传送和提醒通知发送到特定网域中的电子邮件地址，请修改实例配置，以限制用户可以向哪些网域发送电子邮件。如需详细了解电子邮件网域许可清单以及它如何与权限和用户属性交互，请参阅用于定时发送内容的电子邮件网域许可清单文档。

  • 维护窗口：Looker (Google Cloud Core) 安排维护的星期几和时间（如果已为实例定义维护窗口）。维护窗口持续一小时。如果未定义维护窗口，则会显示无值。

  • 计划性维护：实例即将进行维护的计划日期和时间。如果尚未安排维护，则会显示无值。

  • 拒绝维护期：如果已为实例配置拒绝维护期，则 Looker (Google Cloud Core) 不会在该时间段内安排维护。

    • 开始日期：拒绝维护期的开始日期。如果尚未安排拒绝维护期，则会显示无值。
    • 结束日期：拒绝维护期的结束日期。如果未安排拒绝维护期，则会显示无值。
    • 时间：拒绝维护期在您指定的开始日期和结束日期开始和结束的时间。如果未安排拒绝维护期，则会显示无值。

  • 上一个拒绝维护期：最近一个拒绝维护期的开始日期和结束日期。您必须在任意两个拒绝维护期之间至少留出 14 天允许维护时间。

    • 开始日期：最近一次拒绝维护期的开始日期。如果之前未安排拒绝维护期，则会显示无值。
    • 结束日期：拒绝维护期的结束日期。如果之前未安排拒绝维护期，则会显示无值。
    • 时间：上一个拒绝维护期在相应拒绝维护期的开始日期和结束日期开始和结束的时间。如果之前未安排拒绝维护期，则会显示无值。

  • 加密：仅当实例是使用 CMEK 创建时，此设置才会显示。如果此元素可见，则会显示“客户管理的加密密钥 (CMEK)”，以及密钥标识符和指向密钥的链接。如果实例使用默认的 Google 管理的加密，则不会显示此字段。您可能需要对正在使用的密钥拥有 Cloud KMS IAM 角色或权限，才能查看 CMEK 加密密钥的状态。

  • 导出时间表：如果为实例配置了定期导出作业，则会显示此字段。如果已配置，则每日开始时间会显示在开始时间字段中。时间以您的当地时间表示。

  • 已启用通过 FIPS 140-3 验证的加密：此设置仅在实例为企业版或嵌入版时显示。如果显示，则表示 Looker 实例中的 Looker (Google Cloud Core) 是否符合联邦信息处理标准出版物 (FIPS) 140-3 标准。如果符合，则显示 true。如果不合规，则显示 false。

  • Gemini Enabled：是否为实例启用了 Gemini in Looker。如果已启用，则会显示 true。如果未启用，则会显示 false。

  • Gemini AI 配置：如果启用了 Gemini，则会显示此设置以及以下子设置：

    • 可信测试员功能：如果已启用，则显示 true。如果未启用，则显示 false。
    • 可信测试员数据使用：如果已启用，则显示 true。如果未启用，则显示 false。

  • 目录集成已停用：如果 Looker (Google Cloud Core) 与 Knowledge Catalog 之间的集成已停用，此字段会显示 true。否则，该字段会显示 false。

备份标签页

通过备份标签页，您可以查看和管理实例的自动备份和手动备份。

自定义网域标签页

自定义网域标签页提供了一种可选方法，可使用自定义网域自定义用于访问实例的网址。

数据洞察 Pro标签页

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

此标签页还会显示托管数据洞察 Pro 订阅内容的 Google Cloud 项目的名称。

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

所需角色

如需获得修改 Looker (Google Cloud Core) 实例设置所需的权限，请让管理员为您授予在其中创建实例的项目上的 Looker Admin (roles/looker.admin) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

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

您可能还需要其他 IAM 角色或权限才能修改特定实例设置。

修改设置

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

控制台

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

  • 连接：实例配置必须指定网络连接。如果您的实例使用混合连接，您可以将连接选项更改为专用连接；如果您的实例使用专用连接，您可以将连接选项更改为混合连接。否则，此设置无法修改。

  • 配置入站连接：此部分中的字段因实例的网络设置而异：

    • 如果您有公共安全连接实例或混合实例，则可以创建或修改实例的 IP 许可清单，以便仅允许许可清单中列出的 IP 地址访问该实例。
      • 如需创建许可清单，请选中启用 IP 许可清单复选框，然后点击 IP 许可清单规则下的添加项以添加规则。在规则名称字段中，添加规则的名称。在 IP 范围字段中，使用 IP 地址和子网掩码添加已批准的 IP 地址范围，如 CIDR 表示法中所述。点击添加项，向许可清单中添加其他规则。您可以删除规则，方法是将指针悬停在规则上，然后点击显示的删除项目垃圾桶图标。如需了解详情，请参阅为 Looker (Google Cloud Core) 配置 IP 许可清单文档页面。
      • 如果您想将其他 Google Cloud 服务与 Looker (Google Cloud Core) 实例搭配使用，并且您的实例使用 IP 许可清单，则必须先向其他 Google Cloud 服务使用的 IP 范围授予访问权限，然后才能连接到这些服务。通过选中将 Google 服务与此实例关联复选框，可以将某些 Google Cloud 服务自动添加到许可清单中。如需了解详情，请参阅允许连接到 Google 服务文档。
    • 如果您有一个使用 Private Service Connect 的专用连接实例，则可以修改允许入站到该实例的 VPC。您可以更新 VPC 的现有设置。如需删除 VPC，请将指针悬停在相应网络上，然后点击显示的删除项垃圾桶图标。或者，您也可以添加 VPC，方法是点击添加项，在项目字段中选择创建网络的项目，然后在网络下拉菜单中选择网络。

  • 配置出站连接：如果您有使用 Private Service Connect 的混合连接或专用连接实例，则可以配置从 Looker (Google Cloud Core) 实例到外部服务的出站（出站流量）连接。

    • 支持 Looker 连接到外部服务：选中此复选框，即可使用 HTTPS 和Secure Web Proxy连接到 Looker Marketplace 或全球 FQDN。
    • 支持连接到 Looker Marketplace：选中此复选框可启用与 Looker Marketplace 的连接。
    • 全球 FQDN：如需使用受控出站流量连接到外部公共网域，请点击添加项按钮，然后在全球 FQDN 字段中添加完全限定域名。如需移除全局 FQDN，请选择相应项，然后点击删除项图标。

  • 本地 FQDN：如果您有使用 Private Service Connect 的混合连接或专用连接实例，则可以修改出站服务连接。您可以更新服务连接的现有设置。您可以删除服务连接，方法是将指针悬停在其上，然后点击显示的删除项目垃圾桶图标。或者，您也可以点击添加项来添加服务连接。添加服务连接时，请在本地 FQDN 字段中输入服务的完全限定域名，并在目标服务连接 URI 字段中输入服务连接 URI。

  • 身份验证：您可以修改 Looker (Google Cloud Core) 实例的身份验证设置。主要身份验证方法的选项包括员工身份联合 (SAML/OIDC) 或 Google OAuth。如果您选择使用员工身份联合进行主要身份验证，还可以启用启用辅助 OAuth 开关，将 OAuth 配置为辅助身份验证方法。

  • OAuth 应用凭据：此外，在身份验证部分，您可以修改 OAuth 应用凭据设置。如果 OAuth 凭证设置为手动，则表示在实例创建期间或之后，自定义 OAuth 凭证已添加到您的实例中。系统不会显示客户端 ID 和客户端密钥，而是会显示 **** 占位符。如果 OAuth 凭证设置为由 Looker 管理，则 Looker (Google Cloud Core) 会在实例创建期间为您的实例预配 OAuth 凭证，并且不会显示客户端 ID 和客户端密钥。

    在修改此设置之前，请务必设置新凭证，并将实例的网域添加到 OAuth 客户端中的已获授权的重定向 URI 字段。如需修改此设置，请将 OAuth 凭证设置为手动（如果尚未选择）。

  • 发布渠道：您可以修改实例的发布渠道。选项包括快速、常规和无渠道。如需修改加速安全补丁 (ASP) 标志，您必须使用 Google Cloud CLI。

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

  • 拒绝维护期：您可以选择指定一个时间段，在此期间 Looker (Google Cloud Core) 不安排维护。拒绝维护期最长可达 60 天。您必须在拒绝维护窗口之间至少留出 14 天允许维护时间。

  • 邮箱域名许可清单：如果允许使用的域名字段中没有域名，则邮箱域名不受限制。如需限制网域，请以 domain.suffix 格式输入要允许的网域，然后按键盘上的 Enter 键。如果您更改了实例的电子邮件网域许可名单设置，Looker (Google Cloud Core) 实例必须重启，并且如果实例中有任何正在运行的持久性派生表，它们将重新生成。如需详细了解电子邮件网域许可清单设置以及该设置如何与权限和用户属性交互，请参阅电子邮件网域许可清单（适用于计划内容）文档页面。

  • Gemini in Looker：启用 Gemini 设置后，Looker (Google Cloud Core) 实例即可使用 Gemini in Looker 功能。启用可信测试员功能设置后，实例上的用户可以使用 Gemini in Looker 中提供的可信测试员功能。启用可信测试员数据使用设置后，Google 将有权访问 Gemini in Looker 用户数据，如 Gemini for Google Cloud 可信测试员计划条款中所述。如需详细了解 Gemini in Looker 功能以及如何为 Looker (Google Cloud Core) 实例管理这些功能，请参阅在 Looker (Google Cloud Core) 中管理 Gemini 文档页面。

  • Universal Catalog 集成：如果您不希望 Looker (Google Cloud Core)与 Knowledge Catalog 集成，则可以选择选择不集成 Dataplex Catalog 复选框。Looker (Google Cloud Core) 和 Knowledge Catalog 默认集成。

Looker (Google Cloud Core)与 Knowledge Catalog 的集成可实现元数据注入和数据沿袭（如果已启用 Data Lineage API）。

完成更改后，点击保存。

gcloud

如需更新设置，请使用 gcloud looker instances update 命令：


gcloud looker instances update (INSTANCE_NAME : --region=REGION)
    [--allowed-email-domains=[ALLOWED_EMAIL_DOMAINS,...]]\
    [--oauth-client-id=OAUTH_CLIENT_ID]\
    [--oauth-client-secret=OAUTH_CLIENT_SECRET] [--public-ip-enabled] [--no-public-ip-enabled]\
    [--release-channel=RELEASE_CHANNEL]\
    [--accelerated-security-patch-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]\
    [--psc-service-attachment  domain=DOMAIN_1,attachment=SERVICE_ATTACHMENT_URI_1 \
    --psc-service-attachment domain=DOMAIN_2,attachment=SERVICE_ATTACHMENT_URI_2 \]
    [--psc-allowed-vpcs=ALLOWED_VPC_1,ALLOWED_VPC_2 ]\
    [--clear-psc-allowed-vpcs]\
    [--async]

替换以下内容：

  • INSTANCE_NAME：Looker (Google Cloud Core) 实例的名称；它与实例网址无关。
  • REGION：Looker (Google Cloud Core) 实例所在的区域。
  • RELEASE_CHANNEL：实例的发布渠道。可用值为 rapid、regular 和 no-channel。此功能处于预览阶段。

  • ALLOWED_EMAIL_DOMAINS：如果 --allowed-email-domains 中没有网域，则电子邮件网域不受限制。如需限制网域，请以 domain.suffix 格式添加要允许的网域。如果您更改了实例的允许电子邮件网域，Looker (Google Cloud Core) 实例必须重启，并且如果实例中有任何正在运行的持久性派生表，这些表将会重新生成。如需详细了解电子邮件网域许可清单以及它如何与权限和用户属性交互，请参阅电子邮件网域许可清单（适用于计划内容）文档。

  • OAUTH_CLIENT_ID 和 OAUTH_CLIENT_SECRET：与您的实例关联的 OAuth 客户端 ID 和 OAuth secret。在修改此设置之前，请务必设置新凭据，并将实例的网域添加到 OAuth 客户端中的已获授权的重定向 URI 字段。

  • 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) 的维护政策文档页面。

  • DOMAIN_1 和 DOMAIN_2：您要使用 Private Service Connect 连接到 Looker (Google Cloud Core) 实例的任何已发布服务的域名。如需了解详情，请参阅创建 Looker (Google Cloud Core) Private Service Connect 实例文档页面。

  • SERVICE_ATTACHMENT_URI_1 和 SERVICE_ATTACHMENT_URI_2：您要使用 Private Service Connect 连接到 Looker (Google Cloud Core) 实例的任何已发布服务的完整服务连接 URI。如需了解详情，请参阅创建 Looker (Google Cloud Core) Private Service Connect 实例文档页面。

  • ALLOWED_VPC_1 和 ALLOWED_VPC_2：允许入站流量进入使用 Private Service Connect 的 Looker (Google Cloud Core) 实例的 VPC。如需了解详情，请参阅创建 Looker (Google Cloud Core) Private Service Connect 实例文档页面。

您还可以添加以下标志：

  • --public-ip-enabled 用于启用公共 IP。
  • --no-public-ip-enabled 停用公共 IP。
  • --clear-psc-allowed-vpcs 会从使用 Private Service Connect 的实例中移除所有 VPC。
  • --no-catalog-integration-enabled 可停用与 Knowledge Catalog 的集成。
  • --catalog-integration-enabled 可与 Knowledge Catalog 集成。此功能处于预览阶段。
  • --accelerated-security-patch-enabled：如果您的实例位于 regular 发布渠道，并且您希望每两周接收一次安全补丁，则可以选择添加此标志。此功能处于预览阶段。

如果您的实例使用专用连接，则可以添加或移除公共安全连接。您无法添加或移除专用连接。

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

后续步骤