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 的「Admin」(管理) 部分,選取「Connections」(連線),然後點選「Add Connection」(新增連線)。

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

  • Name:連線名稱。
  • Dialect:Apache Druid、Apache Druid 0.13+ (Apache Druide 0.13.x - 0.17.x) 或 Apache Druid 0.18+。

  • Host:叢集代理程式的 DNS 或 IP 位址。您可以在 broker/runtime.properties 檔案中找到這項資訊。

  • Port:Broker 的通訊埠。預設通訊埠為 8082。如果叢集受到 SSL 保護,預設通訊埠為 8182。

  • 資料庫:資料庫名稱。預設值為 druid。

  • 使用者名稱:如果 Apache Druid 叢集已設為使用 Druid 基本安全性,請提供資料庫使用者名稱。如果不是,則可指定任何字串。

  • 密碼:使用者密碼。如果叢集未設為使用 Druid 基本安全性,則可指定任何字串。

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

  • 其他 JDBC 參數:以分號分隔的 Avatica JDBC 參數。如要查看 Looker 支援的參數清單,請參閱本頁面的「支援的 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 預先快取說明文件。

  • Database Time Zone:資料庫時區。支援 Apache Druid 0.13+ 和 Apache Druid 0.18+。

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

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

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

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

在 SQL Runner 中測試連線。前往「SQL Runner」,選取連線和結構定義,然後確認是否能看到資料庫資料表。

支援的 JDBC 參數

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

  • authentication
  • avatica_password
  • avatica_user
  • serialization
  • sqlTimeZone
  • timeZone
  • useApproximateCountDistinct
  • useApproximateTopN
  • useFallback
  • url

功能支援

Looker 支援的功能,也必須由資料庫方言支援。

Apache Druid

Looker 26.22 起,Apache Druid 支援下列功能:

功能 是否支援?
Looker (Google Cloud Core)
對稱式匯總函式
衍生資料表
永久 SQL 衍生資料表
永久原生衍生資料表
穩定檢視畫面
終止查詢
以 SQL 為基礎的透視表
時區
SSL
小計
JDBC 額外參數
區分大小寫
位置類型
清單類型
百分位數
不重複值的百分位數
SQL Runner 顯示程序
SQL Runner Describe Table
SQL Runner 顯示索引
SQL Runner 選取 10
SQL Runner 計數
SQL 說明
OAuth 2.0 憑證
背景資訊註解
連線集區
HLL Sketch
匯總感知
增量 PDT
毫秒
微秒
materialized view
期間比較指標
不重複值的近似計數
資料庫內分析模型
自訂日曆

Apache Druid 0.13.x - 0.17.x

自 Looker 26.22 起,Apache Druid 0.13.x - 0.17.x 支援下列功能:

功能 是否支援?
Looker (Google Cloud Core)
對稱式匯總函式
衍生資料表
永久 SQL 衍生資料表
永久原生衍生資料表
穩定檢視畫面
終止查詢
以 SQL 為基礎的透視表
時區
SSL
小計
JDBC 額外參數
區分大小寫
位置類型
清單類型
百分位數
不重複值的百分位數
SQL Runner 顯示程序
SQL Runner Describe Table
SQL Runner 顯示索引
SQL Runner 選取 10
SQL Runner 計數
SQL 說明
OAuth 2.0 憑證
背景資訊註解
連線集區
HLL Sketch
匯總感知
增量 PDT
毫秒
微秒
materialized view
期間比較指標
不重複值的近似計數
資料庫內分析模型
自訂日曆

Apache Druid 0.18+

自 Looker 26.22 起,Apache Druid 0.18 以上版本支援下列功能:

功能 是否支援?
Looker (Google Cloud Core)
對稱式匯總函式
衍生資料表
永久 SQL 衍生資料表
永久原生衍生資料表
穩定檢視畫面
終止查詢
以 SQL 為基礎的透視表
時區
SSL
小計
JDBC 額外參數
區分大小寫
位置類型
清單類型
百分位數
不重複值的百分位數
SQL Runner 顯示程序
SQL Runner Describe Table
SQL Runner 顯示索引
SQL Runner 選取 10
SQL Runner 計數
SQL 說明
OAuth 2.0 憑證
背景資訊註解
連線集區
HLL Sketch
匯總感知
增量 PDT
毫秒
微秒
materialized view
期間比較指標
不重複值的近似計數
資料庫內分析模型
自訂日曆

後續步驟

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