全部產品
Search
文件中心

Quick BI:自建資料來源ClickHouse

更新時間:Jun 25, 2025

添加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版本。

操作步驟

  1. 登入Quick BI控制台

  2. 按照下圖指引添加資料來源。

    1. 建立資料來源入口進入建立資料來源介面。

    2. 自建資料來源頁簽下,選擇ClickHouse資料來源。image

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

    名稱

    描述

    顯示名稱

    資料來源配置列表的顯示名稱。請輸入規範的名稱,不要使用特殊字元,前後不能包含空格。

    資料庫地址

    部署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。

    請參見通過密碼認證登入Linux執行個體

    說明

    SSH的地址需要是公網地址,不支援內網地址。

    初始化SQL

    開啟後,可配置資料來源串連後初始化執行的SQL語句。

    每次資料來源串連後初始化執行的SQL語句,只允許SET語句,語句之間以分號分割。

    開啟檔案上傳入口

    開啟後支援上傳檔案。

  • 單擊串連測試,進行資料來源連通性測試。

    image

  • 測試成功後單擊確定,完成資料來源添加。

後續步驟

建立資料來源後,您還可以建立資料集並分析資料。