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

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

首頁上的 BigQuery 快速入門導覽課程圖塊。

事前準備

設定 BigQuery 快速連線時，需要下列權限。

Looker 權限

如果您具備下列Looker 權限，即可在 Looker (Google Cloud Core) 執行個體的首頁上，查看及編輯「BigQuery QuickStart Connection」(BigQuery 快速入門連線) 頁面：

IAM 權限

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

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

設定 BigQuery 快速連線

只要使用者具備適當權限，就能從「首頁」或「管理」面板的「連線」頁面，查看及編輯 BigQuery 快速入門連線。在「連線」頁面中，BigQuery QuickStart 連線會顯示在「預設 BigQuery 連線」名稱下方。在新執行個體上，「儲存專案 ID」和「帳單專案 ID」欄位預設為「無」。

在「首頁」頁面中，按一下「查看連結」按鈕即可管理連結。如要關閉「首頁」頁面動態磚，請點選「x」，或在「探索」側欄中切換「BigQuery 快速入門」選項。

BigQuery 快速連線包含下列章節：

計費專案 ID

專案 ID 是 Google Cloud 帳單專案的專屬 ID。帳單專案是 Google Cloud 用於支付 BigQuery 用量費用的專案，但如果 LookML 開發人員在 LookML 檢視區塊、探索或聯結的 sql_table_name 參數中指定完整範圍的資料表名稱，您仍可查詢其他 Google Cloud 專案中的資料集。這是必填欄位。

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

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

主要資料集

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

儲存專案 ID

在「Storage Project ID」欄位中，輸入要連線的 BigQuery 資料集所屬專案的專案 ID，即使該專案與 Looker (Google Cloud Core) 執行個體所屬專案相同也一樣。這是必填欄位。

主要資料集

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

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

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

選用設定

「Optional Settings」(選用設定) 部分包含下列選項：

  • 每個節點的連線數量上限：一次最多可以有多少資料庫連線。注意：這項設定是以 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 Core) 會使用資料庫的資訊結構定義，以最佳化 SQL 撰寫作業。如要進一步瞭解這項設定，請參閱「將 Looker 連線至資料庫」說明頁面的「擷取 SQL 寫入的資訊結構定義」一節。

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

  • 暫時資料庫：在 BigQuery 中輸入資料集，Looker (Google Cloud Core) 會在其中建立持續衍生資料表。您應預先設定這個資料集，並具備適當的寫入權限。如要使用 PDT，就必須填寫這個欄位。

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

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

  • PDT API 控制項：「PDT API 控制項」切換鈕可決定是否能將 start_pdt_build、check_pdt_build 和 stop_pdt_build API 呼叫用於這個連線。如果停用「PDT API 控制」切換鈕，當這些 API 呼叫參照這個連線上的 PDT 時，就會失敗。

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

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

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

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

查看

在「檢閱」部分中，查看並修改您在先前部分輸入的連線詳細資料。

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

儲存並測試連線

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

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

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

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

如果連線未通過一或多項測試，請嘗試下列疑難排解做法：

後續步驟