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

> Astrato 将分析能力交到每位用户手中，让他们能够自行构建仪表盘、报表和数据应用，并在无需 IT 协助的情况下解答数据问题，从而为企业和数据型业务带来真正的自助式 BI。Astrato 可加快采用、提升决策速度，并在一个平台中统一分析、嵌入式分析、数据录入和数据应用。Astrato 将行动与分析融为一体，支持实时写回、与 ML 模型交互，并借助 Astrato 中的 SQL 下推支持和 AI 加速分析——超越传统仪表盘。

# 将 Astrato 连接到 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 />

Astrato 使用下推 SQL 直接查询 ClickHouse Cloud 或本地部署。这意味着你可以借助 ClickHouse 业界领先的性能，访问所需的全部数据。

<div id="connection-data-required">
  ## 所需的连接信息
</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**：

<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 管理员配置。

<div id="creating-the-data-connection-to-clickhouse">
  ## 创建到 ClickHouse 的数据连接
</div>

* 在侧边栏中选择 **Data**，然后选择 **数据连接** 选项卡
  (或直接访问此链接：[https://app.astrato.io/data/sources](https://app.astrato.io/data/sources))
  ​
* 点击屏幕右上角的 **New Data Connection** 按钮。

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_1_dataconnection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=806b01cd8d8ae2b482f28368b3e28317" alt="Astrato 数据连接" border width="396" height="165" data-path="images/integrations/data-visualization/astrato_1_dataconnection.webp" />

* 选择 **ClickHouse**。

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_2a_clickhouse_connection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=91feeabc20a7665402c8382934173ae9" alt="Astrato ClickHouse 数据连接" border width="235" height="164" data-path="images/integrations/data-visualization/astrato_2a_clickhouse_connection.webp" />

* 在连接对话框中填写必填字段

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_2b_clickhouse_connection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=9926d9a8ec14e804e428a7d33ea53502" alt="Astrato 连接到 ClickHouse 的必填字段" border width="486" height="601" data-path="images/integrations/data-visualization/astrato_2b_clickhouse_connection.webp" />

* 点击 **Test Connection**。如果连接成功，请为数据连接命名，然后点击 **Next**。

* 设置数据连接的 **用户访问权限**，然后点击 **connect**。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_3_user_access.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=59617eb5f2eaa17d07552ae3b142b78a" alt="Astrato 连接到 ClickHouse 的用户访问权限" border width="1973" height="1651" data-path="images/integrations/data-visualization/astrato_3_user_access.webp" />

* 连接创建完成后，也会同时创建一个数据视图。

<Note>
  如果创建了重复项，数据源名称后会附加一个时间戳。
</Note>

<div id="creating-a-semantic-model--data-view">
  ## 创建语义模型 / 数据视图
</div>

在我们的数据视图编辑器中，你会看到 ClickHouse 中所有的表和 schema，选择其中一些即可开始。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4a_clickhouse_data_view.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=398fe1932fc832d619799aa0d379b5b2" alt="Astrato 连接到 ClickHouse 用户访问权限" border width="1210" height="671" data-path="images/integrations/data-visualization/astrato_4a_clickhouse_data_view.webp" />

选择好数据后，接下来定义 **数据视图**。点击网页右上角的 define。

在这里，你可以对数据进行 join，还可以**创建统一治理的维度和度量**，非常适合在不同团队之间保持业务逻辑的一致性。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4b_clickhouse_data_view_joins.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=879a1a1ebc0e1c1f230e35f5ae844043" alt="Astrato 连接到 ClickHouse 用户访问权限" border width="1208" height="669" data-path="images/integrations/data-visualization/astrato_4b_clickhouse_data_view_joins.webp" />

**Astrato 会智能推荐 joins**，基于你的元数据进行建议，包括利用 ClickHouse 中的键。借助这些推荐的 joins，你可以直接基于治理良好的 ClickHouse 数据轻松上手，无需从头开始。我们还会展示 **join 质量**，方便你详细审查 Astrato 提供的所有建议。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4c_clickhouse_completed_data_view.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=33668dda643494290403bf9ec908081f" alt="Astrato 连接到 ClickHouse 用户访问权限" border width="1210" height="672" data-path="images/integrations/data-visualization/astrato_4c_clickhouse_completed_data_view.webp" />

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

只需几个步骤，你就可以在 Astrato 中创建第一个图表。

1. 打开可视化面板
2. 选择一种可视化 (先从柱状图开始)
3. 添加维度
4. 添加度量

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5a_clickhouse_build_chart.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=08a51bb303040f0f31692ec7fc11be71" alt="Astrato 连接到 ClickHouse 的用户访问权限" border width="1215" height="675" data-path="images/integrations/data-visualization/astrato_5a_clickhouse_build_chart.webp" />

<div id="view-generated-sql-supporting-each-visualization">
  ### 查看支持各个可视化的生成 SQL
</div>

透明性和准确性是 Astrato 的核心。我们确保每个生成的查询都清晰可见，让您始终拥有完全的控制权。所有计算都直接在 ClickHouse 中完成，在发挥其速度优势的同时，兼顾强大的安全性和治理能力。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5b_clickhouse_view_sql.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=a1f85efb08f5bbf55285658e7cedd93c" alt="Astrato 连接到 ClickHouse 用户访问权限" border width="1215" height="675" data-path="images/integrations/data-visualization/astrato_5b_clickhouse_view_sql.webp" />

<div id="example-completed-dashboard">
  ### 示例完整仪表盘
</div>

现在，距离打造一个美观且完整的仪表盘或数据应用已经不远了。想查看更多我们的成果，请访问官网上的演示画廊：[https://astrato.io/gallery](https://astrato.io/gallery)

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=49402b740a457b5c97f0aa3e0236678f" alt="Astrato 连接到 ClickHouse 用户访问权限" border width="1306" height="800" data-path="images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp" />
