使用這些指令的方言
MySQL、MariaDB 和 SingleStore (舊稱 MemSQL) 採用相同的資料庫設定需求,如本頁所述,用於將 Looker 連結至數據分析資料庫。如要將 MySQL 設為客戶託管 Looker 執行個體的內部後端資料庫,請參閱「將 Looker 後端資料庫遷移至 MySQL」。
加密網路流量
建議您加密 Looker 應用程式和資料庫之間的網路流量。請考慮採用「啟用安全的資料庫存取權」說明文件頁面所述的其中一個選項。
如要使用 SSL 加密,請參閱這份 MySQL 說明文件頁面。
使用者與安全性
如要建立 Looker 使用者並授予必要存取權,請按照資料庫方言和版本對應章節的指示操作。
MySQL 8.4.X
在 MySQL 8.4.X 中,預設驗證外掛程式為 caching_sha2_password,mysql_native_password 外掛程式則預設為停用。根據 Looker 連線是否啟用 SSL,選擇下列其中一種驗證方式:
在啟用 SSL 的情況下連線 (建議):Looker JDBC 驅動程式支援透過 SSL 連線使用
caching_sha2_password,不需啟用mysql_native_password。建立 Looker 連線時,請選取「SSL」SSL,然後執行下列指令來建立使用者並授予SELECT權限:CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH caching_sha2_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';未啟用 SSL 連線時:Looker 不會在未加密的客戶資料庫連線上,自動擷取 RSA 公開金鑰 (
allowPublicKeyRetrieval),因此您必須使用mysql_native_password進行驗證:視部署方式而定,請使用下列其中一種方法設定 MySQL 8.4.X 伺服器,啟用
mysql_native_password外掛程式:- 使用
--mysql-native-password=ON旗標啟動 MySQL 伺服器。 在
my.cnf設定檔中設定屬性:[mysqld] mysql_native_password=ON如果 Google Cloud、AWS 或 Azure 上的雲端託管 MySQL 8.4.X 執行個體未預設啟用
mysql_native_password資料庫旗標或參數,請在執行個體設定或參數群組中啟用,並視需要重新啟動資料庫執行個體。如需設定詳細資料,請參閱雲端服務供應商的說明文件。
- 使用
使用
mysql_native_password建立資料庫使用者,並授予SELECT權限:CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
請替換上述指令中的下列預留位置:
- DB_USERNAME:Looker 資料庫使用者的使用者名稱,例如
looker - PASSWORD:不重複的安全密碼
- DATABASE_NAME:資料庫名稱
MySQL 8.0.X
在 MySQL 8.0.X 中,預設驗證外掛程式為 caching_sha2_password。Looker 會使用 mysql_native_password 外掛程式,透過 JDBC 驅動程式向 MySQL 8.0.X 資料庫進行驗證。如要讓 MySQL 8.0.X 正常運作,請完成下列步驟:
將 MySQL 資料庫設為使用
mysql_native_password外掛程式。您可以透過多種方式完成這項操作,具體取決於 MySQL 8 資料庫的部署方式,以及您對設定的存取權類型:使用
--default-auth=mysql_native_password旗標啟動程序在
my.cnf設定檔中設定屬性:
[mysqld] default-authentication-plugin=mysql_native_password- 如果資料庫執行個體是透過 AWS RDS 代管,請透過套用至這個資料庫執行個體的 RDS 參數群組,設定
default_authentication_plugin參數。
執行下列指令,並將
PASSWORD替換為不重複的安全密碼:CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON database_name.* TO 'looker'@'%';
MySQL 5.7.X 以下版本、MariaDB 和 SingleStore:
執行下列指令,並將 PASSWORD 替換為不重複的安全密碼:
CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('PASSWORD');
GRANT SELECT ON database_name.* TO 'looker'@'%';
永久衍生資料表的臨時結構定義設定
這些資料庫方言支援建立永久衍生資料表 (PDT)。這項功能非常實用,建議您盡可能啟用。
如要啟用 PDT,您必須設定臨時結構定義。下列指令示範如何建立臨時資料庫,並將必要權限授予 looker 使用者。
建立資料庫連線時,您可以在「Temp Database」(臨時資料庫) 欄位中指定臨時資料庫的名稱。如未指定暫存資料庫名稱,Looker 會產生名為
looker_tmp的臨時資料庫。下列指令使用looker_tmp,但如果您指定了其他暫存資料庫名稱,請使用該名稱,而非looker_tmp。
CREATE SCHEMA looker_tmp;
GRANT
SELECT,
INDEX,
INSERT,
UPDATE,
DELETE,
CREATE,
DROP,
ALTER,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
如果是 SingleStore,或資料庫使用以 GTID 為基礎的複製功能,則必須使用 create_process LookML 參數才能使用 PDT,因為 GTID 不支援 CREATE TABLE AS SELECT 陳述式。
一般衍生資料表的替代設定
如果不想允許建立永久衍生資料表,仍可使用一般衍生資料表。如要使用一般衍生資料表,您仍須為名為 looker_tmp 的結構定義新增特定權限。不過,資料庫中不一定要有 looker_tmp 結構定義!
GRANT
SELECT,
INDEX,
INSERT,
DROP,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
-- Note that the looker_tmp schema does not need to actually exist,
-- even though these permission grants are still needed
設定 max_allowed_packet 變數
如果是 MySQL,請將 MySQL max_allowed_packet 變數設為最大值 1073741824,以免發生「SQLException: Packet for query is too large」錯誤。
建立 Looker 與資料庫的連線
完成資料庫設定後,即可從 Looker 連線至資料庫。請按照下列步驟,建立 Looker 到資料庫的連線:
- 在 Looker 的「管理」部分,選取「連線」,然後點選「新增連線」。
從「Dialect」下拉式選單中,選取資料庫方言名稱:「MySQL」、「MySQL 8.0.12+」(適用於 MySQL 8.0.12 和後續 8.X 版本,包括 MySQL 8.4.X)、「MariaDB」、「SingleStore」或「SingleStore 7+」。
填寫連線詳細資料。在這些設定中,有絕大部分都是多數資料庫方言的常用設定。詳情請參閱「將 Looker 連線至資料庫」說明文件頁面。
如要確認連線成功,請按一下「連線設定」頁面底部「狀態詳細資料」部分中的「測試連線」按鈕。
如果 Looker 顯示「可連線」,請按下「連線」建立連線。
資料庫連線就會新增至 Looker「連線」管理頁面的清單中。
支援的 JDBC 參數
針對 MySQL、MariaDB 和 SingleStore,Looker 支援在連線的「其他 JDBC 參數」欄位中使用下列 JDBC 參數。如要瞭解這些參數,請參閱資料庫的說明文件。
allowMultiQueriesautocommitcharacterSetResultsclientCertificateKeyStorePasswordclientCertificateKeyStoreUrlconnectionAttributesconnectionCollationconnectionTimeZoneconnectTimeoutdefaultAuthenticationPlugindisableSslHostnameVerificationdisconnectOnExpiredPasswordsenabledSslCipherSuitesfailOverReadOnlyfallbackToSystemTrustStoreforceConnectionTimeZoneToSessioninteractiveClientlookerFailovermaxIdleTimemaxQuerySizeToLogoldModeNoPrecisionTimestamppasswordpasswordCharacterEncodingpermitMysqlSchemepinGlobalTxToPhysicalConnectionpreserveInstantsqueryInterceptorsrestrictedAuthrewriteBatchedStatementssocketTimeoutsslModetcpKeepAlivetrustCertificateKeyStorePasswordtrustCertificateKeyStoreUrluseCompressionusePipelineAuthuseruseServerPrepStmtsverifyServerCertificateyearIsDateType
功能支援
資料庫方言也必須支援 Looker 的某些功能,Looker 才能支援這些功能。
MySQL 支援下列功能 (自 Looker 26.22 起):
| 功能 | 是否支援? |
|---|---|
| Looker (Google Cloud Core) | |
| 對稱式匯總函式 | |
| 衍生資料表 | |
| 永久 SQL 衍生資料表 | |
| 永久原生衍生資料表 | |
| 穩定檢視畫面 | |
| 終止查詢 | |
| 以 SQL 為基礎的透視表 | |
| 時區 | |
| SSL | |
| 小計 | |
| JDBC 額外參數 | |
| 區分大小寫 | |
| 位置類型 | |
| 清單類型 | |
| 百分位數 | |
| 不重複值的百分位數 | |
| SQL Runner 顯示程序 | |
| SQL Runner 說明資料表 | |
| SQL Runner 顯示索引 | |
| SQL Runner 選取 10 | |
| SQL Runner 計數 | |
| SQL 說明 | |
| OAuth 2.0 憑證 | |
| 背景資訊註解 | |
| 連線集區 | |
| HLL 草圖 | |
| 匯總感知 | |
| 增量 PDT | |
| 毫秒 | |
| 微秒 | |
| materialized view | |
| 期間比較指標 | |
| 近似不重複值的計數 | |
| 資料庫內分析模型 | |
| 自訂日曆 |
自 Looker 26.22 起,MySQL 8.0.12 以上版本支援下列功能:
| 功能 | 是否支援? |
|---|---|
| Looker (Google Cloud Core) | |
| 對稱式匯總函式 | |
| 衍生資料表 | |
| 永久 SQL 衍生資料表 | |
| 永久原生衍生資料表 | |
| 穩定檢視畫面 | |
| 終止查詢 | |
| 以 SQL 為基礎的透視表 | |
| 時區 | |
| SSL | |
| 小計 | |
| JDBC 額外參數 | |
| 區分大小寫 | |
| 位置類型 | |
| 清單類型 | |
| 百分位數 | |
| 不重複值的百分位數 | |
| SQL Runner 顯示程序 | |
| SQL Runner 說明資料表 | |
| SQL Runner 顯示索引 | |
| SQL Runner 選取 10 | |
| SQL Runner 計數 | |
| SQL 說明 | |
| OAuth 2.0 憑證 | |
| 背景資訊註解 | |
| 連線集區 | |
| HLL 草圖 | |
| 匯總感知 | |
| 增量 PDT | |
| 毫秒 | |
| 微秒 | |
| materialized view | |
| 期間比較指標 | |
| 近似不重複值的計數 | |
| 資料庫內分析模型 | |
| 自訂日曆 |
MariaDB 支援下列功能 (自 Looker 26.22 起):
| 功能 | 是否支援? |
|---|---|
| Looker (Google Cloud Core) | |
| 對稱式匯總函式 | |
| 衍生資料表 | |
| 永久 SQL 衍生資料表 | |
| 永久原生衍生資料表 | |
| 穩定檢視畫面 | |
| 終止查詢 | |
| 以 SQL 為基礎的透視表 | |
| 時區 | |
| SSL | |
| 小計 | |
| JDBC 額外參數 | |
| 區分大小寫 | |
| 位置類型 | |
| 清單類型 | |
| 百分位數 | |
| 不重複值的百分位數 | |
| SQL Runner 顯示程序 | |
| SQL Runner 說明資料表 | |
| SQL Runner 顯示索引 | |
| SQL Runner 選取 10 | |
| SQL Runner 計數 | |
| SQL 說明 | |
| OAuth 2.0 憑證 | |
| 背景資訊註解 | |
| 連線集區 | |
| HLL 草圖 | |
| 匯總感知 | |
| 增量 PDT | |
| 毫秒 | |
| 微秒 | |
| materialized view | |
| 期間比較指標 | |
| 近似不重複值的計數 | |
| 資料庫內分析模型 | |
| 自訂日曆 |
自 Looker 26.22 起,SingleStore 支援下列功能:
| 功能 | 是否支援? |
|---|---|
| Looker (Google Cloud Core) | |
| 對稱式匯總函式 | |
| 衍生資料表 | |
| 永久 SQL 衍生資料表 | |
| 永久原生衍生資料表 | |
| 穩定檢視畫面 | |
| 終止查詢 | |
| 以 SQL 為基礎的透視表 | |
| 時區 | |
| SSL | |
| 小計 | |
| JDBC 額外參數 | |
| 區分大小寫 | |
| 位置類型 | |
| 清單類型 | |
| 百分位數 | |
| 不重複值的百分位數 | |
| SQL Runner 顯示程序 | |
| SQL Runner 說明資料表 | |
| SQL Runner 顯示索引 | |
| SQL Runner 選取 10 | |
| SQL Runner 計數 | |
| SQL 說明 | |
| OAuth 2.0 憑證 | |
| 背景資訊註解 | |
| 連線集區 | |
| HLL 草圖 | |
| 匯總感知 | |
| 增量 PDT | |
| 毫秒 | |
| 微秒 | |
| materialized view | |
| 期間比較指標 | |
| 近似不重複值的計數 | |
| 資料庫內分析模型 | |
| 自訂日曆 |
自 Looker 26.22 起,SingleStore 7 以上版本支援下列功能:
| 功能 | 是否支援? |
|---|---|
| Looker (Google Cloud Core) | |
| 對稱式匯總函式 | |
| 衍生資料表 | |
| 永久 SQL 衍生資料表 | |
| 永久原生衍生資料表 | |
| 穩定檢視畫面 | |
| 終止查詢 | |
| 以 SQL 為基礎的透視表 | |
| 時區 | |
| SSL | |
| 小計 | |
| JDBC 額外參數 | |
| 區分大小寫 | |
| 位置類型 | |
| 清單類型 | |
| 百分位數 | |
| 不重複值的百分位數 | |
| SQL Runner 顯示程序 | |
| SQL Runner 說明資料表 | |
| SQL Runner 顯示索引 | |
| SQL Runner 選取 10 | |
| SQL Runner 計數 | |
| SQL 說明 | |
| OAuth 2.0 憑證 | |
| 背景資訊註解 | |
| 連線集區 | |
| HLL 草圖 | |
| 匯總感知 | |
| 增量 PDT | |
| 毫秒 | |
| 微秒 | |
| materialized view | |
| 期間比較指標 | |
| 近似不重複值的計數 | |
| 資料庫內分析模型 | |
| 自訂日曆 |