创建命名空间

在目录（例如 Apache Iceberg REST 目录或 Apache Hive 目录）中创建命名空间有助于您在 Lakehouse 运行时目录中整理表。

准备工作

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

  2. 启用 BigLake API。

    启用 API 所需的角色

    如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

    启用 API

所需的角色

如需获得创建命名空间所需的权限，请让管理员向您授予项目的以下 IAM 角色：

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

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

创建命名空间

在目录中创建命名空间。

控制台

  1. 在 Google Cloud 控制台中，打开 Lakehouse 页面。

    前往 Lakehouse

  2. 选择现有目录，或者创建目录（如果您还没有目录）。

  3. 在菜单栏中，点击 + 创建命名空间。

  4. 对于命名空间名称，为命名空间输入一个唯一的名称。

  5. 在位置中，选择要与命名空间关联的 Cloud Storage 存储桶。

  6. 点击创建。

    您的命名空间已创建，并显示在目录详情列表中。

REST

如需使用 REST API 创建命名空间，请向 CreateIcebergNamespace 端点发出 POST 请求：

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces

请求正文必须包含有效的 Iceberg CreateNamespaceRequest JSON 载荷，用于定义命名空间标识符和属性。

替换以下内容：

  • PROJECT_ID：您的 Google Cloud 项目 ID。
  • CATALOG_ID：Lakehouse 运行时目录的 ID。