ClickHouse

將 Looker 連線至 ClickHouse 資料庫，分析資料並建構互動式資訊主頁。建立連線後，您就能在 Looker 中使用 ClickHouse 資料製作報表和進行分析，直接根據資料做出決策。

本頁面會逐步說明如何設定 ClickHouse 執行個體和 Looker 連線設定，包括如何加密網路流量、定義使用者權限，以及查看支援的功能。Looker 支援 ClickHouse 0.2 以上版本。

加密網路流量

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

如要在伺服器端啟用 SSL 加密，請參閱 ClickHouse 全域伺服器設定說明文件。

使用者和安全性

首先，請在 ClickHouse 伺服器上設定 Looker 使用者。系統不會使用 CREATE USER 指令建立 ClickHouse 資料庫使用者。請依照ClickHouse 存取權文件配置users.xml文件中的users部分。基本範例如下：

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

此外，請在這個檔案中設定適當的資料庫存取權。

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

建立 Looker 資料庫連線

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

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

  • 方言：ClickHouse。
  • 主機：可連線的主機名稱。
  • 通訊埠：ClickHouse 服務可透過 HTTP(S) 連線的通訊埠。
    • 根據預設，HTTP 連線會使用 8123，HTTPS 則會使用 8443。
    • ClickHouse 指令列用戶端預設使用通訊埠 9000 和 9440，但 Looker 無法使用這些通訊埠連線至 ClickHouse。
    • ClickHouse 管理員可能已在 ClickHouse 設定中，透過 http_port/https_port 設定選擇替代連接埠。請向 ClickHouse 管理員索取適合您本機設定的設定。
  • 資料庫：資料庫名稱 (必須是 users.xml 檔案中允許的資料庫之一)。
  • 使用者名稱：資料庫使用者名稱。
  • 密碼：資料庫密碼。

  • 其他 JDBC 參數：(選用) 其他 JDBC 字串參數。如需 Looker 支援的參數清單，請參閱本頁面的「支援的 JDBC 參數」一節。

  • 維護時間表：ClickHouse 不支援 PDT，因此可以忽略這項設定。

  • SSL：勾選這個選項，即可透過 SSL 連線至 ClickHouse。

  • 驗證 SSL：(選用) 勾選這個選項，在 ClickHouse 伺服器上強制執行嚴格的主機名稱驗證。只有在使用一般信任的憑證授權單位簽署的 SSL 憑證時，才勾選這個選項。如果您使用自行簽署的 SSL 憑證，請取消勾選。

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

如果 Looker 顯示「可以連線」，請按「連線」建立連線。

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

支援的 JDBC 參數

對於 ClickHouse，Looker 支援連線的「其他 JDBC 參數」欄位中的下列 JDBC 參數。如要瞭解這些參數，請參閱資料庫的說明文件。

  • beta.row_binary_for_simple_insert
  • compress
  • connection_timeout
  • continueBatchOnError
  • createDatabaseIfNotExist
  • custom_http_headers
  • custom_http_params
  • default_query_settings
  • disable_frameworks_detection
  • jdbc_ignore_unsupported_values
  • jdbc_resultset_auto_close
  • jdbc_sql_parser
  • jdbc_use_max_result_rows
  • jdbcCompliance
  • max_execution_time
  • password
  • session_timezone
  • socket_timeout
  • typeMappings
  • use_server_time_zone
  • use_time_zone
  • user
  • wrapperObject

功能支援

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

自 Looker 26.16 起，ClickHouse 支援下列功能：

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