添加ClickHouse資料來源用於連通ClickHouse資料庫與Quick BI,串連成功後,您可以在Quick BI上進行資料的分析與展示。Quick BI支援以公網或阿里雲VPC的方式串連ClickHouse,本文為您介紹如何添加ClickHouse自建資料來源。
前提條件
確保您的網路已連通:
您通過公網串連Quick BI與ClickHouse資料庫,請添加Quick BI的IP地址至資料庫白名單,請參見添加安全性群組規則。
您通過內網串連Quick BI與ClickHouse資料庫,請通過以下任意一種方式,實現資料來源與Quick BI網路連通:
當ClickHouse資料庫搭建在阿里雲的ECS上,您可以通過阿里雲VPC串連。
您也可以搭建跳板機,並通過SSH隧道訪問登入並訪問資料庫。
已擷取自建ClickHouse資料庫的使用者名稱和密碼。
使用限制
僅支援空間管理員和組織管理員角色的帳號建立資料來源。
僅Quick BI進階版和專業版支援ClickHouse資料來源。
支援20.3、22.8、23.8版本。
操作步驟
登入Quick BI控制台。
按照下圖指引添加資料來源。
從建立資料來源入口進入建立資料來源介面。
在自建資料來源頁簽下,選擇ClickHouse資料來源。

在配置串連對話方塊,您可以根據業務情境,完成以下配置。

名稱
描述
顯示名稱
資料來源配置列表的顯示名稱。請輸入規範的名稱,不要使用特殊字元,前後不能包含空格。
資料庫地址
部署ClickHouse資料庫的地址,包括IP或網域名稱。
連接埠
部署ClickHouse資料庫地址連接埠,預設為8123.
資料庫
部署ClickHouse資料庫時自訂的資料庫名稱。
使用者名稱和密碼
登入ClickHouse資料庫的使用者名稱和密碼。
時區
部署ClickHouse資料庫所在的時區。
資料庫版本
選擇ClickHouse資料庫的版本。
當資料庫版本為23.8及以上時,請選擇23.8;當資料庫版本為23.8以下時,請選擇22.8。
SSL
如果目標資料來源已配置SSL,您可以選中安全性通訊協定SSL,從而保護資料安全。
VPC資料來源
僅當ClickHouse資料庫部署在阿里雲ECS上,且網路類型為阿里雲VPC網路時,請選中VPC資料來源並配置如下參數:
購買者AccessId:購買此執行個體的AccessKey ID。
請參見擷取AccessKey。
說明請確保該AccessKey ID具備目標執行個體的Read許可權。此外,若具有Write許可權,系統將自動添加白名單,否則需要您手動添加。相關操作說明請參見建立自訂權限原則。
購買者AccessKey:購買此執行個體的AccessKey Secret。
請參見擷取AccessKey。
執行個體ID:ECS執行個體ID。請登入ECS管理主控台,在執行個體頁簽下擷取執行個體ID。
請參見查看執行個體資訊。
地區:ECS執行個體所在地區。
請參見查看執行個體資訊。
SSH
如果您選中SSH,則需要配置如下參數:
您可以搭建跳板機,並通過SSH隧道訪問登入並訪問資料庫。跳板機的資訊請找營運或系統管理員擷取。
SSH Host:輸入跳板機IP地址。
SSH 使用者名稱:登入跳板機的使用者名稱。
SSH 密碼:登入跳板機的使用者名稱對應密碼。
SSH 連接埠:跳板機的連接埠。預設為22。
說明SSH的地址需要是公網地址,不支援內網地址。
初始化SQL
開啟後,可配置資料來源串連後初始化執行的SQL語句。
每次資料來源串連後初始化執行的SQL語句,只允許SET語句,語句之間以分號分割。
開啟檔案上傳入口
開啟後支援上傳檔案。
單擊串連測試,進行資料來源連通性測試。

測試成功後單擊確定,完成資料來源添加。
後續步驟
建立資料來源後,您還可以建立資料集並分析資料。