> ## 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.

> 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 = "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 />

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_15.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=2990776443cdf84538dfa5d37ae2de66" size="md" alt="Explo 仪表盘" width="1152" height="661" data-path="images/integrations/data-visualization/explo_15.webp" />

<p />

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

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

<Steps>
  <Step title="收集您的连接详细信息" id="1-gather-your-connection-details">
    要通过 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**：

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="ClickHouse Cloud 服务连接按钮" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="ClickHouse Cloud HTTPS 连接信息" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

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

  <Step title="将 Explo 连接到 ClickHouse" id="2--connect-explo-to-clickhouse">
    1. 注册一个 Explo 账户。

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

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

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

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

    4. 填写 **Getting Started** 页面的信息。

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_03.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=4d5ae2e1a38109268e4cc07f75a819d1" size="md" alt="Getting Started" border width="1152" height="894" data-path="images/integrations/data-visualization/explo_03.webp" />

    5. 选择 **ClickHouse**

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_04.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=c8dd70cee272bcaa924c9855e684c21b" size="md" alt="Clickhouse" border width="1152" height="1156" data-path="images/integrations/data-visualization/explo_04.webp" />

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

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

    7. 配置 **安全**

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_06.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=076d67c9575c7ba733156b5406c3c6b8" size="md" alt="安全" border width="1152" height="855" data-path="images/integrations/data-visualization/explo_06.webp" />

    8. 在 ClickHouse 中，**将 Explo 的 IP 地址加入白名单**。
       `54.211.43.19, 52.55.98.121, 3.214.169.94, 以及 54.156.141.148`
  </Step>

  <Step title="创建仪表板" id="3-create-a-dashboard">
    1. 前往左侧导航栏中的 **仪表盘** 选项卡。

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_07.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=bedca9b3c0bc41d7a7fd887dfd85a4e2" size="sm" alt="仪表板" border width="432" height="891" data-path="images/integrations/data-visualization/explo_07.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_08.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=65a5fc374f54ee62d67030d04c8103e2" size="sm" alt="创建仪表板" border width="425" height="76" data-path="images/integrations/data-visualization/explo_08.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_09.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=568f050a91cfb6e6f7f1b94000c055c1" size="md" alt="Explo 仪表板" border width="1152" height="688" data-path="images/integrations/data-visualization/explo_09.webp" />
  </Step>

  <Step title="运行 SQL 查询" id="4-run-a-sql-query">
    1. 在右侧边栏的 schema 标题下找到您的表名。然后将以下命令输入到数据集编辑器中：
       `SELECT * FROM YOUR_TABLE_NAME
       LIMIT 100`

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_10.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=d6fa75e995c4d3361a1018e449e59079" size="md" alt="Explo 仪表板" border width="1152" height="284" data-path="images/integrations/data-visualization/explo_10.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_11.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=b7f650470d5cab69c8cd519eaecc7fa1" size="md" alt="Explo 仪表板" border width="1152" height="329" data-path="images/integrations/data-visualization/explo_11.webp" />
  </Step>

  <Step title="构建图表" id="5-build-a-chart">
    1. 从左侧将条形图图标拖到画布上。

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_16.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=707795b023db6f39f8d00db7ce59dda1" size="sm" alt="Explo 仪表板" border width="432" height="978" data-path="images/integrations/data-visualization/explo_16.webp" />

    2. 选择数据集。现在您应该会看到如下界面：

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_12.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=265efc244dd0a93a5102a74eb8011806" size="sm" alt="Explo 仪表板" border width="432" height="744" data-path="images/integrations/data-visualization/explo_12.webp" />

    3. 按下图所示，在 X 轴中填入 **county**，并在 Y 轴部分填入 **Price**：

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_13.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=2e00df85a3c234b925d4e5f02e0f0ac3" size="sm" alt="Explo 仪表板" border width="432" height="754" data-path="images/integrations/data-visualization/explo_13.webp" />

    4. 然后将聚合方式更改为 **AVG**。

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_14.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=c8cf7dc7e75c48e4d4543a344af6e7db" size="sm" alt="Explo 仪表板" border width="432" height="447" data-path="images/integrations/data-visualization/explo_14.webp" />

    5. 现在，我们就得到了按 county 细分的房屋平均价格！

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/explo_15.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=2990776443cdf84538dfa5d37ae2de66" size="md" alt="Explo 仪表板" width="1152" height="661" data-path="images/integrations/data-visualization/explo_15.webp" />
  </Step>
</Steps>

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

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