テーブルを削除またはドロップしても、 Lakehouse ランタイム カタログからテーブル登録とメタデータが削除されるだけです。Cloud Storage に保存されている基盤となるデータファイルは消去または削除されません。
テーブルを削除するには、 Google Cloud コンソール、Spark
と Trino の SQL ドロップ コマンド、オープンソースの Iceberg REST カタログ API 仕様(DELETE /v1/{prefix}/namespaces/{namespace}/tables/{table})を使用します。
始める前に
さまざまな種類のテーブルと、それらを使用する場合の影響については、テーブルの概要をご覧ください。
-
BigLake API を有効にします。
API を有効にするために必要なロール
API を有効にするには、
serviceusage.services.enable権限を含む Service Usage 管理者 IAM ロール(roles/serviceusage.serviceUsageAdmin)が必要です。詳しくは、ロールを付与する方法をご覧ください。
必要なロール
テーブルを削除するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
-
すべて:
BigLake 管理者(
roles/biglake.admin) - プロジェクト
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。
テーブルを削除する
テーブルを削除します。
コンソール
コンソールで、[Lakehouse] に移動します。 Google Cloud
既存のカタログを選択するか、カタログがない場合は作成します。
[Namespace details] テーブルでテーブルを選択し、メニュー オプションを開きます。
[削除] をクリックします。
ダイアログにテーブル名を入力して、削除を確定します。
[削除] をクリックします。
Spark
spark.sql("DROP TABLE TABLE_NAME;")
Trino
DROP TABLE TABLE_NAME;
REST
REST API を使用して Iceberg テーブル登録を削除するには、DELETE
リクエストを DeleteIcebergTable エンドポイントに送信します。
DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME
次のように置き換えます。
PROJECT_ID: 実際の Google Cloud プロジェクト ID。CATALOG_ID: Lakehouse ランタイム カタログの ID。NAMESPACE_NAME: カタログ名前空間の名前。TABLE_NAME: Iceberg テーブルの名前。
次のステップ
- Apache Iceberg REST カタログを確認する。