Dataplex で Dataform リポジトリのメタデータを管理する

このドキュメントでは、Dataplex を使用して Dataform リポジトリのメタデータを表示し、アスペクトにアノテーションを付ける方法について説明します。

Dataplex を使用すると、メタデータを保存して管理できます。Dataform リポジトリは、追加の構成なしでデフォルトで Dataplex で使用できます。Dataplex は、Dataform リポジトリから次のメタデータを自動的に取得します。

  • データアセット名
  • データアセットの親
  • データアセットのロケーション
  • データアセットのタイプ
  • 対応する Google Cloud プロジェクト
  • サードパーティ リポジトリのソース
  • サービス アカウント

始める前に

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  2. Enable the Dataplex API.

    Enable the API

  3. 必要な Identity and Access Management（IAM）権限があることを確認します。

必要なロール

Dataplex で Dataform リポジトリを管理するには、Dataform リソースへのアクセス権を付与する事前定義された Dataform ロールと、必要な Dataplex ロールが必要です。

Dataplex でメタデータを管理する

Dataplex は、Dataform リポジトリを次のエントリ値を持つエントリとしてログに記録します。

システム エントリ グループ
Dataform リポジトリのシステム エントリ グループは @dataform です。Dataplex でリポジトリ エントリの詳細を表示するには、dataform システム エントリ グループを表示する必要があります。エントリ グループ内のすべてのエントリのリストを表示する手順については、Dataplex のドキュメントのエントリ グループの詳細を表示するをご覧ください。
システム エントリのタイプ
Dataform リポジトリのシステム エントリ タイプは dataform-repository です。Dataform リポジトリの詳細を表示するには、dataform-repository システム エントリ タイプを表示する必要があります。選択したエントリタイプの詳細を表示する手順については、Dataplex ドキュメントのエントリタイプの詳細を表示するをご覧ください。選択したエントリの詳細を表示する手順については、Dataplex ドキュメントのエントリの詳細を表示するをご覧ください。

アセットを検索する

Dataplex でデータアセットを検索する方法については、Dataplex のドキュメントの Dataplex でデータアセットを検索するをご覧ください。

リポジトリにアノテーションを付ける

Dataplex の Dataform リポジトリに追加のコンテキストを提供するには、Dataform エントリにアスペクトをアノテーションします。

Dataform リポジトリのシステム アスペクト タイプは dataform-repository です。

エントリにアスペクトをアノテーションする方法については、Dataplex のドキュメントのアスペクトを管理してメタデータを拡充するをご覧ください。

制限事項

Dataplex で Dataform リポジトリを管理する場合は、次の制限があります。

  • Dataplex では、Dataform のファイルレベルのアセット（テーブルやビューなど）を表示または管理することはできません。

場所

Dataplex を使用すると、すべての Dataform のロケーションから Dataform リポジトリを管理できます。

割り当て

Dataplex で Dataform リポジトリを管理する場合は、Dataplex の割り当てと上限が適用されます。

料金

Dataplex で Dataform リポジトリを管理する場合は、Dataplex の料金が適用されます。

次のステップ

  • Dataplex の詳細については、Dataplex ドキュメントの Dataplex の概要をご覧ください。