> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Explo 是一款易于使用的开源 UI 工具，可帮助您就数据提出问题。

# 将 Explo 连接到 ClickHouse

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}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

适用于任何平台的面向客户分析。专为出色的可视化而设计，追求简洁易用。

<div id="goal">
  ## 目标
</div>

在本指南中，你将把 ClickHouse 中的数据连接到 Explo，并将结果可视化。图表效果如下：

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=358e10822bedcdaff7031bd3ebde6ab3" size="md" alt="Explo Dashboard" width="1152" height="661" data-path="images/integrations/data-visualization/explo_15.png" />

<p />

<Tip>
  **添加一些数据**

  如果你还没有可用的数据集，可以添加一个示例。本指南使用的是 [UK Price Paid](/zh/get-started/sample-datasets/uk-price-paid) 数据集，因此你也可以选择它。在同一文档分类下，还有其他几个示例可供查看。
</Tip>

<div id="1-gather-your-connection-details">
  ## 1. 获取您的连接信息
</div>

要通过 HTTP(S) 连接到 ClickHouse，你需要以下信息：

| Parameter(s)              | Description                                |
| ------------------------- | ------------------------------------------ |
| `HOST` and `PORT`         | 通常，使用 TLS 时端口为 8443；不使用 TLS 时端口为 8123。     |
| `DATABASE NAME`           | 默认情况下，存在一个名为 `default` 的数据库。请使用你要连接的数据库名称。 |
| `USERNAME` and `PASSWORD` | 默认情况下，用户名为 `default`。请根据你的使用场景使用相应的用户名。    |

你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。
选择一个服务，然后点击 **Connect**：

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=a41d53ce6c46ccccb2855331a8dcc841" size="md" alt="ClickHouse Cloud 服务连接按钮" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

选择 **HTTPS**。连接信息会显示在示例 `curl` 命令中。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=0377c34215bd524b359c0d20dd96bed3" size="md" alt="ClickHouse Cloud HTTPS 连接信息" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

如果你使用的是自管理 ClickHouse，则连接信息由你的 ClickHouse 管理员配置。

<div id="2--connect-explo-to-clickhouse">
  ## 2.  将 Explo 连接到 ClickHouse
</div>

1. 注册 Explo 账户。

2. 点击左侧边栏中的 Explo **数据**选项卡。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_01.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=2b8befd0ad6f4f84ce545d639c3841bd" size="sm" alt="数据选项卡" border width="432" height="500" data-path="images/integrations/data-visualization/explo_01.png" />

3. 点击右上角的 **连接数据源**。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_02.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=f59691ee8b48672916dfab115715c002" size="sm" alt="连接数据源" border width="288" height="78" data-path="images/integrations/data-visualization/explo_02.png" />

4. 在 **入门** 页面填写相关信息

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_03.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=40147492e5d21af193ff3e0370d994d6" size="md" alt="入门" border width="1152" height="894" data-path="images/integrations/data-visualization/explo_03.png" />

5. 选择 **ClickHouse**

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_04.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=f7d9330c2bea29ca4049eb80c72c1baf" size="md" alt="ClickHouse" border width="1152" height="1156" data-path="images/integrations/data-visualization/explo_04.png" />

6. 输入你的 **ClickHouse 凭据**。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_05.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=fff4edbdac9cfb92d3cf5c3412518993" size="md" alt="凭据" border width="1152" height="902" data-path="images/integrations/data-visualization/explo_05.png" />

7. 配置 **安全**

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_06.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=67f527737d9544798f54669363ef86d6" size="md" alt="安全" border width="1152" height="855" data-path="images/integrations/data-visualization/explo_06.png" />

8. 在 ClickHouse 中，**将 Explo 的 IP 地址加入白名单**。
   `54.211.43.19, 52.55.98.121, 3.214.169.94, and 54.156.141.148`

<div id="3-create-a-dashboard">
  ## 3. 创建仪表盘
</div>

1. 前往左侧导航栏中的 **Dashboard** 选项卡。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_07.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=fb2a0b629bbb4cdb53966b6b75fff589" size="sm" alt="仪表盘" border width="432" height="891" data-path="images/integrations/data-visualization/explo_07.png" />

2. 点击右上角的 **Create Dashboard**，然后为仪表盘命名。至此，你已创建好一个仪表盘。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_08.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=45bfe1a4f1e1aee253028e1a8fd6e389" size="sm" alt="创建仪表盘" border width="425" height="76" data-path="images/integrations/data-visualization/explo_08.png" />

3. 现在，你应该会看到一个类似这样的界面：

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_09.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=8f5b739f79f100fe72d9fb422967afee" size="md" alt="Explo 仪表盘" border width="1152" height="688" data-path="images/integrations/data-visualization/explo_09.png" />

<div id="4-run-a-sql-query">
  ## 4. 运行 SQL 查询
</div>

1. 在右侧边栏中 schema 标题下找到你的表名。然后将以下命令输入到数据集编辑器中：
   `SELECT * FROM YOUR_TABLE_NAME
   LIMIT 100`

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_10.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=0777235055db63a24ddf13efa516c7da" size="md" alt="Explo Dashboard" border width="1152" height="284" data-path="images/integrations/data-visualization/explo_10.png" />

2. 现在点击“运行”，然后前往“预览”选项卡查看数据。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_11.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=b0467229ca5f6012fdcbdffb25226662" size="md" alt="Explo Dashboard" border width="1152" height="329" data-path="images/integrations/data-visualization/explo_11.png" />

<div id="5-build-a-chart">
  ## 5. 创建图表
</div>

1. 从左侧将柱状图图标拖到画布上。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_16.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=90b4a81ac793a8d5c6edec9ffda759ea" size="sm" alt="Explo Dashboard" border width="432" height="978" data-path="images/integrations/data-visualization/explo_16.png" />

2. 选择数据集。此时你应该会看到如下界面：

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_12.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=1b085c463a9702ce95086e637c781df3" size="sm" alt="Explo Dashboard" border width="432" height="744" data-path="images/integrations/data-visualization/explo_12.png" />

3. 按如下方式在 X 轴中填入 **county**，并在 Y 轴部分填入 **Price**：

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_13.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=0275751e33aaa27fa4f1fd0c755149b9" size="sm" alt="Explo Dashboard" border width="432" height="754" data-path="images/integrations/data-visualization/explo_13.png" />

4. 现在，将聚合方式更改为 **AVG**。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_14.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=6e01a23fb57792c32df8f4c8ac41788b" size="sm" alt="Explo Dashboard" border width="432" height="447" data-path="images/integrations/data-visualization/explo_14.png" />

5. 现在，我们已经得到了按县划分的房屋平均价格！

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=358e10822bedcdaff7031bd3ebde6ab3" size="md" alt="Explo Dashboard" width="1152" height="661" data-path="images/integrations/data-visualization/explo_15.png" />

<div id="learn-more">
  ## 了解更多
</div>

如需了解有关 Explo 以及如何构建仪表盘的更多信息，请<a href="https://docs.explo.co/" target="_blank">参阅 Explo 文档</a>。
