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+。

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

  • 通訊埠：代理程式的通訊埠。預設連接埠為 8082。如果您的叢集使用 SSL 進行保護，則預設連接埠為 8182。

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

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

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

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

  • 附加 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 Precache」說明文件。

  • 資料庫時區：資料庫時區。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 支援某些功能，資料庫方言也必須支援這些功能。

阿帕契德魯伊

從 Looker 26.16 版本開始，Apache Druid 支援以下功能：

功能 是否支援？
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
毫秒
微秒
具體化檢視表
與前一段時期相比的指標
不重複值的概略計數
資料庫內分析模型
自訂日曆

Apache Druid 0.13.x - 0.17.x

自 Looker 26.16 起，Apache Druid 0.13.x - 0.17.x 支援下列功能：

功能 是否支援？
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
毫秒
微秒
具體化檢視表
與前一段時期相比的指標
不重複值的概略計數
資料庫內分析模型
自訂日曆

Apache Druid 0.18 以上版本

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

功能 是否支援？
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
毫秒
微秒
具體化檢視表
與前一段時期相比的指標
不重複值的概略計數
資料庫內分析模型
自訂日曆

後續步驟

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