ClickHouse

將 Looker 連結至 ClickHouse 資料庫，即可分析資料及建立互動式資訊主頁。建立這項連結後，您就能在 Looker 中使用 ClickHouse 資料製作報表及分析，直接根據資料做出決策。

本頁面將引導您設定 ClickHouse 執行個體和 Looker 連線設定，包括如何加密網路流量、定義使用者授權，以及查看支援的功能。Looker 支援 ClickHouse 0.2 以上版本，以及使用新版 JDBC 驅動程式和對稱式匯總函式的 ClickHouse 26 以上版本。

加密網路流量

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

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

使用者與安全性

首先，在 ClickHouse 伺服器上設定 Looker 使用者。ClickHouse 資料庫使用者可透過 SQL (CREATE USER) 或 users.xml 檔案中的 users 區段設定。請按照 ClickHouse 存取權說明文件設定使用者存取權。以下基本範例使用 users.xml：

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

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

  • Dialect：選取「ClickHouse 26+」或「ClickHouse」。
  • 主機：ClickHouse 伺服器的可連線主機名稱或 IP 位址。
  • Port：可透過 HTTP(S) 存取 ClickHouse 服務的通訊埠。
    • 根據預設，HTTP 連線會使用 8123，HTTPS 連線則使用 8443。
    • 根據預設，ClickHouse 原生 TCP 指令列用戶端會使用通訊埠 9000 和 9440，但 Looker 必須使用 HTTP(S) 通訊埠才能連線至 ClickHouse。
    • ClickHouse 管理員可能已在 ClickHouse 設定中，使用 http_port 或 https_port 設定選擇替代通訊埠。請向 ClickHouse 管理員詢問適合您設定的值。
  • 資料庫：資料庫名稱 (必須是 ClickHouse 權限允許的資料庫之一)。
  • 使用者名稱：資料庫使用者名稱。
  • 密碼：資料庫密碼。
  • SSL：勾選即可透過 SSL/TLS 連線至 ClickHouse。
  • 驗證 SSL：(選用) 勾選即可在 ClickHouse 伺服器上強制執行嚴格的 SSL 憑證和主機名稱驗證。只有在使用由一般信任的憑證授權單位簽署的 SSL 憑證時，才選取「驗證 SSL」。如果您使用的是自行簽署的 SSL 憑證，請勿勾選這項設定。
  • 其他 JDBC 參數：(選用) 其他 JDBC 字串參數。如要查看 Looker 支援的參數清單，請參閱本頁面的「支援的 JDBC 參數」一節。

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

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

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

支援的 JDBC 參數

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

ClickHouse 26+ 參數

  • async_insert
  • autoCommit
  • compress
  • compress_algorithm
  • compress_level
  • connect_timeout
  • connection_timeout
  • continueBatchOnError
  • createDatabaseIfNotExist
  • custom_settings
  • database
  • databaseTerm
  • externalDatabase
  • fetchSize
  • format
  • jdbcCompliant
  • keep_alive_timeout
  • max_buffer_size
  • max_execution_time
  • max_result_bytes
  • max_result_rows
  • max_threads
  • namedParameter
  • query_timeout
  • receive_timeout
  • result_overflow_mode
  • retry
  • session_check
  • session_id
  • session_timeout
  • session_timezone
  • socket_timeout
  • ssl
  • ssl_mode
  • transactionSupport
  • use_server_time_zone
  • use_time_zone
  • wait_for_async_insert
  • wrapperObject

ClickHouse (舊版) 參數

  • 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 支援的功能，也必須由資料庫方言支援。

ClickHouse 26+ 功能支援

自 Looker 26.20 起，ClickHouse 26+ 支援下列功能：

功能 是否支援？
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
期間比較指標
不重複值的近似計數
資料庫內分析模型
自訂日曆

ClickHouse 功能支援

Looker 26.20 起，ClickHouse 支援下列功能：

功能 是否支援？
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
期間比較指標
不重複值的近似計數
資料庫內分析模型
自訂日曆

後續步驟

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