创建表

创建 Apache Iceberg 表会在 Lakehouse 运行时目录的命名空间内初始化新的表元数据和存储空间。

如果您想在目录中提供现有的 Apache Iceberg 表，请参阅注册表。

如果您在创建表期间未在命名空间或表级指定明确的存储位置，系统会自动在目录的默认位置（从目录的基本 Cloud Storage 存储桶派生）下构建表的元数据和数据目录，方法是附加命名空间和表标识符。

准备工作

1. 验证是否已为您的 Google Cloud 项目启用结算功能。

2. 启用 BigLake API。

   启用 API 所需的角色

   如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 获得了此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

   启用 API

3. 使用 Apache Iceberg REST 目录端点设置 Lakehouse 运行时目录。

所需的角色

如需获得创建表所需的权限，请让管理员向您授予项目和存储桶的以下 IAM 角色：

• 创建表格：
  • BigLake Admin (roles/biglake.admin) - 您的项目
  • Storage Admin (roles/storage.admin) - 目标 Cloud Storage 存储桶

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

表格功能和支持

在 Lakehouse 运行时目录中使用表时，了解不同的表类型及其选择启用功能会很有帮助。如需详细了解如何使用 Apache Iceberg 表，请参阅 Apache Iceberg 表概览。

支持的 Iceberg 表

仅支持 Apache Iceberg V2（正式版）和 V3（预览版）表。不支持 Iceberg V1 表。如需升级现有的 V1 表，请参阅将 Iceberg V1 表升级到 V2。

使用表格选项（预览版）

您可以通过配置特定的表属性，选择使用 BigQuery 托管功能，例如 BigQuery 数据操纵语言 (DML) 和自动表管理。这些功能的启用方式因表格的创建位置而异：

• 从 BigQuery 迁移：默认启用 BigQuery DML 和自动表管理。
• 从开源引擎：如需选择启用，您必须明确配置表属性。如需了解详情，请参阅配置表格选项。

创建表

创建 Iceberg 表。