> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Holistics 是一个由 AI 驱动的平台，提供自助式 BI 和嵌入式分析，通过治理完善且易于访问的指标，帮助所有人做出更好的决策。

# 将 ClickHouse 连接到 Holistics

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            由社区维护
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<CommunityMaintainedBadge />

[Holistics](https://www.holistics.io/) 是一个 AI 原生的自助式 BI 平台，提供可编程的语义层，确保指标一致且可信。

将 ClickHouse 连接到 Holistics 后，您的团队即可获得快速、可靠且由 AI 驱动的自助式体验，并以代码化语义层为基础。业务用户可以借助拖放和 AI 自信地探索数据，而您则能让指标定义保持可复用、可组合，并在 Git 中进行版本控制。

<div id="prerequisites">
  ## 前置条件
</div>

连接前，请确保已满足以下条件：

* \*\*权限：\*\*您必须是 Holistics 中的 Admin，才能添加新的数据源。
* \*\*网络访问：\*\*您的 ClickHouse server 必须可从 [Holistics 的 IP 地址](https://docs.holistics.io/docs/connect/ip-whitelisting) 访问。
* \*\*数据库用户：\*\*请为 Holistics 创建一个专用的只读用户，不要使用管理员账户。

<div id="recommended-privileges">
  ### 建议的权限
</div>

专用用户需要对你要查询的表以及 `system` 表 (用于 schema 检测) 拥有 `SELECT` 权限。

```sql theme={null}
-- Example: Grant read access to a specific database
GRANT SELECT ON my_database.* TO holistics_user;

-- Grant access to system metadata
GRANT SELECT ON system.* TO holistics_user;
```

<Steps>
  <Step title="收集连接信息" id="step-1-gather-connection-details">
    要通过 HTTP(S) 连接到 ClickHouse，你需要准备以下信息：

    | **Parameter**     | **Description**                                                            |
    | ----------------- | -------------------------------------------------------------------------- |
    | **Host**          | 你的 ClickHouse server 的主机名 (例如 `mz322.eu-central-1.aws.clickhouse.cloud`) 。 |
    | **Port**          | ClickHouse Cloud (SSL/TLS) 使用 **8443**。不使用 SSL 的自管理实例使用 **8123**。          |
    | **Database Name** | 要连接的数据库名称，默认通常为 `default`。                                                 |
    | **Username**      | 数据库用户，默认是 `default`。                                                       |
    | **Password**      | 该数据库用户的密码。                                                                 |

    你可以在 ClickHouse Cloud 控制台中点击 **Connect** 按钮，然后选择 **HTTPS** 来查看这些连接信息。

    <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=512a3ef076212baa4887e0f241b400c4" alt="ClickHouse Cloud 控制台中 Connect 按钮的位置" border width="998" height="932" data-path="images/integrations/data-visualization/holistics_01.webp" />
  </Step>

  <Step title="配置网络访问" id="step-2-configure-network-access">
    由于 Holistics 是云端应用，其服务器必须能够访问你的数据库。你有两个选项：

    1. **Direct Connection (推荐) ：** 在你的防火墙或 ClickHouse Cloud IP Access List 中将 Holistics 的 IP 地址加入白名单。你可以在 [IP Whitelisting guide](https://docs.holistics.io/docs/connect/ip-whitelisting) 中查看 IP 列表。

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_02.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=ec2b20fe5329b6bd9ed39a5547b5c1cc" alt="ClickHouse Cloud 中 IP 白名单配置示例" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_02.webp" />

    2. **Reverse SSH Tunnel：** 如果你的数据库位于私有网络 (VPC) 中且无法对公网开放，请使用 [Reverse SSH Tunnel](https://docs.holistics.io/docs/connect/connect-tunnel)。
  </Step>

  <Step title="在 Holistics 中添加数据源" id="step-3-add-data-source-in-holistics">
    1. 在 Holistics 中，前往 **Settings → 数据源**。

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_03.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=140bed8bce68e86bcb0f42e6486ea30a" alt="在 Holistics 设置中前往 数据源" border width="1647" height="1129" data-path="images/integrations/data-visualization/holistics_03.webp" />

    2. 点击 **New Data Source**，然后选择 **ClickHouse**。

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_04.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=d92626890c46a53d7ff9dc980c02cf6a" alt="从新建数据源列表中选择 ClickHouse" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_04.webp" />

    3. 使用步骤 1 中收集的信息填写表单。

       | **Field**         | **Setting**                                      |
       | ----------------- | ------------------------------------------------ |
       | **Host**          | 你的 ClickHouse 主机名                                |
       | **Port**          | `8443` (或 `8123`)                                |
       | **Require SSL**   | 如果使用 8443 端口，请切换为 **ON** (ClickHouse Cloud 必需) 。 |
       | **Database Name** | `default` (或你的特定 DB)                             |

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_05.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=cf2745f7ec9288d499a9d1a8ba349a73" alt="在 Holistics 中填写 ClickHouse 连接信息" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_05.webp" />

    4. 点击 **Test Connection**。

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_06.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=c48de7963b5e10198c670e3f62ec4496" alt="Holistics 中成功通过 ClickHouse 连接测试" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_06.webp" />

       * **Success：** 点击 **Save**。
       * **Failure：** 检查你的用户名和密码，并确认已将 [Holistics IP 地址加入白名单](https://docs.holistics.io/docs/connect/ip-whitelisting)。
  </Step>
</Steps>

<div id="known-limitations">
  ## 已知限制
</div>

Holistics 支持 ClickHouse 中大多数标准 SQL 功能，但以下情况除外：

* **运行总计：** ClickHouse 目前对这一分析函数的支持有限。
* **嵌套数据类型：** 对于深度嵌套的 JSON 或 Array 结构，可能需要先通过 SQL 模型将其展平后再进行可视化。

如需查看完整的受支持功能列表，请参阅[数据库特定限制页面](https://docs.holistics.io/docs/connect/faqs/clickhouse-limitations)。