借助 Lakehouse 运行时目录,您可以删除 Apache Iceberg 表,以清理未使用或过时的条目。此操作会移除表注册和元数据,但不会删除 Cloud Storage 中的底层数据文件。
您可以使用 Google Cloud 控制台、Apache Spark 或 BigQuery 中的 DROP TABLE SQL 语句、Google Cloud CLI 或 REST API 删除表。
准备工作
-
启用 BigLake API(如果尚未启用)。
启用 API 所需的角色
如需启用 API,您需要拥有
serviceusage.services.enable权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。 - 使用 Apache Iceberg REST 目录端点设置 Lakehouse 运行时目录。
所需的角色
如需获得删除表所需的权限,请让管理员向您授予项目的以下 IAM 角色:
-
删除表:BigLake Admin (
roles/biglake.admin) - 您的项目
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
表格功能和支持
在 Lakehouse 运行时目录中使用表时,了解不同的表类型及其选择启用功能会很有帮助。如需详细了解如何使用 Apache Iceberg 表,请参阅 Apache Iceberg 表概览。
支持的 Iceberg 表
仅支持 Apache Iceberg V2(正式版)和 V3(预览版)表。不支持 Iceberg V1 表。如需升级现有 V1 表,请参阅将 Iceberg V1 表升级到 V2。
使用表格选项(预览版)
您可以通过配置特定表属性,选择启用 BigQuery 管理的功能,例如 BigQuery 数据操纵语言 (DML) 和自动表管理。这些功能的启用方式因表的创建位置而异:
- 从 BigQuery:默认情况下,BigQuery DML 和自动表管理功能处于启用状态。
- 从开源引擎:如需选择启用,您必须明确配置表属性。如需了解详情,请参阅配置表选项。
从目录中删除表注册会移除该表,无论它是标准 Iceberg 表还是启用了 BigQuery 托管功能的表。请参阅配置表选项,了解表删除如何与后台表管理作业交互。
删除表
删除表。
控制台
在 Google Cloud 控制台中,前往 Lakehouse 页面。
选择包含要删除的表的目录。
选择包含表的命名空间。
使用以下方法之一删除表:
- 在要删除的表所在的行中,依次点击 操作 > 删除。
- 点击表名称,然后点击工具栏上的删除表。
在确认对话框中,输入
delete,然后点击删除。
Spark
spark.sql("DROP TABLE TABLE_NAME;")
DROP TABLE TABLE_NAME;
gcloud
如需使用 gcloud 删除表,请运行 gcloud biglake iceberg tables delete 命令。
gcloud biglake iceberg tables delete TABLE_NAME \ --project="PROJECT_ID" \ --catalog="CATALOG_ID" \ --namespace="NAMESPACE_NAME"
替换以下内容:
TABLE_NAME:Iceberg 表的名称。PROJECT_ID: Google Cloud项目 ID。CATALOG_ID:您的目录的 ID。NAMESPACE_NAME:目录命名空间的名称。
BigQuery
如需从 BigQuery 中删除 Lakehouse 运行时目录中的 Apache Iceberg 表注册,请使用以下 GoogleSQL DROP TABLE 语句:
DROP TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`;
替换以下内容:
PROJECT_ID: Google Cloud项目 ID。CATALOG_ID:您的目录的 ID。NAMESPACE:Iceberg 表命名空间名称。TABLE_NAME:Iceberg 表的名称。
REST
如需使用 REST API 删除 Iceberg 表注册,请向 DeleteIcebergTable 端点发出 DELETE 请求:
DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME
替换以下内容:
PROJECT_ID: Google Cloud项目 ID。CATALOG_ID:您的目录的 ID。NAMESPACE_NAME:目录命名空间的名称。TABLE_NAME:Iceberg 表的名称。