Dataplex Catalog に保存されている BigQuery メタデータの変更

2024 年 10 月 15 日～ 2025 年 1 月 31 日に、Dataplex Catalog に保存されている BigQuery メタデータの一部が変更されます。

この変更により、Dataplex Catalog に保存されているメタデータが、BigQuery メタデータと他の Google Cloud ソースのメタデータと整合するようになります。

BigQuery メタデータに依存するワークロードがある場合は、継続性を維持するためにワークロードを調整する必要があります。

Dataplex Catalog メタデータの詳細については、Dataplex Catalog の概要をご覧ください。

変更の範囲

このセクションで説明する変更は、すべての BigQuery エントリに適用されます。BigQuery エントリは、BigQuery システムのエントリタイプに属するエントリです。

以下の API メソッドは、これらの変更の影響を受けます。

• lookupEntry
• entryGroups.entries.get

データ型の値とテーブルのサブタイプの値の変更は、Google Cloud コンソールの [エントリの詳細] ページにも反映されます。

データ型の値

アスペクト タイプ SchemaAspect のデータ型の値が変更されています。フィールド dataType が影響を受けます。

変更前の値	変更後の価値
INT64	INTEGER
FLOAT64	FLOAT
STRUCT	RECORD
BOOL	BOOLEAN

リソース名

最上位のエントリ フィールド entrySource.resource のリソース名が変更されます。フィールドが変更され、完全なリソース名ではなくリソース ID が含まれるようになりました。

変更前の値	変更後の価値
//bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET/tables/TABLE	projects/PROJECT_ID/datasets/DATASET/tables/TABLE

祖先タイプの値

最上位エントリ フィールド entrySource.ancestors.type の祖先タイプ値が変更されています。

変更前の値	変更後の価値
655216118709.global.Dataset	dataplex-types.global.bigquery-dataset

ご対応のお願い

ロールアウト期間は 2024 年 10 月 15 日から 2025 年 1 月 31 日までです。BigQuery メタデータの変更は、ロールアウト期間を通じて段階的に適用されます。

必要な手順は次のとおりです。

• 2024 年 10 月 15 日より前: 以前のバージョンのメタデータと更新されたバージョンのメタデータの両方を解釈するようにワークロードを更新します。

• ロールアウト期間中: BigQuery のエントリには、以前のバージョンのメタデータまたは更新されたバージョンのメタデータがキャプチャされる場合があります。ワークロードは、両方のバージョンを解釈できる必要があります。

  BigQuery エントリが更新されたメタデータを使用するかどうかを確認するには、エントリの aspects オブジェクトで関連するアスペクト タイプを探します。アスペクト タイプの aspectSource オブジェクトの data_version フィールドは、メタデータのバージョンを示します。たとえば、bigquery-table エントリの場合は、フィールド Entry.aspects.dataplex-types.global.bigquery-table.aspectSource.data_version を参照します。

  以前のメタデータ バージョンを使用	更新されたメタデータ バージョンを使用
  ""（空の文字列）	"Ingestion/1.0.0"

• 2025 年 1 月 31 日以降: 必要に応じて、新しいバージョンのメタデータのみを解釈するようにワークロードを更新します。

サポート

ご不明な点がございましたら、[e-mail] までお問い合わせください。