您可以透過 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權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。 - 使用 Apache Iceberg REST 目錄端點設定 Lakehouse 執行階段目錄。
必要的角色
如要取得刪除資料表所需的權限,請要求管理員在專案中授予您下列 IAM 角色:
-
刪除資料表:BigLake 管理員 (
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」Lakehouse頁面。
選取要刪除的資料表所在的目錄。
選取資料表所在的命名空間。
使用下列其中一種方法刪除表格:
- 在要刪除的資料表列中,依序點選 「Actions」(動作) >「Delete」(刪除)。
- 按一下資料表名稱,然後在工具列上按一下「Delete table」(刪除資料表)。
在確認對話方塊中輸入
delete,然後按一下「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 資料表名稱。