ビューを変更する

Apache Iceberg ビューを変更すると、Lakehouse ランタイム カタログでビューの ID を変更することなく、ビューのスキーマと SQL 定義を進化させたり、カスタムビュー プロパティを設定または設定解除したりできます。

ビューの名前変更はサポートされていません。ビューの名前を変更するには、新しい名前でビューを作成し、元のビューを削除します。ビューのストレージ ロケーションも作成後は変更できません。別のロケーションを設定する更新は 400 Bad Request エラーで失敗します。

始める前に

  1. Google Cloud プロジェクトで課金が有効になっていることを確認します。

  2. BigLake API を有効にします(有効になっていない場合)。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール(roles/owner)を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール(roles/serviceusage.serviceUsageAdmin)を介してこの権限を取得できます。ロールを付与する方法を確認する。

    API の有効化

  3. Apache Iceberg REST カタログ エンドポイントを使用して Lakehouse ランタイム カタログを設定します。
  4. Iceberg ビューの制限事項を確認します。
  5. ビューを作成します。

必要なロール

ビューの変更に必要な権限を取得するには、プロジェクトとストレージ バケットに対する次の IAM ロールを付与するよう管理者に依頼してください。

  • ビューを変更する: BigLake 編集者(roles/biglake.editor)- プロジェクト
  • エンドユーザー認証情報モードでビュー メタデータ ファイルを書き込む: Storage オブジェクト ユーザー(roles/storage.objectUser)- Cloud Storage バケット

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、ビューの変更に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

ビューを変更するには、次の権限が必要です。

  • ビューを変更する:
    • ビューに対する biglake.views.update
    • 新しいビュー定義が参照する各 Iceberg テーブルに対する biglake.tables.get
  • エンドユーザー認証情報モードでビュー メタデータ ファイルを書き込む: Cloud Storage バケットに対する storage.objects.create

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

表示権限の完全なリストについては、必要なロールと権限をご覧ください。

ビュー定義を置き換える

既存のビューのスキーマと SQL ロジックを置き換えます。ビューを置換すると、カタログは新しいバージョンの metadata.json ファイル(00001-UUID.metadata.json など)を書き込み、新しいビュー バージョンとスキーマをビュー メタデータに追加し、ビューの view-uuid を保持します。

Spark

CREATE OR REPLACE VIEW my_ns.eng_employees (
  emp_id,
  emp_name,
  dept,
  salary,
  is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';

REST

REST API を使用してビューを更新するには、UpdateIcebergView エンドポイントに POST リクエストを送信します。

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

リクエスト本文には、適用する requirements と updates を含む有効な Iceberg CommitViewRequest JSON ペイロードが含まれている必要があります。カタログは、楽観的同時実行の要件を検証し、更新を新しい metadata.json ファイルに commit します。

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloudプロジェクト ID。
  • CATALOG_ID: カタログの ID。
  • NAMESPACE_NAME: カタログの名前空間の名前。
  • VIEW_NAME: ビューの名前。

ビュー プロパティを設定、設定解除する

定義を変更せずに、ビューのカスタム プロパティを設定または削除します。

Spark

プロパティを設定します。

ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');

プロパティの設定を解除します。

ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');

カタログが write.metadata.compression-codec などのプロパティを処理する方法については、ビューのプロパティをご覧ください。

REST

set-properties または remove-properties の更新を含む CommitViewRequest を UpdateIcebergView エンドポイントに送信します。エンドポイントのパスについては、ビュー定義を置き換えるをご覧ください。

次のステップ