ClickHouse

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

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

加密網路流量

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

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

使用者和安全性

首先，請在 ClickHouse 伺服器上設定 Looker 使用者。您可以使用 SQL (CREATE USER) 或 users.xml 檔案中的 users 區段，設定 ClickHouse 資料庫使用者。請參閱 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 的「管理」部分中，選取「連線」，然後按一下「新增連線」。

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

  • 方言：選取「ClickHouse 26+」或「ClickHouse」。
  • 主機：ClickHouse 伺服器可連線的主機名稱或 IP 位址。
  • 通訊埠：透過 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
  • sslmode
  • 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.18 起，ClickHouse 26 以上版本支援下列功能：

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

ClickHouse 功能支援

在 Looker 26.18 中，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
毫秒
微秒
具體化檢視表
與前一段時期相比的指標
不重複值的近似計數
資料庫內分析模型
自訂日曆

後續步驟

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