删除命名空间

当您删除目录命名空间（例如 Apache Iceberg REST 目录或 Apache Hive 目录的命名空间）时，系统会从 Lakehouse 运行时目录中取消注册该命名空间。

虽然此操作会从 Lakehouse for Apache Iceberg 中移除命名空间，但不会自动删除底层 Cloud Storage 存储桶或您存储的数据文件。

如果命名空间不包含任何表，您可以将其删除。

准备工作

1. 请参阅关于 Lakehouse 运行时目录，了解 Lakehouse 运行时目录的运作方式以及该服务的限制。
登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请 创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigLake API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigLake API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

所需的角色

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

• 全部：
  • BigLake Admin (roles/biglake.admin)
  • Storage Admin (roles/storage.admin)

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

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

删除命名空间

从目录中删除命名空间。

控制台

1. 在 Google Cloud 控制台中，前往 Lakehouse 页面。

   前往 Lakehouse

2. 选择包含要删除的命名空间的目录。

3. 在您要删除的命名空间所在的行中，依次点击 更多命名空间操作 > 删除。

4. 在删除对话框中，输入 DELETE，然后点击删除。

gcloud

如需使用 gcloud 删除命名空间，请运行 gcloud biglake iceberg namespaces delete 命令。

gcloud biglake iceberg namespaces delete NAMESPACE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID"

替换以下内容：

• NAMESPACE_NAME：您的命名空间名称。
• PROJECT_ID：您的 Google Cloud 项目 ID。
• CATALOG_ID：目录的 ID。

REST

如需使用 REST API 删除命名空间，请向 DeleteIcebergNamespace 端点发出 DELETE 请求：

DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME

注意： 您无法删除仍包含表的命名空间。

替换以下内容：

• PROJECT_ID：您的 Google Cloud 项目 ID。
• CATALOG_ID：目录的 ID。
• NAMESPACE_NAME：目录命名空间的名称。