このドキュメントでは、エントリタイプ、エントリ グループ、カスタム エントリを作成して管理し、カスタム データソースを Dataplex に統合する方法について説明します。
エントリは、メタデータをキャプチャするリソースを表します。エントリ グループは、1 つ以上のエントリのコンテナであり、アクセス制御とリージョン ロケーションの管理に使用されます。エントリタイプは、エントリに必要なメタデータを定義します。エントリタイプを使用すると、自由形式で緩く定義されたエントリ リソースに構造とルールを適用し、エントリを拡張できます。
カスタム データソースを Dataplex に統合するには、カスタム エントリ グループにあるカスタム エントリタイプを使用してカスタム エントリを作成します。カスタム エントリを作成する手順は、次のとおりです。
- エントリ グループを作成する
- エントリタイプを作成します。
- エントリ グループ内にエントリタイプのカスタム エントリを作成します。
エントリ
エントリは、メタデータをキャプチャするデータアセットを表します。すべてのエントリはエントリタイプのインスタンスです。エントリのアスペクトに対する各オペレーションは、エントリタイプの必須アスペクトに準拠する必要があります。たとえば、エントリを作成するときに、エントリタイプで定義されたすべてのアスペクト タイプの値を指定する必要があります。エントリタイプで required
としてマークされているエントリのアスペクトは削除できません。
エントリのカテゴリ
システム エントリ: Dataplex は、BigQuery データセットやテーブルなどの Google Cloud リソースのエントリを作成します。Dataplex が作成するエントリはシステム エントリと呼ばれます。Dataplex は、サポートされている Google Cloud システムからの継続的なメタデータ同期により、システム エントリを自動的に最新の状態に保ちます。
システム エントリに自動的に入力されるメタデータ(必須アスペクト)は変更できません。システム エントリの追加メタデータを追加または変更できるのは、オプションのアスペクトを使用した場合のみです。詳細については、アスペクトのカテゴリをご覧ください。
カスタム エントリ: カスタム リソース用に作成して管理できるエントリをカスタム エントリと呼びます。カスタム リソースは、Google Cloud または外部(オンプレミスなど)でホストされている Google 以外のサービスのリソースです。
エントリ グループ
エントリ グループは、1 つ以上のエントリのコンテナです。エントリ グループを使用すると、エントリのアクセス制御とリージョン ロケーションを管理できます。すべてのエントリ グループはプロジェクトに属します。
エントリ グループのカテゴリ
システム エントリ グループ: Google Cloud リソースの場合、Dataplex は、リソースが存在するすべてのプロジェクトとロケーションの各システムにエントリ グループを自動的に作成します。たとえば、
@bigquery
は BigQuery のシステム エントリ グループです。カスタム エントリ グループ: カスタム リソース用に作成するエントリ グループ。
エントリタイプ
エントリタイプは、必須のアスペクト タイプのセットを使用して、このタイプのエントリに必要なメタデータを定義します。
必須のアスペクト タイプはエントリにのみ指定できます。エントリの列には指定できません。特定のエントリタイプのエントリを作成する場合は、エントリタイプで指定されている必須のアスペクト タイプの値をすべて指定する必要があります。
エントリタイプ内で参照される必須アスペクト タイプは、エントリタイプと同じプロジェクトに属している必要があります。
エントリタイプのカテゴリ
カスタム エントリタイプ: 作成して管理するエントリタイプ。これらのエントリタイプを使用して、カスタム エントリを作成できます。
システム エントリタイプ: Dataplex では、これらのエントリタイプがデフォルトで提供されます。システム エントリタイプは、再利用可能と制限付きにさらに分類されます。
次の表では、システム エントリタイプのカテゴリと、各カテゴリに Dataplex が提供するエントリタイプのリストを示します。
システム エントリタイプのカテゴリ 説明 Dataplex が提供するエントリタイプ 再利用可能なシステム エントリタイプ このエントリタイプを使用して、カスタム エントリを作成できます。 generic
制限付きのシステム エントリタイプ これらは、Google Cloud リソースのエントリの作成など、システム用に予約されています。
これらのエントリタイプを使用してエントリを作成することはできませんが、これらのエントリタイプのエントリを編集して、オプションのアスペクトを追加することはできます。bigquery-connection
bigquery-dataset
bigquery-model
bigquery-routine
bigquery-table
bigquery-view
cloudsql-database
cloudsql-instance
cloudsql-schema
cloudsql-table
cloudsql-view
sql-access
storage
storage-bucket
storage-folder
カスタム エントリタイプは、特定のリージョン ロケーションまたはグローバル リソースとして作成できます。システム エントリタイプは常にグローバルです。エントリタイプの場所は、適用範囲に影響します。詳細については、プロジェクトとロケーションの制約をご覧ください。
始める前に
エントリを管理してカスタム データソースを取り込む前に、このセクションで説明するタスクを完了していることを確認してください。
必要なロール
エントリの作成と管理に必要な権限を取得するには、リソースに対する次の IAM ロールの付与を管理者に依頼してください。
-
エントリ、エントリ グループ、エントリ タイプに対する完全な権限セット: Dataplex Catalog 管理者 (
roles/dataplex.catalogAdmin
) -
エントリ、エントリ グループ、エントリ タイプなど、すべての Dataplex Catalog リソースを作成、管理する: Dataplex Catalog 編集者 (
roles/dataplex.catalogEditor
) -
エントリ関連のオペレーションに対する完全アクセス権: Dataplex エントリ オーナー (
roles/dataplex.entryOwner
) -
エントリ、エントリ グループ、エントリ タイプ、およびそれらに関連付けられた IAM ポリシーを表示する: Dataplex Catalog 閲覧者 (
roles/dataplex.catalogViewer
) -
カスタム エントリを作成するときに、アスペクト タイプを使用して、そのタイプのアスペクトを作成する: Dataplex アスペクト タイプ ユーザー(
roles/dataplex.aspectTypeUser
) -
エントリ グループを作成、管理する: Dataplex エントリ グループ オーナー (
roles/dataplex.entryGroupOwner
) -
エントリタイプを作成、管理する: Dataplex エントリタイプ オーナー (
roles/dataplex.entryTypeOwner
) -
エントリタイプを使用して、そのタイプのエントリを作成および変更する: Dataplex エントリタイプ ユーザー (
roles/dataplex.entryTypeUser
)
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
詳細については、Dataplex IAM ロールをご覧ください。
API を有効にする
Dataplex プロジェクトで Dataplex API を有効にします。
エントリ グループを作成する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリ グループ] > [カスタム] タブをクリックします。
[エントリ グループを作成する(Dataplex Catalog)] をクリックします。
[エントリ グループを作成] ウィンドウで、次のように入力します。
- 省略可: [表示名] フィールドに、エントリ グループの表示名を入力します。
- エントリ グループ ID: エントリ グループの一意の ID を入力します。
- 省略可: [説明] フィールドに、エントリ グループの説明を入力します。
- ロケーション: ロケーションを選択します。エントリ グループの作成後にロケーションを変更することはできません。
省略可: [ラベル] セクションで、任意のラベルを Key-Value ペアとしてリソースに追加します。
- [ラベルを追加] をクリックします。
- [キー] フィールドにキーを入力します。
- [値] フィールドにキーの値を入力します。
- ラベルをさらに追加するには、[ラベルを追加] をクリックして手順を繰り返します。
[保存] をクリックします。
gcloud
エントリ グループを作成するには、gcloud dataplex entry-groups create
コマンドを使用します。
REST
エントリ グループを作成するには、entryGroups.Create
メソッドを使用します。
エントリタイプを作成する
新しいソースを取り込むには、エントリタイプを作成する必要があります。
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリタイプ] > [カスタム] タブをクリックします。
[作成] をクリックします。
[エントリタイプを作成] ウィンドウで、次のように入力します。
- 省略可: [表示名] フィールドに、エントリタイプの表示名を入力します。
- エントリタイプ ID: エントリタイプの一意の ID を入力します。エントリタイプを作成した後にこの値を変更することはできません。
- 省略可: [説明] フィールドに、エントリタイプの説明を入力します。
- 省略可: [システム] フィールドに移行元システムを入力します。
- 省略可: [プラットフォーム] フィールドに、このタイプのエントリが属するプラットフォームを入力します。例:
Google Cloud
- [ロケーション] フィールドで、ロケーションを選択します。エントリタイプを作成した後にロケーションを変更することはできません。
省略可: [型エイリアス] セクションで、エントリタイプのデータ型を定義します。このデータ型は、エントリのクエリに使用できます。
- [型エイリアスを追加] をクリックします。
- [型エイリアス] フィールドでデータ型を選択します。型エイリアスは複数追加できます。
[必須のアスペクト タイプ] セクションで、このエントリタイプに必須のアスペクト タイプを選択します。このタイプに基づいて作成された各エントリには、これらの必須のアスペクト タイプが割り当てられます。
- [アスペクト タイプを選択] をクリックします。
- [アスペクト タイプを選択] ウィンドウで、アスペクトのタイプを選択します。
- [選択] をクリックします。
エントリから必須のアスペクトを削除することはできません。
省略可: [ラベル] セクションで、任意のラベルを Key-Value ペアとしてリソースに追加します。
- [ラベルを追加] をクリックします。
- [キー] フィールドにキーを入力します。
- [値] フィールドにキーの値を入力します。
- ラベルをさらに追加するには、[ラベルを追加] をクリックして手順を繰り返します。
[保存] をクリックします。
gcloud
エントリタイプを作成するには、gcloud dataplex entry-types create
コマンドを使用します。
REST
エントリタイプを作成するには、entryTypes.create
メソッドを使用します。
カスタム エントリを作成する
カスタム エントリを作成する前に、エントリ グループとエントリタイプを作成していることを確認します。
Console
Google Cloud コンソールを使用してカスタム エントリを作成することはできません。代わりに、Google Cloud CLI または API を使用してください。
gcloud
カスタム エントリを作成するには、gcloud dataplex entries create
コマンドを使用します。
REST
カスタム エントリを作成するには、entries.create
メソッドを使用します。
カスタム エントリを作成したら、エントリにアスペクトを追加できます。詳細については、エントリにアスペクトを追加するをご覧ください。
エントリ グループを管理する
このセクションでは、使用可能なエントリ グループのリストを表示する方法、エントリ グループの詳細を表示、更新、削除する方法について説明します。
使用可能なエントリ グループのリストを表示する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリ グループ] タブをクリックします。
このページには、使用可能なすべての Dataplex Catalog エントリ グループと Data Catalog エントリ グループが一覧表示されます。
カスタム エントリ グループを表示するには、[カスタム] タブをクリックします。[カスタム] タブの [カタログソース] 列に、リソースが存在する場所(Dataplex Catalog または Data Catalog)が表示されます。
システム エントリ グループを表示するには、[システム] タブをクリックします。
カスタム エントリ グループとシステム エントリ グループの詳細については、このドキュメントのエントリ グループのカテゴリをご覧ください。
省略可: 選択したプロジェクトのエントリ グループのリストを表示するには、[カスタム] タブをクリックし、[すべてのプロジェクトから表示] をオフに切り替えます。
[すべてのプロジェクトから表示] 切り替えボタンはデフォルトでオンになっています。リストには、選択した組織の Dataplex Catalog リソースと、アクセスできるすべての組織の Data Catalog リソースが含まれます。
gcloud
使用可能なエントリ グループのリストを表示するには、gcloud dataplex entry-groups list
コマンドを使用します。
REST
使用可能なエントリ グループのリストを表示するには、entryGroups.list
メソッドを使用します。
エントリ グループの詳細を表示する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリ グループ] タブをクリックします。
詳細を表示するエントリ グループをクリックします。
[エントリ グループの詳細] ページが開きます。選択したエントリ グループの表示名、エントリ グループ ID、説明、プロジェクト ID、ロケーション、ラベル、作成日、最終更新日などの情報にアクセスできます。
Data Catalog エントリ グループの詳細は、Data Catalog ウェブ インターフェースと Dataplex Catalog ウェブ インターフェースの両方で確認できます。これを行うには、エントリ グループの詳細ページで [Data Catalog] または [Dataplex Catalog] をクリックします。
[サンプル エントリ] セクションには、選択したエントリ グループで最近作成された関連エントリが 10 個表示されます。
省略可: エントリグループに関連するすべてのエントリを表示するには、[サンプル エントリ] セクションで [検索結果の関連エントリをすべて表示] をクリックします。
gcloud
エントリ グループの詳細を取得するには、gcloud dataplex entry-groups describe
コマンドを使用します。
REST
エントリ グループの詳細を取得するには、entryGroups.get
メソッドを使用します。
エントリ グループを更新する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリ グループ] > [カスタム] タブをクリックします。
更新するエントリ グループをクリックします。
[エントリ グループの詳細] ページで、[編集] をクリックします。
必要に応じて、表示名、説明、ラベルを編集します。
[保存] をクリックします。
gcloud
エントリ グループを更新するには、gcloud dataplex entry-groups update
コマンドを使用します。
REST
エントリ グループを更新するには、entryGroups.patch
メソッドを使用します。
エントリ グループを削除する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリ グループ] > [カスタム] タブをクリックします。
削除するエントリ グループをクリックします。
[エントリ グループの詳細] ページで、[削除] をクリックします。表示されるメッセージを確認します。
gcloud
エントリ グループを削除するには、gcloud dataplex entry-groups delete
コマンドを使用します。
REST
エントリ グループを削除するには、entryGroups.delete
メソッドを使用します。
エントリタイプを管理する
このセクションでは、使用可能なエントリ グループのリストを表示する方法、エントリタイプの詳細を表示、更新、削除する方法について説明します。
使用可能なエントリタイプのリストを表示する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリタイプ] タブをクリックします。
カスタム エントリタイプを表示するには、[カスタム] タブをクリックします。システム エントリタイプを表示するには、[システム] タブをクリックします。カスタム エントリ タイプとシステム エントリ タイプの詳細については、このドキュメントのエントリ タイプのカテゴリをご覧ください。
省略可: 選択したプロジェクトのエントリタイプのリストを表示するには、[カスタム] タブをクリックし、[すべてのプロジェクトから表示] をオフに切り替えます。
[すべてのプロジェクトの表示] 切り替えボタンはデフォルトでオンになっています。リストには、すべてのプロジェクトのエントリタイプが含まれます。
gcloud
使用可能なエントリタイプのリストを表示するには、gcloud dataplex entry-types list
コマンドを使用します。
REST
使用可能なエントリタイプのリストを表示するには、entryTypes.list
メソッドを使用します。
エントリタイプの詳細を表示する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリタイプ] > [カスタム] タブをクリックします。
詳細を表示するエントリタイプをクリックします。
エントリタイプの詳細ページが開きます。選択したエントリタイプの表示名、エントリタイプ ID、説明、プロジェクト ID、ロケーション、プラットフォーム、システム、タイプ エイリアス、ラベル、作成日、最終更新日などの情報にアクセスできます。
省略可: 最近作成された関連エントリ 10 件のリストを表示するには、[サンプル エントリ] タブをクリックします。
省略可: エントリグループに関連するすべてのエントリを表示するには、[サンプル エントリ] タブをクリックし、[検索結果の関連エントリをすべて表示] をクリックします。
gcloud
エントリタイプの詳細を取得するには、gcloud dataplex entry-types describe
コマンドを使用します。
REST
エントリタイプの詳細を取得するには、entryTypes.get
メソッドを使用します。
エントリタイプを更新する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリタイプ] > [カスタム] タブをクリックします。
更新するエントリタイプをクリックします。
[エントリタイプの詳細] ページで、[編集] をクリックします。
必要に応じて、表示名、説明、システム、プラットフォーム、型エイリアス、ラベルを編集します。
[保存] をクリックします。
gcloud
エントリタイプを更新するには、gcloud dataplex entry-types update
コマンドを使用します。
REST
エントリタイプを更新するには、entryTypes.patch
メソッドを使用します。
エントリタイプを削除する
Console
Google Cloud コンソールで、Dataplex の [カタログ] ページに移動します。
[エントリタイプ] > [カスタム] タブをクリックします。
削除するエントリタイプをクリックします。
[エントリタイプの詳細] ページで、[削除] をクリックします。表示されるメッセージを確認します。
gcloud
エントリタイプを削除するには、gcloud dataplex entry-types delete
コマンドを使用します。
REST
エントリタイプを削除するには、entryTypes.delete
メソッドを使用します。
次のステップ
- Dataplex Catalog でデータアセットを検索する方法を確認する。
- アスペクトを管理してメタデータを拡充する方法を確認する。
- Dataplex にメタデータをインポートする方法を確認する。
- Dataplex Catalog の詳細を確認する。