使用 Data Catalog 搜尋模型和資料集資源

本頁面說明如何使用 Data Catalog 搜尋及管理 Vertex AI 模型和資料集資源。您可以使用 Data Catalog，存取不同專案中的所有受管理資源。

Data Catalog 是可擴充的全代管中繼資料管理服務。這項服務會自動分類 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，請參閱這篇文章。

事前準備

  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. 請檢查權限。

    您需要特定的 Identity and Access Management (IAM) 角色和權限，才能搜尋 Vertex AI 資產並附加標記。詳情請參閱「Data Catalog 的必要 IAM 角色和權限」。

    8. 建立標記範本

    標記範本是可重複使用的結構，方便您快速建立新的標記。範本可協助您避免重複作業和不完整的代碼。視需要建立任意數量的標記範本。

    詳情請參閱「代碼和代碼範本」。

    將標記附加至 Vertex AI 資產

    將標記附加至 Vertex AI 資產，即可執行下列操作：

    • 在資產中新增商家中繼資料。
    • 依業務中繼資料和其他自訂中繼資料搜尋資產。

    詳情請參閱「代碼和代碼範本」。

    搜尋 Vertex AI 資產

    在 Google Cloud 控制台 使用 Dataplex Universal Catalog 搜尋頁面，搜尋 Vertex AI 資產。

    1. 前往 Dataplex Universal Catalog 搜尋頁面。

      前往「搜尋」頁面

    2. 在「篩選器」面板中，選取「系統」下方的「Vertex AI」。

      Dataplex Universal Catalog 會顯示所有已知的 Vertex AI 資產。

    3. 選用步驟：如要縮小搜尋範圍，請執行下列其中一項操作：

      • 在「搜尋」頁面使用多面向搜尋。勾選「資料類型」、「專案」和「標記」下方的核取方塊。

      • 在搜尋欄位中，於 system=vertex_ai 後方附加搜尋參數。以空格分隔參數。

        舉例來說，如要只查看模型，請在搜尋欄位中輸入下列文字，然後按下 Enter。

        system=vertex_ai type=model

        您也可以使用括號和邏輯運算子 and 和 or，建立複雜的運算式。如要進一步瞭解可在搜尋欄位中使用的運算式，請參閱 Data Catalog 搜尋語法。

    4. 在結果表格中，按一下資產名稱，即可查看該資產的中繼資料。

    5. 選用：執行下列任一操作：

      • 按一下「新增總覽」，即可新增資產的 RTF 說明。
      • 按一下「附加標記」，將標記新增至資產。

    Data Catalog 的必要 IAM 角色和權限

    在 Data Catalog 中查看、標記及搜尋 Vertex AI 資源時，需要不同的權限。

    查看公開和私人標記的權限

    如要取得在 Vertex AI 資源上查看公開和私人標記所需的權限，請要求管理員授予下列 IAM 角色：

    如要在 Data Catalog 中搜尋 Vertex AI 資源，請要求管理員授予下列 IAM 角色：

    為 Vertex AI 資源附加標記的權限

    如要取得在 Data Catalog 中將標記附加至 Vertex AI 資源所需的權限，請要求管理員授予下列 IAM 角色：

    詳情請參閱「預先定義的角色」。

    後續步驟