Skip to main content
All quickstarts
数据仓储Cloud

​
前置条件

在开始本快速入门之前，您需要具备： To successfully follow this guide, you’ll need the following:
  • 可访问 兼容 Iceberg 的数据湖
  • Data Lake Catalog (URL 和凭据)
  • 根据数据湖目录类型，还需要对象存储凭据 (例如兼容 S3 的存储)
  • 在目录中注册的至少一个现有 Iceberg 表
如果您的 Iceberg 目录中还没有数据，可以上传此数据集。我们将在此处使用该数据集进行演示。

​
你将构建的内容

在本快速入门中，你将：
  • 在 ClickHouse Cloud 中连接到 Iceberg REST Catalog
  • 创建一个由该目录支持的 ClickHouse 数据库
  • 直接从 ClickHouse 查询现有的 Iceberg 表
  • 验证 ClickHouse 正在从你的数据湖读取数据
完成后，你将把 ClickHouse Cloud 连接到你的 Iceberg 目录，并能够在不复制数据的情况下对 Iceberg 表运行 SQL 查询。
1

创建 DataLakeCatalog 连接

在此步骤中，你将连接到 ClickHouse Cloud 中的 Data Lake Catalog。
  1. 打开你的 ClickHouse Cloud 服务。
  2. 导航到 Data Sources → Connect to your Data Lake Catalog。
  3. 在下拉菜单中选择你的数据目录。
  4. 使用你的凭据和连接信息填写表单。 对于 Unity Catalog，请输入：
    • Open Table Format (Iceberg)
    • ClickHouse Database name。这将是你的 ClickHouse 数据库名称，你将通过该数据库查询 Iceberg 表。
    • Workspace ID
    • Databricks catalog name
    • Client ID
    • Client Secret
    插入图片
  5. 保存该目录。现在，你应该会在 Data Sources 页面中看到已加载的数据目录，以及该数据库中可用表的数量。
2

查询 Iceberg 表

在此步骤中，你将从 数据目录 查询一个 Iceberg 表。
  1. 点击 Show Tables 或 SQL Console 后，你将进入 SQL 控制台 并看到与你的数据湖关联且已 materialized 的新数据库。如果你是通过 SQL Console 进入，请将数据库下拉菜单切换为你的 Iceberg 数据库。
  2. 你应该会在文件树中看到一个或多个 Iceberg 表。运行以下查询：
  1. ClickHouse 将返回你的 Iceberg 表中的行。

​
后续步骤

现在你已连接到数据湖，可以试着在 ClickHouse 中写入 Iceberg 表。
请注意引号的使用。ClickHouse 不支持三段式命名空间，因此必须给 schema.table 加上引号。
ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level

Check out the ClickHouse academy for on-demand and live training

All quickstarts
最后修改于 2026年8月28日