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.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-09-02 (世界標準時間)。"],[],[],null,["# Use Data Catalog to search for model and dataset resources\n\n| **Caution:** Data Catalog is [deprecated](/data-catalog/docs/deprecations) in favor of [Dataplex Universal Catalog](/dataplex/docs/catalog-overview). Dataplex Universal Catalog is also integrated with Vertex AI, offering similar capabilities. You can use Dataplex Universal Catalog to enrich your data with aspects, which are the equivalent of Data Catalog tags. For more information, see [Manage\n| aspects and enrich metadata](/dataplex/docs/enrich-entries-metadata).\n\nThis page explains how you can search for and manage your Vertex AI model\nand dataset resources by using Data Catalog. You can access all\nyour managed resources across different projects using Data Catalog.\n\nData Catalog is a fully managed, scalable metadata management service.\nThe service automatically catalogs the following\nmetadata about Vertex AI models and datasets:\n\n- Name and fully-qualified name of model and dataset resources,\n- Location (region),\n- Creation date and last modification date,\n- Model Alias and Model Version ID Dataset data item count,\n- Description.\n\nVertex AI model and dataset metadata is automatically synced to\nData Catalog at regular intervals, typically every few hours. You can\nuse Data Catalog to discover and understand your Vertex AI\nmetadata. Use Data Catalog to aid with the following activities:\n\n- Search for models with specific model alias, and model name across all projects and locations that you have access to. For example, to search for a specific model alias use *model_version_alias=my-model-alias*.\n- Search for datasets using dataset name, dataset ID across all projects and locations that you have access to.\n\nWith Data Catalog, you can curate metadata by attaching tags to\nVertex AI resources. Each tag can have multiple metadata fields, and\ncan be based on a predefined or custom tag template.\n\nFor example, you could attach the following tag to a column that contains\ndeployment environment name: \n\n deployed_to:Test\n\nTo learn more about Data Catalog see\n[Data Catalog overview](/data-catalog/docs/concepts/overview)\n| **Note:** Data Catalog refers to the resources in Vertex AI and in other Cloud services as assets. From now on we'll refer to Vertex AI resources as Vertex AI *assets* . The term *assets* is used to refer to both the resources and Data Catalog metadata for the *resources*.\n\nBefore you begin\n----------------\n\n- Sign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n1.\n Enable the Data Catalog API for the project.\n\n\n [Enable the Data Catalog API](https://console.cloud.google.com/flows/enableapi?apiid=datacatalog.googleapis.com)\n2. Check permissions.\n\n\n You need certain Identity and Access Management (IAM) roles and permissions to\n search for and attach tags to Vertex AI assets. For details, see\n [Required IAM roles and permissions for Data Catalog](#iam-permissions).\n\nCreate tag templates\n--------------------\n\nTag temples are reusable structures that you can use to rapidly create new tags.\nTemplates help you avoid duplication of work and incomplete tags. Create as\nmany tag templates as you need.\n\nTo learn more, see\n[Tags and tag templates](/data-catalog/docs/tags-and-tag-templates).\n\nAttach tags to Vertex AI assets\n-------------------------------\n\nAttaching tags to Vertex AI assets lets you do the following:\n\n- Add business metadata to the assets.\n- Search for assets by business metadata and other custom metadata.\n\nTo learn more, see [Tags and tag templates](https://cloud.google.com/data-catalog/docs/tags-and-tag-templates).\n\nSearch for Vertex AI assets\n---------------------------\n\nUse the Dataplex Universal Catalog search page in the Google Cloud console\nto search for Vertex AI assets.\n\n1. Go to the Dataplex Universal Catalog search page.\n\n [Go to Search](https://console.cloud.google.com/dataplex/search)\n2. In the **Filters panel** , under **Systems** , select **Vertex AI**.\n\n Dataplex Universal Catalog displays all known Vertex AI assets.\n3. Optional: Do one of the following to narrow down the search:\n\n - Use the faceted search on the **Search** page. Select checkboxes under\n **Data types** , **Projects** , and **Tags**.\n\n - In the search field, append a search parameter after\n `system=vertex_ai`. Separate parameters with spaces.\n\n For example, to view only models, enter the following text in the\n search field, and then press `Enter`. \n\n system=vertex_ai type=model\n\n You can also use parentheses and the logical operators `and` and `or` for\n complex expressions. To learn more about the expressions that you can use\n in the search field, see [Data Catalog search\n syntax](/data-catalog/docs/how-to/search-reference).\n4. In the results table, click the name of an asset to view the metadata for\n that asset.\n\n5. Optional: Do any of the following:\n\n - Click **ADD OVERVIEW** to add a rich text description of the asset.\n - Click **ATTACH TAGS** to add a tag to the asset.\n\nRequired IAM roles and permissions for Data Catalog\n---------------------------------------------------\n\nViewing, tagging, and searching Vertex AI resources in\nData Catalog have different permission requirements.\n\n### Permission to view public and private tags\n\nTo get the permissions that you need to view public and private tags on\nVertex AI resources, ask your administrator to grant you the following\nIAM roles:\n\n- roles/datacatalog.tagTemplateViewer\n- [roles/aiplatform.viewer](/vertex-ai/docs/general/access-control#aiplatform.viewer)\n\n### Permission to search Vertex AI resources\n\nTo get the permissions that you need to search Vertex AI resources in\nData Catalog, ask your administrator to grant you the following\nIAM role:\n\n- [roles/aiplatform.user](/vertex-ai/docs/general/access-control#aiplatform.user)\n\n### Permission to attach tags to Vertex AI resources\n\nTo get the permissions that you need to attach tags to Vertex AI\nresources in Data Catalog, ask your administrator to grant you\nthe following IAM roles:\n\n- [roles/datacatalog.tagTemplateUser](/iam/docs/understanding-roles#datacatalog.tagTemplateUser)\n- [roles/datacatalog.tagEditor](/iam/docs/understanding-roles#datacatalog.tagEditor)\n- [roles/aiplatform.admin](/vertex-ai/docs/general/access-control#aiplatform.admin)\n\nFor more information, see [Predefined roles](/spanner/docs/iam#roles).\n\nWhat's next\n-----------\n\n- [What is Data Catalog](/data-catalog/docs/concepts/overview)\n- [Roles to search Google Cloud resources](/data-catalog/docs/concepts/iam#roles_to_search_resources)"]]
