Data Catalog と Dataplex Universal Catalog の IAM 権限のマッピング

このドキュメントでは、Data Catalog と Dataplex Universal Catalog の権限のマッピングについて説明します。

詳しくは以下をご覧ください。

エントリ グループ

次の表に、エントリ グループの一般的なオペレーションに対する Data Catalog の権限と Dataplex Universal Catalog の権限の詳細なマッピングを示します。

オペレーション Data Catalog で必要な権限 Dataplex Universal Catalog で必要な権限
エントリ グループの作成 datacatalog.entryGroups.create dataplex.entryGroups.create
エントリ グループの更新 datacatalog.entryGroups.update dataplex.entryGroups.update
エントリ グループの詳細の表示 datacatalog.entryGroups.get dataplex.entryGroups.get
エントリ グループの削除 datacatalog.entryGroups.delete dataplex.entryGroups.delete

エントリ グループの詳細については、Data Catalog のエントリ グループと Dataplex Universal Catalog のエントリ グループをご覧ください。

エントリ

次の表に、エントリの一般的なオペレーションに対する Data Catalog の権限と Dataplex Universal Catalog の権限の詳細なマッピングを示します。

オペレーション Data Catalog で必要な権限 Dataplex Universal Catalog で必要な権限 注
カスタム エントリを作成する datacatalog.entries.create

dataplex.entries.create

dataplex.entryTypes.use（エントリタイプを使用してそのタイプのエントリを作成する場合）

dataplex.aspectTypes.use（アスペクト タイプを使用して、対応するアスペクトを持つエントリを作成する場合）

Data Catalog にはエントリタイプという概念はない。

Data Catalog では、エントリを作成した後にのみエントリのタグを作成できる。Dataplex Universal Catalog では、エントリを作成するときにエントリのアスペクトを作成できる。
再利用可能なシステム エントリタイプを使用してエントリを作成する 該当なし エントリ グループに対する指定された権限（例: dataplex.entryGroups.useENTRY_TYPE） 詳細については、システム アスペクト タイプとエントリタイプを参照。
カスタム エントリの詳細を表示する datacatalog.entries.get dataplex.entries.get -
システム エントリの詳細を表示する システム固有の権限（bigquery.tables.get など）

dataplex.entries.get（entries.get メソッドの場合）
または
システム固有の権限（例: bigquery.tables.get（lookupEntry メソッドの場合）

Dataplex Universal Catalog では、entries.get メソッドまたは lookupEntry メソッドを使用してエントリを取得できる。これらの方法の違いは必要な権限。

Google Cloud コンソールでは lookupEntry メソッドが使用される。
エントリの一覧表示 datacatalog.entries.list（カスタム エントリ） dataplex.entries.list（システム エントリとカスタム エントリの両方）

Data Catalog は、システム エントリの一覧表示をサポートしていない。

Dataplex Universal Catalog では、システム エントリ グループは権限を設定できる有効なリソース。
検索を実行する 検索アクション自体に必要な権限がない dataplex.projects.search

Data Catalog では、特別な権限なしで検索を実行できる。

Dataplex Universal Catalog で検索を実行するには、検索に使用するプロジェクトに対する dataplex.projects.search 権限が必要。このプロジェクトは、searchEntries メソッドの name パラメータを使用して設定される。scope パラメータは、検索するプロジェクトを定義する。

Data Catalog と Dataplex Universal Catalog の両方で、検索結果はシステム固有の権限チェックの対象となる。アクセス権のあるリソースのみが表示される。

Dataplex Universal Catalog でエントリを検索するために必要な権限の詳細については、エントリを参照。
カスタム エントリのフィールド（タグとアスペクト以外）を更新する datacatalog.entries.update

dataplex.entries.update

dataplex.entryTypes.use

 Dataplex Universal Catalog の entryTypes.use 権限は、アスペクト以外のフィールド（entrySource など）を保護する。たとえば、この権限を使用して、マネージド接続性パイプラインによって設定されたフィールドをユーザーが変更できないようにできる。
エントリ グループではなく特定のエントリに権限を設定する

通常はサポート対象外。

ただし、システム エントリのタグを更新するときに、特定のエントリに対する権限を設定できる。ソースシステムに対する権限が必要となる。

 非対応

IAM ポリシーは、エントリ グループに対してのみ作成される。

Data Catalog でシステム エントリのタグを更新する場合は、ソースシステムに対する権限が必要。たとえば、BigQuery テーブルのタグを更新する場合は、bigquery.tables.updateTag 権限が必要。この権限は特定のエントリに設定できる。

Dataplex Universal Catalog でエントリのアスペクトを更新するには dataplex.entries.update が必要であるが、特定のエントリには設定できない。
エントリの削除 datacatalog.entries.delete dataplex.entries.delete -

エントリの詳細については、Data Catalog のエントリと Dataplex Universal Catalog のエントリを参照。

タグ テンプレートとアスペクト タイプ

次の表に、タグ テンプレート（Data Catalog 内）とアスペクト タイプ（Dataplex Universal Catalog 内）の一般的なオペレーションに対する Data Catalog の権限と Dataplex Universal Catalog の権限の詳細なマッピングを示します。

オペレーション Data Catalog で必要な権限 Dataplex Universal Catalog で必要な権限 注
タグ テンプレートまたはアスペクト タイプを作成する datacatalog.tagTemplates.create dataplex.aspectTypes.create -
タグ テンプレートまたはアスペクト タイプを更新する datacatalog.tagTemplates.update dataplex.aspectTypes.update -
タグ テンプレートまたはアスペクト タイプの詳細を表示する datacatalog.tagTemplates.get dataplex.aspectTypes.get -
すべてのタグ テンプレートまたはアスペクト タイプを一覧表示する 非対応 dataplex.aspectTypes.list Data Catalog は、タグ テンプレートの一覧表示をサポートしていない。
再利用可能なシステム アスペクト タイプを使用する 該当なし dataplex.aspectTypes.use ではなく、エントリ グループに対する権限を指定する。例: dataplex.entryGroups.useASPECT_TYPE 詳細については、システム アスペクト タイプとエントリタイプを参照。
タグ テンプレートまたはアスペクト タイプを削除する datacatalog.tagTemplates.delete dataplex.aspectTypes.delete -

タグとアスペクト

次の表に、タグ（Data Catalog）とアスペクト（Dataplex Universal Catalog）に対する一般的なオペレーションの Data Catalog の権限と Dataplex Universal Catalog の権限の詳細なマッピングを示します。

オペレーション Data Catalog で必要な権限 Dataplex Universal Catalog で必要な権限 注
タグまたはアスペクトを作成、更新、削除する

datacatalog.entries.updateTag
または
サービス依存の同等物（bigquery.tables.updateTag など）

datacatalog.tagTemplates.use

dataplex.entries.update

dataplex.aspectTypes.use

Data Catalog では、タグはエントリのスタンドアロン リソース。タグとエントリは別々の方法で更新し、必要な権限も別々となる。

Dataplex Universal Catalog では、アスペクトはスタンドアロン リソースとしてではなく、エントリ内に保存される。エントリのアスペクトを更新するには、エントリを更新する。これは、システム エントリとカスタム エントリの両方に適用される。
タグまたはアスペクトを一覧表示する

datacatalog.entries.get（公開タグと非公開タグの両方）

datacatalog.tagTemplates.get（非公開タグごと。タグにアクセスできない場合、そのタグは検索結果に表示されない）

 dataplex.entries.get Dataplex Universal Catalog では、エントリを取得するとそのアスペクトも一覧表示される。

次のステップ