Looker (Google Cloud Core) 的 BigQuery 預設連線

Looker (Google Cloud Core) 必須連線至資料庫,才能啟用資料探索功能。您可以使用 BigQuery 快速入門連線,建立 BigQuery 標準 SQL 資料庫的預設連線。

主畫面上的 BigQuery 快速入門資訊方塊。

事前準備

設定 BigQuery 快速連線時,需要具備下列權限。

Looker 權限

如果您具備下列 Looker 權限之一,就可以在 Looker (Google Cloud core) 執行個體的「Home」頁面上查看及編輯「BigQuery 快速入門連線」頁面:

IAM 權限

當您設定與 BigQuery 的連線時,Looker (Google Cloud Core) 執行個體可以使用應用程式預設憑證 (ADC) 進行驗證。使用 ADC 時,連線會使用 Looker (Google Cloud Core) 服務帳戶的憑證,對資料庫進行驗證。服務帳戶必須具備下列 IAM 權限,才能存取 BigQuery 資料集:

如果 Looker (Google Cloud 核心) 服務帳戶尚未具備必要的 IAM 角色,請在該專案中授予角色時使用服務帳戶的電子郵件地址。如要查看服務帳戶的電子郵件地址,請前往 Google Cloud 控制台的「IAM」頁面,然後選取「包含 Google 提供的角色授權」核取方塊。電子郵件的格式為 service-<project number>@gcp-sa-looker.iam.gserviceaccount.com。使用該電子郵件地址為服務帳戶授予適當的角色

設定 BigQuery 快速入門連線

具備適當權限的使用者可以透過「首頁」頁面,或「管理」面板中的「連線」頁面,查看及編輯 BigQuery 快速入門連線。在「連線」頁面中,BigQuery 快速入門連線會顯示在「預設 BigQuery 連線」名稱下方。在新執行個體上,儲存空間專案 ID帳單專案 ID 欄位預設為「None」

在「首頁」頁面中,按一下「查看連結」按鈕來管理連結。如要關閉「Home」頁面圖塊,請按一下「x」,或是在「Discover」側欄中切換「BigQuery 快速入門」選項。

BigQuery 快速連線包含以下章節:

計費專案 ID

專案 ID 是 Google Cloud 帳單專案的專屬 ID。帳單專案是 Google Cloud 會因 BigQuery 用量而產生帳單的專案,但如果 LookML 開發人員在 LookML 檢視畫面探索彙整sql_table_name 參數中指定完整的資料表名稱,您還是可以查詢其他 Google Cloud 專案中的資料集。這是必填欄位。

如何使用 OAuth 驗證 BigQuery 資料庫:Looker (Google Cloud Core) 可自動使用 Looker (Google Cloud Core) 管理員建立執行個體時使用的 OAuth 應用程式憑證,連線至 BigQuery。詳情請參閱「為 Looker (Google Cloud Core) 執行個體建立 OAuth 授權憑證」頁面。

展開「狀態詳細資料」部分,測試連線設定。

主要資料集

「主要資料集」頁面包含下列設定。

儲存專案 ID

在「Storage Project ID」欄位中,輸入包含要連結的 BigQuery 資料集專案的 專案 ID,即使該專案包含 Looker (Google Cloud Core) 執行個體也一樣。這是必填欄位。

主要資料集

如未在 SQL 查詢文字中指定資料表位置,BigQuery 就會在這個主要資料集中搜尋資料表。請注意,Looker (Google Cloud 核心) 查詢可參照任何專案或資料集中的資料表,但完整範圍資料表的名稱格式須為 project_id.dataset_name.table_name。Looker (Google Cloud Core) 服務帳戶也必須具備適當的 IAM 權限,才能存取該位置的資料表。這是必填欄位。

如要進一步瞭解資料集,請參閱「將 Looker 連結至 BigQuery」說明文件頁面。

展開「狀態詳細資料」部分,測試連線設定。

選用設定

「選用設定」部分包含下列選項:

  • 個別節點的連線數量上限:一次最多可有多少資料庫連線。注意:這項設定是以 Looker (Google Cloud Core) 部署項目中的個別節點為單位,這個值必須介於 5 至 100 之間,並可在初始時保留預設值。如要進一步瞭解這項設定,請參閱「將 Looker 連線至資料庫」說明文件頁面中的「每個節點的最大連線數」一節。

  • 連線集區逾時:連線集區已滿時,查詢要等待幾秒才會逾時。可在初始時保留預設值。如要進一步瞭解這項設定,請參閱「將 Looker 連結至資料庫」說明文件頁面中的「連線集區逾時」一節。

  • 其他 JDBC 參數:新增任何其他 JDBC 參數,例如 BigQuery 標籤 (詳情請參閱本頁的「BigQuery 連線的工作標籤和背景說明」一節)。

  • 維護時間表:Cron 運算式,指出資料群組觸發條件檢查和 PDT 維護作業的頻率上限。如要進一步瞭解這項設定,請參閱「維護時間表」說明文件。

  • SSL:選擇是否要使用 SSL 加密,在 Looker (Google Cloud Core) 和資料庫之間傳輸資料時保護資料。SSL 只是可用來保護資料的其中一種選項;如需瞭解其他安全選項,請參閱「啟用安全資料庫存取權」說明文件頁面。

  • 驗證 SSL:選擇是否要驗證連線使用的 SSL 憑證。如要進一步瞭解這項設定,請參閱「將 Looker 連線至資料庫」說明文件頁面中的「驗證 SSL」部分。

  • 預先快取資料表和資料欄:在 SQL Runner 中,只要選取連線和結構定義,所有資料表資訊就會預先載入。這樣一來,只要點選資料表名稱,SQL Runner 就能立即顯示資料表資料欄。不過,如果連線和結構定義包含許多資料表或非常大的資料表,您可能不希望 SQL Runner 預先載入所有資訊。

  • 擷取及快取結構定義:針對部分 SQL 寫入功能 (例如匯總認知),Looker (Google Cloud 核心) 會使用資料庫的資訊結構定義來最佳化 SQL 寫入作業。如要進一步瞭解這項設定,請參閱「將 Looker 連結至資料庫」說明文件頁面中的「擷取 SQL 寫入的資訊結構定義」一節。

  • 啟用 PDT:開啟「啟用 PDT」切換鈕,即可啟用永久衍生資料表。啟用 PDT 後,「選用設定」視窗會顯示其他 PDT 欄位和「PDT 覆寫」部分。

  • 暫時性資料庫:在 BigQuery 中輸入資料集,Looker (Google Cloud 核心) 會在其中建立永久衍生資料表。您應預先設定此資料集,並取得適當的寫入權限。這是使用 PDT 的必填欄位。

  • PDT 建構工具連線數量上限PDT 建構工具連線數量上限的預設值為 1,但可設定為 10。不過,這個值不得高於「每個節點的最大連線數」中設定的值。如要進一步瞭解這項設定,請參閱「將 Looker 連結至資料庫」說明文件頁面中的「PDT 建構工具連線數量上限」部分。請謹慎設定這個值。如果值過高,資料庫可能會無法負荷。如果這個值偏低,長時間執行的 PDT 或匯總資料表可能會延遲建立其他永久性資料表,或減緩連線的其他查詢。

  • 重新執行失敗的 PDT 建構作業重新執行失敗的 PDT 建構作業切換鈕可設定 Looker (Google Cloud Core) 再生器如何嘗試重新建構在先前再生器週期中失敗的觸發式持續性資料表。如要進一步瞭解這項設定,請參閱「將 Looker 連結至資料庫」說明文件頁面中的「重新執行失敗的 PDT 建構作業」一節。

  • PDT API 控制功能PDT API 控制功能切換鈕可決定是否可使用 start_pdt_buildcheck_pdt_buildstop_pdt_build API 呼叫來建立此連線。當「PDT API 控制」切換鈕停用時,這些 API 呼叫會在參照此連線上的 PDT 時失敗。

  • PDT 覆寫值:如果資料庫支援永久衍生資料表,且您已在連線設定中開啟「啟用 PDT」切換鈕,Looker (Google Cloud Core) 就會顯示「PDT 覆寫值」部分。在「PDT 覆寫值」部分,您可以輸入 PDT 程序專用的個別 JDBC 參數 (主機、連接埠、資料庫、使用者名稱、密碼、結構定義、額外參數和連線後陳述式)。如要進一步瞭解這項設定,請參閱「將 Looker 連線至資料庫」說明文件頁面中的「PDT 覆寫值」一節。

  • 資料庫時區:資料庫儲存時間相關資訊時採用的時區。Looker (Google Cloud 核心) 需要知道這項資訊,才能為使用者轉換時間值,方便使用者瞭解及使用時間資料。詳情請參閱「使用時區設定」說明文件頁面。

  • 查詢時區:只有在停用使用者專屬時區時,系統才會顯示「查詢時區」選項。詳情請參閱「使用時區設定」說明文件頁面。

展開「狀態詳細資料」部分,測試連線設定。

查看

在「查看」部分中,查看並修改您在先前各節中輸入的連結詳細資料。

展開「狀態詳細資料」部分,測試連線設定。按一下各個部分旁邊的編輯圖示,即可返回該部分變更設定。

儲存及測試連線

如要儲存對 BigQuery 快速連線所做的任何變更,請按一下「儲存」

您可以在 Looker (Google Cloud Core) UI 的幾個位置測試連線設定:

  • 展開任何快速入門連線頁面底部的「狀態詳細資料」部分,然後按一下「測試連線」
  • 在「首頁」頁面中,展開「快速連線」資訊方塊底部的「狀態詳細資料」部分,然後按一下「測試連線」
  • 在「Connections」管理員頁面中,選取連線清單旁的「Test」按鈕,如「Connections」說明文件頁面所述。

輸入連線設定後,請按一下「測試」,確認資訊正確無誤,且資料庫可連線。

如果連線無法通過一或多項測試,請嘗試下列排解問題的做法:

後續步驟