如要查詢資料,請將 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) 連線,請完成額外步驟:
私人連線:如果 Looker (Google Cloud Core) 執行個體使用私人連線,您必須設定 Private Service Connect 或私人服務存取權 (取決於執行個體使用的連線類型),才能將執行個體連線至下列任一類型的資料庫:
- Google Cloud內不同網路中的資料庫
- 由其他雲端服務供應商託管的資料庫
- 地端部署資料庫
如要設定與其他雲端服務供應商託管資料庫的私人連線,請確認 Google Cloud 專案已設定為將流量轉送至這些雲端服務供應商,以便交換資料。如要進一步瞭解如何連結雲端環境,請參閱「將其他雲端服務供應商與 Google Cloud連結的模式」說明文件頁面。
使用 BigQuery 和 Cloud SQL 資料庫的應用程式預設憑證進行驗證:Looker (Google Cloud Core) 執行個體可以使用應用程式預設憑證 (ADC) 向資料庫進行驗證,詳情請參閱下列各節:
使用 OAuth 向 BigQuery 資料庫驗證:如果是 BigQuery 連線,Looker (Google Cloud Core) 可以使用 Looker 管理員建立 Looker (Google Cloud Core) 執行個體時使用的 OAuth 應用程式憑證。詳情請參閱本頁的「使用 BigQuery 設定 OAuth 驗證」一節。
使用應用程式預設憑證連線至 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 專案,都必須具備下列角色:
- 對包含 BigQuery 資料集的專案,具備 BigQuery 資料檢視者 (
roles/bigquery.dataViewer) 角色。 - 在「Connection Settings」(連線設定) 頁面指定的計費專案中,具備 BigQuery 工作使用者 (
roles/bigquery.jobUser) 和服務使用情形消費者 (roles/serviceusage.serviceUsageConsumer) 角色。 - 如果 Looker (Google Cloud Core) 執行個體搭配 BigQuery 使用永久衍生資料表 (PDT):對用於 PDT 的專案或資料集,具備 BigQuery 資料編輯者 (
roles/bigquery.dataEditor) 角色。
使用服務代理的電子郵件地址,在各個目標專案或資料集授予必要角色。如要在 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) 服務帳戶會自動做為鏈結中的第一個服務帳戶,不需要新增至欄位。鏈結中的最後一個服務帳戶 (也稱為「模擬服務帳戶」) 是向資料庫驗證身分的帳戶。
使用服務帳戶模擬功能時,請執行下列操作:
- 啟用 Service Consumer Management API。
- 請確認鏈結中的所有服務帳戶 (包括 Looker (Google Cloud Core) 專案的服務帳戶) 都具備適當的 IAM 權限。
- 請確認模擬的服務帳戶具備 BigQuery 工作使用者角色和 BigQuery 資料檢視者角色。如要檢查服務狀態和作業,或使用消費者專案的配額和帳單,則必須具備服務使用情形消費者角色。
- 如果您已為連線啟用永久衍生資料表 (PDT),則必須在「PDT 覆寫」部分的「服務帳戶電子郵件地址」欄位中,輸入模擬服務帳戶的電子郵件地址。這可確保 PDT 程序使用模擬服務帳戶。詳情請參閱「將 Looker 連結至資料庫」說明文件頁面的「啟用 PDT 覆寫」一節。
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 的一般步驟:
- 將模擬服務帳戶新增至 Cloud SQL 資料庫。
- 在 Cloud SQL 資料庫設定服務帳戶模擬功能。
- 連線至資料庫,為 PostgreSQL 適用的 Cloud SQL 或 MySQL 適用的 Cloud SQL 執行其他設定指令。
- 建立 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 資料庫,以便模擬服務:
- 按照程序啟用 Cloud SQL Admin API。
- 請確認鏈結中的所有服務帳戶 (包括 Looker 服務帳戶) 都具備適當的 IAM 權限。
請按照在 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 到資料庫的連線,請按照下列步驟操作:
- 在 Looker 的「管理」部分,選取「連線」,然後點選「新增連線」。
- 從「Dialect」(方言) 下拉式選單中,選取「Google Cloud PostgreSQL」,或針對 MySQL 適用的 Cloud SQL 選取「Google Cloud SQL」。
- 在「Authentication」(驗證) 部分,按一下「Application Default Credentials」(應用程式預設憑證) 選項。
在「IAM database username(s)」(IAM 資料庫使用者名稱) 欄位中,指定您要 ADC 模擬的服務帳戶或服務帳戶鏈結,以便對資料庫執行動作:
- 如要讓 Looker 使用 Looker (Google Cloud Core) 專案的服務帳戶,向 Cloud SQL 資料庫進行驗證,請將這個欄位留空。
- 如要讓 Looker 使用 Looker (Google Cloud Core) 專案服務帳戶以外的服務帳戶,向 Cloud SQL 資料庫進行驗證,您可以建立委派要求流程,方法是輸入其他服務帳戶,或以半形逗號分隔的服務帳戶鏈。
填寫其餘連線詳細資料。在這些設定中,有絕大部分都是多數資料庫方言的常用設定。詳情請參閱「將 Looker 連線至資料庫」說明文件頁面。
如要確認連線成功,請按一下「連線設定」頁面底部「狀態詳細資料」部分中的「測試連線」按鈕。
如果 Looker 顯示「Can Connect」,請按下「Connect」建立連線。
資料庫連線就會新增至 Looker「連線」管理頁面的清單中。
設定資料庫連線後,即可設定 LookML 專案。
設定 BigQuery 的 OAuth 驗證
如要為 Looker (Google Cloud Core) 執行個體上的 BigQuery 資料庫連線設定 OAuth 驗證,請按照下列步驟操作:
- 在「Authentication」下方,選取「OAuth」。Looker (Google Cloud Core) 預設會使用 Looker 管理員建立 Looker (Google Cloud Core) 執行個體時,所用的 OAuth 應用程式憑證。您不需要手動建立或輸入用戶端 ID 和密鑰。
- 在執行個體的 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 方言的操作說明:
後續步驟
- 設定 Looker (Google Cloud Core) 執行個體
- 管理 Looker (Google Cloud Core) 中的使用者
- 透過 Google Cloud 控制台管理 Looker (Google Cloud Core) 執行個體
- Looker (Google Cloud Core) 管理員設定
- 在 Looker (Google Cloud Core) 執行個體上使用範例 LookML 專案