Apache Iceberg ビューを変更すると、Lakehouse ランタイム カタログでビューの ID を変更することなく、ビューのスキーマと SQL 定義を進化させたり、カスタムビュー プロパティを設定または設定解除したりできます。
ビューの名前変更はサポートされていません。ビューの名前を変更するには、新しい名前でビューを作成し、元のビューを削除します。ビューのストレージ ロケーションも作成後は変更できません。別のロケーションを設定する更新は 400 Bad Request エラーで失敗します。
始める前に
-
BigLake API を有効にします(有効になっていない場合)。
API を有効にするために必要なロール
API を有効にするには、
serviceusage.services.enable権限が必要です。プロジェクトを作成した場合は、オーナーロール(roles/owner)を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール(roles/serviceusage.serviceUsageAdmin)を介してこの権限を取得できます。ロールを付与する方法を確認する。 - Apache Iceberg REST カタログ エンドポイントを使用して Lakehouse ランタイム カタログを設定します。
- Iceberg ビューの制限事項を確認します。
- ビューを作成します。
必要なロール
ビューの変更に必要な権限を取得するには、プロジェクトとストレージ バケットに対する次の 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 エンドポイントに送信します。エンドポイントのパスについては、ビュー定義を置き換えるをご覧ください。