查看及編輯 Looker (Google Cloud Core) 執行個體的詳細資料

您可以在 Google Cloud 控制台中，尋找及編輯專案的 Looker (Google Cloud Core) 執行個體資訊。

查看執行個體資訊

與所選 Google Cloud 專案相關聯的 Looker (Google Cloud Core) 執行個體，會列在 Google Cloud 控制台的「Instances」(執行個體) 頁面，包括貴組織其他使用者建立的執行個體。

必要角色

如要查看「執行個體」頁面的資訊，您必須具備「Looker 管理員」 (roles/looker.admin) 或「Looker 檢視者」 (roles/looker.viewer) 角色。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

「執行個體」頁面

「Instances」(執行個體) 頁面會顯示各執行個體的下列資訊：

  • 狀態：
    • 如果執行個體已成功建立並啟用，系統會顯示有勾號的綠色圓圈。
    • 如果正在建立執行個體，系統會顯示載入圖示。
  • 名稱：執行個體建立者在建立執行個體時提供的名稱。點選名稱，前往「詳細資料」分頁，查看所選執行個體的其他資訊。

  • 執行個體網址：可存取使用公開安全連線執行個體的網址。根據預設，執行個體網址的格式為 https://hostname.looker.app，其中主機名稱是隨機指派。點選網址前往執行個體。

  • 版本：執行個體上執行的 Looker 版本。

  • 區域：託管執行個體的區域。

  • 建立日期：建立執行個體的日期。

執行個體分頁

在「Instances」(執行個體) 頁面中，按一下執行個體的名稱，即可查看執行個體的詳細資訊。點選名稱後，系統會顯示執行個體設定頁面，其中包含下列分頁標籤中的資訊：

「詳細資料」分頁

「Details」(詳細資料) 分頁會顯示其他執行個體中繼資料：

  • 平台版本：執行個體的版本。選項包括「標準版」、「企業版」和「嵌入」。
  • 發布管道：執行個體的發布管道。選項包括「快速」、「一般」和「無頻道」。這項功能為預先發布版。
  • 建立時間：建立執行個體的時間。
  • 更新時間：執行個體的上次更新時間。
  • 已啟用公開 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。
    • 允許的虛擬私有雲：這項設定包含已授權北向存取 Private Service Connect 執行個體的虛擬私有雲清單。

    • PSC 端點：如果 Looker (Google Cloud Core) 執行個體使用 Private Service Connect 建立發布服務的傳出 (輸出) 連線，就會顯示這項設定。可用的子設定如下：

      • 本機 FQDN：執行個體連線的已發布服務完整網域名稱。
      • 目標服務連結 URI：Looker (Google Cloud Core) 執行個體連線的已發布服務服務連結 URI。

      • 連線狀態：連線狀態，可能是下列其中一種：

        • ACCEPTED：連線已建立且運作正常。
        • PENDING：未建立連線 (Looker 租戶專案尚未加入許可清單)。
        • 需要處理：目標服務連結發生問題，例如 NAT 子網路已用盡。
        • REJECTED：未建立連線 (Looker 租戶專案明確列在拒絕清單中)。
        • 已關閉：目標服務連結不存在，或缺少必要條件，例如僅限 Proxy 的子網路的 Cloud NAT、TCP 健康狀態檢查，或是服務連結許可清單中的 Looker 租戶專案 ID。這是最終狀態。如果連線狀態達到 CLOSED，您必須重新執行 gcloud looker instances update 指令並加上 --psc-service-attachment 旗標，強制 Looker (Google Cloud Core) 重新觸發連線嘗試。
        • UNKNOWN：未指定連線狀態。

    • 已啟用受控 Egress：如果 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 Allowlist Enabled：如果在執行個體的「Edit」頁面中勾選「Enable IP Allowlist」核取方塊，這個欄位會顯示 true。如果未啟用核取方塊，這個欄位會顯示 false。
    • Google Services Enabled：如果在執行個體的「Edit」(編輯) 頁面中，勾選「Link Google services with this instance」(將 Google 服務連結至這個執行個體) 核取方塊，這個欄位就會顯示 true。
    • IP 許可清單規則：每項許可清單規則都會在這個部分顯示為可展開或收合的項目。每個項目都包含「說明」欄位 (規則名稱) 和「IP 範圍」欄位 (規則的 IP 範圍)。

  • 輸出公開 IP：這個欄位提供具有公開安全連線的執行個體相關資訊。其中顯示了建立執行個體時自動指派的輸出公開 IP 位址。如未指派任何值，則會顯示「無值」。

  • Ingress Public IP：這個欄位提供具有公開安全連線的執行個體相關資訊。顯示執行個體建立時自動指派的連入公開 IP 位址。

  • Ingress 私人 IP：這個欄位提供使用私人服務存取權的私人連線執行個體相關資訊。其中會顯示執行個體的輸入私人 IP 位址。如果執行個體是透過公開安全連線或 Private Service Connect 建立，則會顯示「No value」(無值)。

  • 相關聯的網路：這個欄位提供使用私人服務存取權的私人連線執行個體相關資訊。顯示選取用來建立私人連線的網路。如果執行個體是透過公開安全連線建立，則會顯示「無值」。

  • 「Allocated IP Range」(分配的 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) 不會在這段時間範圍安排維護作業。

    • 開始日期：拒絕維護期間的開始日期。如未排定拒絕維護期，則會顯示「No value」(無值)。
    • 結束日期：拒絕維護期的結束日期。如未排定拒絕維護期，則會顯示「No value」(無值)。
    • 時間：您指定開始日期和結束日期的拒絕維護期開始和結束時間。如未排定拒絕維護期，則會顯示「No value」(無值)。

  • 上次拒絕維護期：最近一次拒絕維護期的開始日期和結束日期。在任兩個拒絕維護期之間，至少須有 14 天的空檔，讓系統能執行維護作業。

    • 開始日期：最近一次拒絕維護期的開始日期。如果先前未排定拒絕維護期，系統會顯示「無值」。
    • 結束日期：拒絕維護期的結束日期。如果先前未排定拒絕維護期，系統會顯示「無值」。
    • 時間：先前拒絕維護期在開始日期和結束日期的開始和結束時間。如果先前未排定拒絕維護期，系統會顯示「無值」。

  • 加密：只有在執行個體是以 CMEK 建立時，才會顯示這項設定。如果顯示，則會一併顯示「客戶自行管理的加密金鑰 (CMEK)」、金鑰 ID 和金鑰連結。如果執行個體使用預設的 Google 代管加密機制，系統就不會顯示這個欄位。您可能需要所用金鑰的 Cloud KMS IAM 角色或權限，才能查看 CMEK 加密金鑰的狀態。

  • 匯出排程：如果執行個體已設定排定的匯出工作，就會顯示這個欄位。如果已設定，每日開始時間會顯示在「開始時間」欄位。時間以您的當地時間為準。

  • 已啟用通過 FIPS 140-3 驗證的加密機制：只有在執行個體為 Enterprise 或 Embed 版本時，才會顯示這項設定。如果顯示這項資訊，表示 Looker 執行個體中的 Looker (Google Cloud Core) 是否符合聯邦資訊處理標準出版品 (FIPS) 140-3 標準。如果符合，則會顯示 true。如果不符合，則會顯示 false。

  • Gemini Enabled：執行個體是否已啟用 Gemini in Looker。如果已啟用，則會顯示 true。如果未啟用，則會顯示 false。

  • Gemini AI 設定：啟用 Gemini 後，系統會顯示這項設定和下列子設定：

    • 早鳥測試者功能：如果已啟用，會顯示「true」。如果未啟用，則會顯示 false。
    • 早鳥測試者資料使用：如果已啟用，會顯示 true。如果未啟用，則會顯示 false。

  • Catalog Integration Disabled：如果 Looker (Google Cloud Core) 與 Knowledge Catalog 之間的整合功能已停用，這個欄位會顯示 true。否則，欄位會顯示 false。

「備份」分頁

您可以在「備份」分頁中查看及管理執行個體的自動和手動備份。

「自訂網域」分頁

「Custom domain」(自訂網域) 分頁提供選用方法，可讓您使用自訂網域自訂存取執行個體的網址。

「數據分析 Pro」分頁

在「數據分析 Pro」分頁中，您可以接受 Looker (Google Cloud Core) 執行個體隨附的數據分析 Pro 授權。如果「接受數據分析 Pro 授權」切換鈕已啟用，代表您已接受隨附授權。

這個分頁也會顯示存放數據分析 Pro 訂閱內容的 Google Cloud 專案名稱。

編輯 Looker (Google Cloud Core) 執行個體設定

必要角色

如要取得編輯 Looker (Google Cloud Core) 執行個體設定所需的權限，請要求管理員針對建立執行個體的專案，授予您 Looker 管理員 (roles/looker.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

您可能也需要其他 IAM 角色或權限，才能編輯特定執行個體設定。

編輯設定

如要修改執行個體設定，請選取下列任一選項：

主控台

在執行個體的「詳細資料」分頁中，按一下「編輯」即可修改下列設定：

  • 連線：執行個體設定必須指定網路連線。如果執行個體使用混合式連線，您可以將連線選項變更為私人連線；如果執行個體使用私人連線，則可將連線選項變更為混合式連線。否則這項設定無法編輯。

  • 設定傳入連線：這個部分的欄位會因執行個體的網路設定而異：

    • 如果您有公開安全連線執行個體或混合執行個體，可以建立或編輯執行個體的 IP 許可清單，僅允許清單中的 IP 位址存取執行個體。
      • 勾選「啟用 IP 許可清單」核取方塊，然後點選「IP 許可清單規則」下方的「新增項目」，即可建立許可清單並新增規則。在「規則名稱」欄位中，新增規則名稱。在「IP 範圍」欄位中，使用 IP 位址和子網路遮罩新增核准的 IP 位址範圍，如 CIDR 標記法所述。按一下「新增項目」，將其他規則新增至許可清單。將滑鼠游標懸停在規則上，然後點選出現的「刪除項目」垃圾桶圖示，即可刪除規則。詳情請參閱「為 Looker (Google Cloud Core) 設定 IP 許可清單」說明文件頁面。
      • 如要搭配 Looker (Google Cloud Core) 執行個體使用其他 Google Cloud 服務，且執行個體採用 IP 許可清單，則必須先授予其他 Google Cloud 服務所用 IP 範圍的存取權，才能連線至這些服務。勾選「將 Google 服務連結至這個執行個體」核取方塊，即可自動將特定 Google Cloud 服務加入許可清單。詳情請參閱「允許連線至 Google 服務」說明文件。
    • 如果私人連線執行個體使用 Private Service Connect，您可以編輯允許輸入執行個體的虛擬私有雲。您可以更新虛擬私有雲的現有設定。將滑鼠游標懸停在網路上，然後點選顯示的「刪除項目」垃圾桶圖示，即可刪除虛擬私有雲。或者，您可以按一下「新增項目」，在「專案」欄位中選取建立網路的專案，然後在「網路」下拉式選單中選取網路，即可新增虛擬私有雲。

  • 設定傳出連線：如果混合連線或私人連線執行個體使用 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 的混合式連線或私人連線執行個體，可以編輯傳出服務附件。您可以更新服務附件的現有設定。將指標懸停在服務附件上，然後點選隨即出現的「刪除項目」垃圾桶圖示，即可刪除附件。或者，您也可以按一下「新增項目」來新增服務附件。新增服務連結時，請在「Local FQDN」(本機 FQDN) 欄位中輸入服務的完整網域名稱，並在「Target Service Attachment URI」(目標服務連結 URI) 欄位中輸入服務連結 URI。

  • 驗證：您可以編輯 Looker (Google Cloud Core) 執行個體的「驗證」設定。主要驗證方式可選用「員工身分聯盟 (SAML/OIDC)」或「Google OAuth」。如果您選擇使用員工身分聯盟進行主要驗證，也可以啟用「啟用次要 OAuth」切換鈕，將 OAuth 設為次要驗證方式。

  • OAuth 應用程式憑證：您也可以在「驗證」部分編輯「OAuth 應用程式憑證」設定。如果 OAuth 憑證設為「Manual」(手動)，代表在建立執行個體期間或之後，自訂 OAuth 憑證已新增至執行個體。系統不會顯示用戶端 ID 和用戶端密鑰，而是顯示 **** 預留位置。如果 OAuth 憑證設為「Looker managed」(Looker 管理)，Looker (Google Cloud Core) 會在建立執行個體時，為執行個體佈建 OAuth 憑證，且不會顯示用戶端 ID 和用戶端密鑰。

    編輯這項設定前，請務必設定新憑證，並將執行個體的網域新增至 OAuth 用戶端的「已授權的重新導向 URI」欄位。如要編輯這項設定，請將 OAuth 憑證設為「手動」(如果尚未選取)。

  • 發布管道：您可以編輯執行個體的發布管道。選項包括「快速」、「一般」和「無頻道」。如要編輯加速安全性修補程式 (ASP) 旗標，請使用 Google Cloud CLI。

  • 維護期間：您可以視需要指定 Looker (Google Cloud Core) 排定維護作業的星期幾和小時。維護期間為一小時。根據預設，「Maintenance Window」(維護期間) 中的「Preferred Window」(偏好的時間範圍) 選項會設為「Any window」(任何時間範圍)。

  • 拒絕維護期：您可以視需要指定 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 for Google Cloud 「早鳥測試者計畫」條款，存取 Gemini in Looker 使用者資料。如要進一步瞭解 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 密鑰。編輯這項設定前，請務必設定新憑證，並將執行個體的網域新增至 OAuth 用戶端的「Authorized redirect URIs」欄位。

  • DENY_MAINTENANCE_PERIOD_START_DATE 和 DENY_MAINTENANCE_PERIOD_END_DATE：必須採用 YYYY-MM-DD 格式。

  • MAINTENANCE_WINDOW_TIME 和 DENY_MAINTENANCE_PERIOD_TIME：必須採用世界標準時間的 24 小時制格式 (例如 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：任何已發布服務的完整服務連結 URI，您要使用 Private Service Connect 將這些服務連線至 Looker (Google Cloud Core) 執行個體。詳情請參閱「建立 Looker (Google Cloud Core) Private Service Connect 執行個體」說明文件頁面。

  • ALLOWED_VPC_1 和 ALLOWED_VPC_2：允許輸入至使用 Private Service Connect 的 Looker (Google Cloud Core) 執行個體的虛擬私有雲。詳情請參閱「建立 Looker (Google Cloud Core) Private Service Connect 執行個體」說明文件頁面。

您也可以加入下列旗標：

  • --public-ip-enabled 啟用公開 IP。
  • --no-public-ip-enabled 會停用公開 IP。
  • --clear-psc-allowed-vpcs 會從使用 Private Service Connect 的執行個體中移除所有虛擬私有雲。
  • --no-catalog-integration-enabled 會停用與 Knowledge Catalog 整合。
  • --catalog-integration-enabled 可與 Knowledge Catalog 整合。這項功能為預先發布版。
  • --accelerated-security-patch-enabled：如果您的執行個體位於 regular 發布管道，且您想每兩週接收一次安全性修補程式，可以選擇加入這個旗標。這項功能為預先發布版。

如果執行個體使用私人連線，您可以新增或移除公開安全連線。您無法新增或移除私人連線。

更新 OAuth 憑證前，請務必設定新憑證，並將執行個體的網域新增至 OAuth 用戶端的「已授權的重新導向 URI」欄位。

後續步驟