查看及編輯 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」(詳細資料) 分頁

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

  • 平台版本：執行個體的版本。選項包括「Standard」、「Enterprise」和「Embed」。
  • 發布管道：執行個體的發布管道。選項包括「快速」、「一般」和「無頻道」。這項功能為預先發布版。
  • 建立時間：建立執行個體的時間。
  • 更新時間：執行個體上次更新的時間。
  • 已啟用公開 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 租戶專案明確列在拒絕清單中)。
        • CLOSED：目標服務連結不存在，或缺少必要條件，例如僅限 Proxy 子網路的 Cloud NAT、TCP 健康狀態檢查，或服務連結許可清單中的 Looker 租戶專案 ID。這是最終狀態。如果連線狀態達到 CLOSED，您必須重新執行 gcloud looker instances update 指令並加上 --psc-service-attachment 旗標，強制 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 許可清單規則：每項許可清單規則都會在這個部分顯示為可展開或收合的項目。每個項目都包含「Description」(說明) 欄位 (規則名稱) 和「IP Range」(IP 範圍) 欄位 (規則的 IP 範圍)。

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

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

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

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

  • 分配的 IP 範圍：這個欄位提供使用私人服務存取權，且具備私人連線的執行個體相關資訊。這個欄位會顯示執行個體建立者或 Google 在建立執行個體時指派的 IP 位址範圍。如果執行個體是透過 Private Service Connect 或公開安全連線建立，則會顯示「No value」(無值)。

  • 電子郵件網域許可清單：「電子郵件網域許可清單」設定會顯示電子郵件網域，Looker (Google Cloud Core) 使用者可將 Looker 內容 (Look 圖表、資訊主頁、查詢和圖表) 傳送至這些網域，或透過電子郵件傳送快訊通知。根據預設，建立執行個體時，許可清單中不會有任何網域，而具備適當 Looker 權限可透過電子郵件傳送內容的 Looker (Google Cloud Core) 使用者，可以將內容傳送至任何網域。如要限制只有特定網域的電子郵件地址才能接收內容上傳和警告通知，請編輯執行個體設定，限制使用者可傳送電子郵件的網域。如要進一步瞭解電子郵件網域許可清單，以及該清單與權限和使用者屬性的互動方式，請參閱「排定內容的電子郵件網域許可清單」說明文件。

  • 維護期間：如果已為執行個體定義維護期間，則會顯示 Looker (Google Cloud Core) 排定維護作業的星期幾和小時。維護期間為一小時。如果未定義維護期間，則會顯示「No value」(無值)。

  • 預定維護作業：執行個體預定維護作業的日期和時間。如果未排定維護作業，則會顯示「No value」(無值)。

  • 拒絕維護期：如果已為執行個體設定拒絕維護期，Looker (Google Cloud Core) 不會在該時間範圍排定維護作業。

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

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

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

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

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

  • 已啟用通過 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。

「備份」分頁

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

「自訂網域」分頁

「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 range」(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，您可以編輯允許輸入至執行個體的虛擬私有雲。您可以更新虛擬私有雲的現有設定。將滑鼠游標懸停在網路上，然後點選顯示的「刪除項目」垃圾桶圖示，即可刪除虛擬私有雲。或者，您也可以按一下「Add Item」(新增項目) 來新增虛擬私有雲，在「Project」(專案) 欄位中選取建立網路的專案，然後在「Network」(網路) 下拉式選單中選取網路。

  • 設定傳出連線：如果混合連線或私人連線執行個體使用 Private Service Connect，您可以設定從 Looker (Google Cloud Core) 執行個體到外部服務的傳出 (egress) 連線。

    • 「Enable Looker to connect to external services」：勾選這個核取方塊，即可使用 HTTPS 和Secure Web Proxy 連線至 Looker Marketplace 或全域 FQDN。
    • 啟用 Looker Marketplace 連線：勾選這個核取方塊，即可啟用 Looker Marketplace 連線。
    • 「Global FQDN」(全域 FQDN)：如要使用受控輸出連線至外部公用網域，請按一下「Add Item」(新增項目) 按鈕，然後在「Global FQDN」(全域 FQDN) 欄位中新增完整網域名稱。如要移除全域 FQDN，請選取項目，然後按一下「Delete Item」(刪除項目) 圖示。

  • 本機 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) 排定維護作業的星期和小時。維護期間為一小時。根據預設，「維護期間」中的「偏好期間」選項會設為「任何期間」。

  • 拒絕維護期：您可以指定 Looker (Google Cloud Core) 不安排維護作業的日期範圍。拒絕維護期的上限為 60 天。在拒絕維護期間之間，至少須有 14 天的空檔，讓系統能執行維護作業。

  • 電子郵件網域許可清單：如果「允許的網域」欄位中沒有任何網域，則電子郵件網域不受限制。如要限制網域，請以 domain.suffix 格式輸入要允許的網域，然後按下鍵盤上的 Enter 鍵。如果您變更執行個體的「Email Domain Allowlist」(電子郵件網域許可清單) 設定，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) 執行個體的 Gemini in Looker 功能，請參閱「管理 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」欄位。

後續步驟