將 Looker (Google Cloud Core) 連線至資料庫

如要查詢資料,請將 Looker (Google Cloud Core) 執行個體連結至資料庫。本指南說明如何使用支援的方言,以及設定特定連線選項。

如果執行個體使用私人連線,您可能需要完成額外設定,才能存取資料庫。具體設定取決於您使用的 Looker (Google Cloud Core) 執行個體網路設定。

設定資料庫連線

Looker (Google Cloud Core) 必須連線至資料庫,才能啟用資料探索功能。請參閱支援的方言清單,瞭解 Looker (Google Cloud Core) 支援哪些方言。

如果您具備下列任一權限,即可在 Looker (Google Cloud Core) 執行個體中建立資料庫連線:

您可以按照 Looker (Google Cloud Core) 執行個體中動態顯示的「設定 Looker」指南連結資料庫,也可以按照方言專屬說明文件頁面列出的步驟操作。在這些設定中,有絕大部分都是多數資料庫方言的常用設定。如要瞭解 Looker 連線設定視窗中的常見欄位,請參閱「將 Looker 連線至資料庫」說明文件頁面。

如要使用下列任一選項設定 Looker (Google Cloud Core) 連線,請完成額外步驟:

使用應用程式預設憑證連線至 BigQuery 資料庫

設定連線至 BigQuery 標準 SQL 資料庫時,Looker (Google Cloud Core) 執行個體可以使用 ADC 進行驗證。除非您設定服務帳戶模擬,否則 ADC 會使用 Looker 服務代理 (也稱為 Looker 服務帳戶) 的憑證向資料庫驗證。

設定使用 Looker 服務代理的連線前,請先授予服務代理必要的 IAM 角色,詳情請參閱「為使用 ADC 的 BigQuery 連線授予 IAM 角色」。

授予必要角色後,請在 Looker (Google Cloud Core) 執行個體的「Connection Settings」(連線設定) 頁面,選取「Authentication」(驗證) 欄位中的「Application Default Credentials」(應用程式預設憑證)。如需完整的連線設定程序,請參閱將 Looker 連結至 BigQuery 資料庫的說明文件。

為使用 ADC 的 BigQuery 連線授予 IAM 角色

根據預設,Looker 服務代理不具備 BigQuery 權限,即使在託管 Looker (Google Cloud Core) 執行個體的 Google Cloud 專案中也是如此。詳情請參閱「Looker (Google Cloud Core) 服務代理權限安全性更新」。

除非您設定服務帳戶模擬,否則請先將下列 IAM 角色授予 Looker 服務代理,再設定連線。無論 BigQuery 資料集與 Looker (Google Cloud Core) 執行個體是否位於同一個 Google Cloud 專案,都必須具備下列角色:

使用服務代理的電子郵件地址,在各個目標專案或資料集授予必要角色。如要在 Google Cloud 控制台查看服務代理的電子郵件地址,請前往託管 Looker (Google Cloud Core) 執行個體的專案「IAM」頁面,然後勾選「包含 Google 提供的角色授權」核取方塊。如要瞭解查看服務代理的其他方式,請參閱「Looker 服務帳戶」。電子郵件地址的格式為 service-PROJECT_NUMBER@gcp-sa-looker.iam.gserviceaccount.com,其中 PROJECT_NUMBER 是託管 Looker (Google Cloud Core) 執行個體的專案編號。

授予必要角色後,請按照「使用應用程式預設憑證連線至 BigQuery 資料庫」一文所述設定連線。您在「Connection Settings」(連線設定) 頁面指定的計費專案會用於查詢計費,並做為連線的預設專案。

服務帳戶模擬

如要使用 Looker (Google Cloud Core) 專案服務帳戶以外的服務帳戶,向 BigQuery 資料庫進行驗證,您可以在「模擬服務帳戶」欄位中輸入其他服務帳戶,或以半形逗號分隔的服務帳戶鏈結,建立委派要求流程。Looker (Google Cloud Core) 服務帳戶會自動做為鏈結中的第一個服務帳戶,不需要新增至欄位。鏈結中的最後一個服務帳戶 (也稱為「模擬服務帳戶」) 是向資料庫驗證身分的帳戶。

使用服務帳戶模擬功能時,請執行下列操作:

BigQuery 政策標記和動態資料遮蓋

Looker (Google Cloud Core) 使用 ADC 或服務帳戶連線至 BigQuery 時,BigQuery 不會收到個別 Looker 使用者憑證。由於 BigQuery 只會為所有查詢辨識一個身分,因此內建的 BigQuery 資料欄層級安全防護機制 (政策標記和資料遮蓋) 無法為每位 Looker 使用者套用不同的存取權或遮蓋規則。

如要透過 Looker (Google Cloud Core) 和 BigQuery 實作動態資料遮罩,請考慮下列其中一種架構選項:

  • 應用程式層遮蓋 (支援 ADC 和服務帳戶):維持使用 ADC 或服務帳戶的單一資料庫連線,並在 LookML 語意層中套用資料遮蓋邏輯,方法是使用由使用者屬性驅動的 LookML CASE WHEN 陳述式,這些屬性會從識別資訊提供者對應。
  • 資料庫層遮蓋 (需要 OAuth):將 Looker 到 BigQuery 的連線設定為使用 OAuth,而非 ADC。OAuth 會將每位使用者的個別憑證直接傳遞至 BigQuery,讓 BigQuery 原生評估並強制執行每位使用者的政策標記和資料遮蓋規則。

使用應用程式預設憑證連線至 Cloud SQL 資料庫

Looker (Google Cloud Core) 執行個體可使用 ADC,驗證與 Cloud SQL 資料庫 (PostgreSQL 適用的 Cloud SQL 或 MySQL 適用的 Cloud SQL) 的連線。使用 ADC 驗證 Cloud SQL 資料庫時,Looker 查詢費用會計入 Cloud SQL 資料庫執行所在的 Google Cloud 專案。

如果 Looker 連線至 Cloud SQL 時使用 ADC,ADC 會模擬服務帳戶或服務帳戶鏈結,存取資料庫。建立 Looker 與資料庫的連線時,請使用「IAM database username(s)」欄位,指定 ADC 要模擬的服務帳戶或服務帳戶鏈。建立 Looker (Google Cloud Core) 執行個體時,系統會自動建立 Looker 服務帳戶,並自動將其做為鏈結中的第一個服務帳戶,因此您不需要將其新增至欄位。

如要使用 Looker 服務帳戶以外的服務帳戶,向 Cloud SQL 資料庫進行驗證,您可以建立委派要求流程,方法是在「IAM 資料庫使用者名稱」欄位中,輸入其他服務帳戶,或以半形逗號分隔的服務帳戶鏈。

鏈結中的最後一個服務帳戶 (也稱為「模擬服務帳戶」) 是向資料庫驗證身分的帳戶,必須新增為 Cloud SQL 資料庫的使用者。如果您將 Looker 服務帳戶做為鏈結中的最後一個服務帳戶 (將「IAM database username(s)」(IAM 資料庫使用者名稱) 欄位留空),則必須將 Looker 服務帳戶新增為 Cloud SQL 資料庫的使用者。

以下是使用 ADC 將 PostgreSQL 適用的 Cloud SQL 或 MySQL 適用的 Cloud SQL 資料庫連結至 Looker 的一般步驟:

  1. 將模擬服務帳戶新增至 Cloud SQL 資料庫。
  2. 在 Cloud SQL 資料庫設定服務帳戶模擬功能。
  3. 連線至資料庫,為 PostgreSQL 適用的 Cloud SQL 或 MySQL 適用的 Cloud SQL 執行其他設定指令。
  4. 建立 Looker 與資料庫的連線。

將模擬服務帳戶新增至 Cloud SQL 資料庫

建立 Looker 與資料庫的連線時,請使用「IAM 資料庫使用者名稱」欄位指定服務帳戶或服務帳戶鏈結,ADC 會模擬該帳戶,在資料庫執行動作。模擬鏈結中的最後一個服務帳戶,會視為模擬服務帳戶。

如要搭配使用 ADC 和 Cloud SQL,您必須將模擬服務帳戶新增至 Cloud SQL 資料庫:

  • 在預設情況下,如果將「IAM 資料庫使用者名稱」欄位留空,ADC 會模擬 Looker 服務帳戶。在本例中,Looker 服務帳戶是模擬服務帳戶,因此您必須將 Looker 服務帳戶新增至 Cloud SQL 資料庫。如要瞭解 Looker 服務帳戶,以及查看 Looker 服務帳戶電子郵件地址的程序,請參閱「建立 Looker (Google Cloud Core) 執行個體」說明文件頁面。
  • 如果您指定 Looker 服務帳戶以外的服務帳戶,或是在「IAM database username(s)」(IAM 資料庫使用者名稱) 欄位中指定服務帳戶鏈結,則必須將模擬鏈結中的最後一個服務帳戶新增至 Cloud SQL 資料庫。

如要將服務帳戶新增至 Cloud SQL 資料庫,您必須具備 Cloud SQL 管理員 IAM 角色。

按照資料庫方言的「將 IAM 使用者或服務帳戶新增至資料庫執行個體」程序,將模擬服務帳戶新增至 Cloud SQL 資料庫:

在 Cloud SQL 資料庫設定服務帳戶模擬功能

在資料庫建立 Cloud SQL 使用者後,您必須按照下列步驟,設定 Cloud SQL 資料庫,以便模擬服務:

  1. 按照程序啟用 Cloud SQL Admin API。
  2. 請確認鏈結中的所有服務帳戶 (包括 Looker 服務帳戶) 都具備適當的 IAM 權限。
  3. 請按照在 Google Cloud 控制台中授予單一角色的程序操作。將下列 Cloud SQL 角色授予您新增至 Cloud SQL 資料庫的模擬服務帳戶:

    如果您指定 Looker 服務帳戶以外的服務帳戶,或是在「IAM database username(s)」欄位中指定服務帳戶鏈結,請將下列權限授予鏈結中的每個服務帳戶:

MySQL 適用的 Cloud SQL 額外設定指令

如果是 MySQL 適用的 Cloud SQL,您必須連線至資料庫執行個體,並在 MySQL 適用的 Cloud SQL 資料庫執行下列指令:

GRANT ALL on DATABASE_NAME.* to 'DATABASE_USER'@'%'

更改下列內容:

  • DATABASE_NAME:資料庫名稱。
  • DATABASE_USER:模擬服務帳戶的截斷服務帳戶使用者名稱,該帳戶是您新增至 Cloud SQL 資料庫的帳戶。服務帳戶的格式為 service-<project number>@gcp-sa-looker.iam.gserviceaccount.com。移除 @ 和後續所有內容,截斷使用者名稱。截斷後,使用者名稱會顯示為 service-<project number>。

舉例來說,如果服務帳戶使用者名稱是 service-12345678901@gcp-sa-looker.iam.gserviceaccount.com,資料庫名稱是 looker-test,指令如下:

GRANT ALL on looker-test.* to 'service-12345678901'@'%'

PostgreSQL 適用的 Cloud SQL 額外設定指令

如果是 PostgreSQL 適用的 Cloud SQL,您必須連線至資料庫執行個體,並在 PostgreSQL 適用的 Cloud SQL 資料庫執行下列設定指令:

  • 按照 PostgreSQL 說明文件頁面「使用者和安全性」一節所述,授予使用者資料庫權限。
  • 設定 Looker SQL Runner 的搜尋路徑,用於從資料庫擷取中繼資料,詳情請參閱 Looker 說明文件的 PostgreSQL 頁面中「設定 search_path」一節。

建立從 Looker (Google Cloud Core) 到 Cloud SQL 資料庫的連線

如要建立從 Looker 到資料庫的連線,請按照下列步驟操作:

  1. 在 Looker 的「管理」部分,選取「連線」,然後點選「新增連線」。
  2. 從「Dialect」(方言) 下拉式選單中,選取「Google Cloud PostgreSQL」,或針對 MySQL 適用的 Cloud SQL 選取「Google Cloud SQL」。
  3. 在「Authentication」(驗證) 部分,按一下「Application Default Credentials」(應用程式預設憑證) 選項。
  4. 在「IAM database username(s)」(IAM 資料庫使用者名稱) 欄位中,指定您要 ADC 模擬的服務帳戶或服務帳戶鏈結,以便對資料庫執行動作:

    • 如要讓 Looker 使用 Looker (Google Cloud Core) 專案的服務帳戶,向 Cloud SQL 資料庫進行驗證,請將這個欄位留空。
    • 如要讓 Looker 使用 Looker (Google Cloud Core) 專案服務帳戶以外的服務帳戶,向 Cloud SQL 資料庫進行驗證,您可以建立委派要求流程,方法是輸入其他服務帳戶,或以半形逗號分隔的服務帳戶鏈。
  5. 填寫其餘連線詳細資料。在這些設定中,有絕大部分都是多數資料庫方言的常用設定。詳情請參閱「將 Looker 連線至資料庫」說明文件頁面。

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

  7. 如果 Looker 顯示「Can Connect」,請按下「Connect」建立連線。

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

設定資料庫連線後,即可設定 LookML 專案。

設定 BigQuery 的 OAuth 驗證

如要為 Looker (Google Cloud Core) 執行個體上的 BigQuery 資料庫連線設定 OAuth 驗證,請按照下列步驟操作:

  1. 在「Authentication」下方,選取「OAuth」。Looker (Google Cloud Core) 預設會使用 Looker 管理員建立 Looker (Google Cloud Core) 執行個體時,所用的 OAuth 應用程式憑證。您不需要手動建立或輸入用戶端 ID 和密鑰。
  2. 在執行個體的 OAuth 用戶端中,將其他重新導向 URI 新增至「已授權的重新導向 URI」欄位 (或使用憑證建立新的 OAuth 用戶端,並新增重新導向 URI)。重新導向 URI 必須使用 Looker 執行個體的網址,後面加上 /external_oauth/redirect。如需背景資訊,請參閱為 BigQuery 產生 OAuth 憑證的說明文件。

如要手動輸入這個連線的其他 OAuth 憑證,請啟用「手動設定 OAuth 憑證」切換按鈕,然後填寫「OAuth 用戶端 ID」和「OAuth 用戶端密鑰」欄位。手動輸入 OAuth 憑證,不會變更或更新建立 Looker (Google Cloud Core) 執行個體時使用的憑證。請按照「為 OAuth 設定 BigQuery 資料庫專案」說明文件中的步驟,建立及使用不同的憑證。

Looker (Google Cloud Core) 支援的方言

下表列出 Looker (Google Cloud Core) 支援的資料庫方言:

方言 是否支援?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13.x - 0.17.x
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
ClickHouse 26+
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Dremio 26+ with Arrow Flight SQL
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud AlloyDB for PostgreSQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MongoSQL
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica

資料庫設定操作說明

下列 SQL 方言的操作說明:

後續步驟