MySQL、MariaDB 和 SingleStore

使用這些指示的方言

MySQL、MariaDB 和 SingleStore (舊稱 MemSQL) 的資料庫設定需求相同，詳情請參閱本頁說明。

加密網路流量

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

如要使用 SSL 加密，請參閱這篇 MySQL 說明文件頁面。

使用者和安全性

如要建立 Looker 使用者並授予必要存取權，請按照資料庫方言和版本適用的章節操作：

MySQL 8.0.X：

在 MySQL 8.0.X 中，預設的驗證外掛程式為 caching_sha2_password。Looker 會使用 mysql_native_password 外掛程式，嘗試透過 JDBC 驅動程式向 MySQL 資料庫進行驗證。如要讓這個版本的 MySQL 正常運作，請採取下列額外步驟：

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. 執行下列指令，並將 some_password_here 替換為安全無虞的專屬密碼：

   CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'some_password_here';
   GRANT SELECT ON database_name.* TO 'looker'@'%';
   

MySQL 5.7.X 和更早版本、MariaDB 和 SingleStore：

執行下列指令，並將 some_password_here 替換為安全無虞的專屬密碼：

CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('some_password_here');
GRANT SELECT ON database_name.* TO 'looker'@'%';

永久衍生資料表的臨時結構定義設定

這些資料庫方言支援建立永久衍生資料表 (PDT)。這項功能非常實用，建議盡可能啟用。

如要啟用 PDT，請設定暫時性結構定義。下列指令範例說明如何建立暫時資料庫，並授予 looker 使用者所需權限。

建立資料庫連線時，可以在「臨時資料庫」欄位中指定臨時資料庫名稱。如果您未指定暫存資料庫名稱，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+」、「MariaDB」、「SingleStore」或「SingleStore 7+」。

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

4. 如要確認連線是否成功，請按一下「測試」。如需疑難排解資訊，請參閱「測試資料庫連線」說明文件頁面。

5. 如要儲存這些設定，請按一下「連線」。

功能支援

如要讓 Looker 支援某些功能，資料庫方言也必須支援這些功能。

自 Looker 25.10 起，MySQL 支援下列功能：

自 Looker 25.10 起，MySQL 8.0.12 以上版本支援下列功能：

自 Looker 25.10 起，MariaDB 支援下列功能：

自 Looker 25.10 起，SingleStore 支援下列功能：

自 Looker 25.10 起，SingleStore 7 以上版本支援下列功能：