Apache Druid

加密網路流量

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

設定 Apache Druid 叢集

<DRUID_BASE_DIR> 是指 Apache Druid 叢集安裝在伺服器上的基本目錄。

啟用 SQL

如要在 Druid 資料庫上啟用 SQL，請在 broker/runtime.properties 設定檔中加入這行程式碼：

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

druid.sql.enable=true

關閉「COUNT DISTINCT」近似值 (選用)

根據預設，Druid 會估算 COUNT DISTINCT。如要取得精確結果，請在 broker/runtime.properties 設定檔中新增下列程式碼：

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

`druid.sql.planner.useApproximateCountDistinct=false`

建立 Looker 資料庫連線

在 Looker 的「管理」部分中，選取「連線」，然後按一下「新增連線」。

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

• 名稱：連線名稱。

• 方言：Apache Druid、Apache Druid 0.13 以上版本 (Apache Druid 0.13.x - 0.17.x) 或 Apache Druid 0.18 以上版本。

• 主機：叢集 Broker 的 DNS 或 IP 位址。你可以在 broker/runtime.properties 檔案中找到這項資訊。

• 通訊埠：代理程式的通訊埠。預設通訊埠為 8082。如果叢集受到 SSL 保護，預設通訊埠為 8182。

• 「Database」(資料庫)：資料庫名稱。預設值為 druid。

• 使用者名稱：如果 Apache Druid 叢集已設定為使用 Druid Basic Security，請輸入資料庫使用者名稱。如果不是，則可以指定任何字串。

• 密碼：使用者密碼。如果叢集未設為使用 Druid Basic Security，則可以指定任何字串。

• 結構定義：未指定結構定義時要使用的預設結構定義。您可以選擇是否要輸入結構定義。

• 其他 JDBC 參數：以半形分號分隔的 Avatica JDBC 參數。

  • 這些屬性可以設為連線屬性：
    • useApproximateCountDistinct
    • useApproximateTopN
    • useFallback
    • sqlTimeZone

  例如： none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

• 維護時間表：cron 運算式，指出 Looker 應在何時檢查資料群組和永久衍生資料表。如要進一步瞭解這項設定，請參閱「維護時間表」說明文件。

• SSL：檢查 Apache Druid 叢集是否已設定為使用 Druid TLS。

• 驗證 SSL：勾選此方塊可強制執行嚴格的主機名稱驗證。

• 每個節點的連線數量上限：預設為 25。這項設定一開始可以保留預設值。詳情請參閱「將 Looker 連線至資料庫」說明文件頁面。

• 連線集區逾時：預設為 120 秒。

• SQL Runner 預先快取：如要讓 SQL Runner 不預先載入資料表資訊，只在選取資料表時載入，請取消勾選這個選項。如要進一步瞭解這項設定，請參閱「SQL Runner Precache」說明文件。

• 資料庫時區：資料庫時區。Apache Druid 0.13 以上版本和 Apache Druid 0.18 以上版本均支援此功能。

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

Looker 會執行 SELECT 1 查詢，驗證基本連線並執行查詢測試。這項作業不會驗證目錄和結構定義組合是否存在，也不會驗證使用者是否具備該結構定義的必要存取權。

如有任何問題，請參閱「測試連線」說明文件。

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

在 SQL Runner 中測試連線。前往 SQL Runner，選取連線和結構定義，然後檢查是否能看到資料庫表格。

功能支援

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

Apache Druid

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

Apache Druid 0.13 以上版本 (Apache Druid 0.13.x - 0.17.x)

自 Looker 25.10 起，Apache Druid 0.13 以上版本支援下列功能：

Apache Druid 0.18 以上版本

自 Looker 25.10 起，Apache Druid 0.18 以上版本支援下列功能：

後續步驟

完成資料庫連線後，請設定驗證選項。