MySQL、MariaDB 和 SingleStore

使用這些指令的方言

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 進行驗證:

    1. 視部署方式而定,請使用下列其中一種方法設定 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 資料庫旗標或參數,請在執行個體設定或參數群組中啟用,並視需要重新啟動資料庫執行個體。如需設定詳細資料,請參閱雲端服務供應商的說明文件。

    2. 使用 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 正常運作,請完成下列步驟:

  1. 將 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 參數。
  2. 執行下列指令,並將 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 到資料庫的連線:

  1. 在 Looker 的「管理」部分,選取「連線」,然後點選「新增連線」。
  2. 從「Dialect」下拉式選單中,選取資料庫方言名稱:「MySQL」、「MySQL 8.0.12+」(適用於 MySQL 8.0.12 和後續 8.X 版本,包括 MySQL 8.4.X)、「MariaDB」、「SingleStore」或「SingleStore 7+」。

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

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

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

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

支援的 JDBC 參數

針對 MySQL、MariaDB 和 SingleStore,Looker 支援在連線的「其他 JDBC 參數」欄位中使用下列 JDBC 參數。如要瞭解這些參數,請參閱資料庫的說明文件。

  • allowMultiQueries
  • autocommit
  • characterSetResults
  • clientCertificateKeyStorePassword
  • clientCertificateKeyStoreUrl
  • connectionAttributes
  • connectionCollation
  • connectionTimeZone
  • connectTimeout
  • defaultAuthenticationPlugin
  • disableSslHostnameVerification
  • disconnectOnExpiredPasswords
  • enabledSslCipherSuites
  • failOverReadOnly
  • fallbackToSystemTrustStore
  • forceConnectionTimeZoneToSession
  • interactiveClient
  • lookerFailover
  • maxIdleTime
  • maxQuerySizeToLog
  • oldModeNoPrecisionTimestamp
  • password
  • passwordCharacterEncoding
  • permitMysqlScheme
  • pinGlobalTxToPhysicalConnection
  • preserveInstants
  • queryInterceptors
  • restrictedAuth
  • rewriteBatchedStatements
  • socketTimeout
  • sslMode
  • tcpKeepAlive
  • trustCertificateKeyStorePassword
  • trustCertificateKeyStoreUrl
  • useCompression
  • usePipelineAuth
  • user
  • useServerPrepStmts
  • verifyServerCertificate
  • yearIsDateType

功能支援

資料庫方言也必須支援 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
期間比較指標
近似不重複值的計數
資料庫內分析模型
自訂日曆