Google Spanner

本頁說明如何在 Looker 中設定 Google Spanner 連線。

加密網路流量

最佳做法是加密 Looker 應用程式和資料庫之間的網路流量。請考慮採用「啟用安全的資料庫存取權」說明文件頁面所述的其中一個選項。

取得連線憑證

  1. 登入 Google Cloud 控制台。

  2. 選取適當的專案。

  3. 從選單中依序選取「IAM & Admin」(IAM 與管理) 和「Service accounts」(服務帳戶)。

  4. 選取「建立服務帳戶」，並在對話方塊中填入下列資訊：

    • 「Service account name」(服務帳戶名稱)：輸入 looker-spanner-service 或類似名稱。
    • 「角色」：依序選取「Cloud Spanner」和「Cloud Spanner 資料庫讀取者」。
    • 提供新的私密金鑰：勾選「提供新的私密金鑰」核取方塊，然後在「金鑰類型」下方選取「JSON」。

  5. 按一下「建立」，並記下下列資訊：

    • 與服務帳戶相關聯的電子郵件地址
    • 下載的 JSON 憑證檔案名稱和位置

建立 Looker 與資料庫的連線

在 Looker 的「Admin」(管理) 部分，選取「Connections」(連線)，然後點選「Add Connection」(新增連線)。

填寫連線詳細資料。在這些設定中，有絕大部分都是多數資料庫方言的常用設定。請參閱「將 Looker 連線至資料庫」說明文件頁面。以下說明部分設定：

  • 「Dialect」(方言)：Google Spanner。
  • Name：連線名稱。
  • 專案名稱：包含 Spanner 資料庫的 Google 專案 ID。
  • 執行個體名稱：包含 Spanner 資料庫的執行個體名稱。
  • 資料庫：Spanner 資料庫的名稱。
  • Schema：留空。
  • 個別節點的連線數量上限：所有使用者連至 Spanner 資料庫的連線總數上限。預設值為 30。這項設定一開始可以保留預設值。詳情請參閱「將 Looker 連線至資料庫」說明文件頁面。
  • 連線集區逾時：在連線集區已滿的情況下，查詢要等待幾秒，作業才會逾時。
  • 其他 JDBC 參數：新增任何其他 JDBC 參數。如需支援的參數清單，請參閱本頁的「支援的 JDBC 參數」一節。

如要確認連線成功，請按一下「連線設定」頁面底部「狀態詳細資料」部分中的「測試連線」按鈕。

如果 Looker 顯示「可連線」，請按下「連線」建立連線。

資料庫連線就會新增至 Looker「連線」管理頁面的清單中。

支援的 JDBC 參數

如果是 Google Spanner {: #google}，Looker 支援在連線的「Additional JDBC parameters」(其他 JDBC 參數) 欄位中，使用下列 JDBC 參數。如要瞭解這些參數，請參閱資料庫的說明文件。

  • autocommit
  • autoConfigEmulator
  • endpoint
  • maxSessions
  • minSessions
  • numChannels
  • oauthToken
  • optimizerVersion
  • readonly
  • retryAbortsInternally
  • rpcPriority
  • usePlainText

功能支援

Looker 支援的功能，也必須由資料庫方言支援。

Looker 26.22 起，Google Spanner 支援下列功能：

功能 是否支援？
Looker (Google Cloud Core)
對稱式匯總函式
衍生資料表
永久 SQL 衍生資料表
永久原生衍生資料表
穩定檢視畫面
終止查詢
以 SQL 為基礎的透視表
時區
SSL
小計
JDBC 額外參數
區分大小寫
位置類型
清單類型
百分位數
不重複值的百分位數
SQL Runner 顯示程序
SQL Runner Describe Table
SQL Runner 顯示索引
SQL Runner 選取 10
SQL Runner 計數
SQL 說明
OAuth 2.0 憑證
背景資訊註解
連線集區
HLL Sketch
匯總感知
增量 PDT
毫秒
微秒
materialized view
期間比較指標
不重複值的近似計數
資料庫內分析模型
自訂日曆

參考資料

後續步驟

將資料庫連線至 Looker 後，請為使用者設定登入選項。