> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/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", background}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} style={{
    backgroundColor
  }} />
      </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-parallel-read-in-order-multi-part/GTkpPcjoRQ_okrH3/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=GTkpPcjoRQ_okrH3&q=85&s=d059c1bbcc7317ff8df85b20189e65f4" 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-parallel-read-in-order-multi-part/GTkpPcjoRQ_okrH3/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=GTkpPcjoRQ_okrH3&q=85&s=f7a41f485276d8d238dbe28772bfa56c" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_1_dataconnection.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=54a024ad9fea1ebdc3a74a3a64d4d6c6" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_2a_clickhouse_connection.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=9c2c32223200b04004ee3280d4e9ad26" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_2b_clickhouse_connection.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=6662340192df00e6f911d71f3c7fdc21" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_3_user_access.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=5a58bef5b5b8fb20c92bfb917436e960" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_4a_clickhouse_data_view.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=3213d2780a9bb975889649612f2b3d61" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_4b_clickhouse_data_view_joins.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=f3693735e4e27ca27f498f7dfd8325a2" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_4c_clickhouse_completed_data_view.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=fc6759fd276129e6ca1824e967fa953d" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_5a_clickhouse_build_chart.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=b9986bbe02bd88e02bc91f1b9bebd3b5" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_5b_clickhouse_view_sql.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=1cffb61047c0743839934db24823a7b2" 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-parallel-read-in-order-multi-part/wJWVx__vhmSoXLa6/images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp?fit=max&auto=format&n=wJWVx__vhmSoXLa6&q=85&s=fa59a811d8dbffa8e7a55555999d7414" alt="Astrato 连接到 ClickHouse 用户访问权限" border width="1306" height="800" data-path="images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp" />
