Data Catalog を使用してモデルとデータセットのリソースを検索する

このページでは、Data Catalog を使用して Vertex AI のモデルとデータセットのリソースを検索して管理する方法について説明します。Dataplex の Data Catalog 機能を使用すると、さまざまなプロジェクトのすべてのマネージド リソースにアクセスできます。

Data Catalog は、Dataplex 内のスケーラブルなフルマネージド型メタデータ管理サービスです。このサービスは、Vertex AI モデルとデータセットに関する次のメタデータを自動的にカタログ化します。

  • モデルリソースとデータセット リソースの名前と完全修飾名、
  • ロケーション（リージョン）、
  • 作成日と最終更新日、
  • モデル エイリアスとモデル バージョン ID データセットのデータ項目数、
  • 説明。

Vertex AI モデルとデータセットのメタデータは、一定間隔（通常は数時間ごと）で Data Catalog に自動的に同期されます。Data Catalog を使用すると、Vertex AI メタデータを検出して理解できます。Data Catalog は、次の作業に役立ちます。

  • アクセス可能なすべてのプロジェクトとロケーションで、特定のモデル エイリアスとモデル名のモデルを検索します。たとえば、特定のモデル エイリアスを検索するには、model_version_alias=my-model-alias を使用します。
  • アクセス権があるすべてのプロジェクトとロケーションでデータセット名、データセット ID を使用してデータセットを検索します。

Data Catalog では、Vertex AI リソースにタグを添付してメタデータをキュレートできます。各タグには複数のメタデータ フィールドを含めることができ、事前定義済みのタグ テンプレートまたはカスタムタグ テンプレートに基づいて作成できます。

たとえば、デプロイ環境名を含む列に次のタグを添付できます。

deployed_to:Test

Data Catalog の詳細については、Data Catalog の概要をご覧ください。

始める前に

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

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

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. プロジェクトで Data Catalog API を有効にします。

    Data Catalog API を有効にする

  7. 権限を確認してください。

    タグを検索して Vertex AI アセットに添付するには、特定の Identity and Access Management（IAM）のロールと権限が必要です。詳細については、Data Catalog に必要な IAM ロールと権限をご覧ください。

タグ テンプレートを作成する

タグ テンプレートは、新しいタグをすばやく作成するために使用できる再利用可能な構造です。 テンプレートを使用すると、作業の重複や不完全なタグを回避できます。タグ テンプレートは必要な数だけ作成できます。

詳細については、タグとタグ テンプレートをご覧ください。

Vertex AI アセットにタグを添付する

Vertex AI アセットにタグを添付すると、次のことが可能になります。

  • ビジネス メタデータをアセットに追加します。
  • ビジネス メタデータとその他のカスタム メタデータでアセットを検索します。

詳細については、タグとタグ テンプレートをご覧ください。

Vertex AI アセットを検索する

Google Cloud コンソールの Dataplex 検索ページを使用して、Vertex AI アセットを検索します。

  1. Dataplex の検索ページに移動します。

    Dataplex に移動

  2. [フィルタ] パネルの [システム] で、[Vertex AI] を選択します。

    Dataplex は、既知のすべての Vertex AI アセットを表示します。

  3. 省略可: 検索を絞り込むには、次のいずれかを行います。

    • [検索] ページでファセット検索を使用します。[データ型]、[プロジェクト]、[タグ] の下にあるチェックボックスをオンにします。

    • 検索フィールドで、system=vertex_ai の後に検索パラメータを追加します。パラメータをスペースで区切ります。

      たとえば、モデルのみを表示するには、検索フィールドに次のテキストを入力して、Enter を押します。

      system=vertex_ai type=model

      複雑な式には、かっこと、論理演算子 and および or を使用することもできます。検索フィールドで使用できる式の詳細については、Data Catalog の検索構文をご覧ください。

  4. 結果のテーブルでアセットの名前をクリックすると、そのアセットのメタデータが表示されます。

  5. 省略可: 必要に応じて次の操作を行います。

    • [概要を追加] をクリックして、アセットのリッチテキストによる説明を追加します。
    • アセットにタグを追加するには、[タグを添付] をクリックします。

Data Catalog に必要な IAM のロールと権限

Data Catalog で Vertex AI リソースを表示、タグ付け、検索するには、異なる権限要件があります。

公開タグと非公開タグを表示する権限

Vertex AI リソースの公開タグと非公開タグを表示するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

Data Catalog で Vertex AI リソースを検索するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

Vertex AI リソースにタグを添付する権限

Data Catalog の Vertex AI リソースにタグを添付するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

詳しくは、事前定義ロールをご覧ください。

次のステップ