Use o Data Catalog para pesquisar recursos de modelos e conjuntos de dados

Aviso: o Data Catalog está obsoleto em favor do Dataplex Universal Catalog. O catálogo universal do Dataplex também está integrado com a Vertex AI, oferecendo capacidades semelhantes. Pode usar o Dataplex Universal Catalog para enriquecer os seus dados com aspetos, que são o equivalente às etiquetas do Data Catalog. Para mais informações, consulte o artigo Faça a gestão dos aspetos e enriqueça os metadados.

Esta página explica como pode pesquisar e gerir os recursos de conjuntos de dados e modelos do Vertex AI através do Data Catalog. Pode aceder a todos os recursos geridos em diferentes projetos através do Data Catalog.

O Data Catalog é um serviço de gestão de metadados escalável e totalmente gerido. O serviço cataloga automaticamente os seguintes metadados sobre os modelos e os conjuntos de dados da Vertex AI:

• Nome e nome totalmente qualificado dos recursos do modelo e do conjunto de dados,
• Localização (região),
• Data de criação e data da última modificação,
• Contagem de itens de dados do conjunto de dados do ID da versão do modelo e do alias do modelo,
• Descrição.

Os metadados do modelo e do conjunto de dados da Vertex AI são sincronizados automaticamente com o Data Catalog a intervalos regulares, normalmente a cada poucas horas. Pode usar o catálogo de dados para descobrir e compreender os metadados do Vertex AI. Use o Data Catalog para ajudar nas seguintes atividades:

• Pesquise modelos com um alias de modelo específico e um nome de modelo em todos os projetos e localizações aos quais tem acesso. Por exemplo, para pesquisar um alias de modelo específico, use model_version_alias=my-model-alias.
• Pesquise conjuntos de dados através do nome do conjunto de dados, do ID do conjunto de dados em todos os projetos e localizações aos quais tem acesso.

Com o Data Catalog, pode organizar metadados anexando etiquetas a recursos do Vertex AI. Cada etiqueta pode ter vários campos de metadados e pode basear-se num modelo de etiqueta predefinido ou personalizado.

Por exemplo, pode anexar a seguinte etiqueta a uma coluna que contenha o nome do ambiente de implementação:

deployed_to:Test

Para saber mais acerca do catálogo de dados, consulte a vista geral do catálogo de dados

Nota: o Data Catalog refere-se aos recursos no Vertex AI e noutros serviços Google Cloud como recursos. A partir de agora, vamos referir-nos aos recursos do Vertex AI como recursos do Vertex AI. O termo recursos é usado para se referir aos recursos e aos metadados do Data Catalog para os recursos.

Antes de começar

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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Ative a API Data Catalog para o projeto.

   Ative a API Data Catalog

2. Verifique as autorizações.

   Precisa de determinadas funções e autorizações da gestão de identidade e de acesso (IAM) para pesquisar e anexar etiquetas a recursos do Vertex AI. Para ver detalhes, consulte o artigo Funções e autorizações de IAM necessárias para o Data Catalog.

Crie modelos de etiquetas

Os modelos de etiquetas são estruturas reutilizáveis que pode usar para criar rapidamente novas etiquetas. Os modelos ajudam a evitar a duplicação de trabalho e as etiquetas incompletas. Crie tantos modelos de etiquetas quantos precisar.

Para saber mais, consulte o artigo Etiquetas e modelos de etiquetas.

Anexe etiquetas a recursos do Vertex AI

A associação de etiquetas a recursos do Vertex AI permite-lhe fazer o seguinte:

• Adicione metadados da empresa aos recursos.
• Pesquise recursos por metadados da empresa e outros metadados personalizados.

Para saber mais, consulte o artigo Etiquetas e modelos de etiquetas.

Pesquise recursos do Vertex AI

Use a página de pesquisa do catálogo universal do Dataplex na Google Cloud consola para pesquisar recursos da Vertex AI.

1. Aceda à página de pesquisa do catálogo universal do Dataplex.

   Aceda à pesquisa

2. No painel Filtros, em Sistemas, selecione Vertex AI.

   O catálogo universal do Dataplex apresenta todos os recursos conhecidos do Vertex AI.

3. Opcional: faça uma das seguintes ações para restringir a pesquisa:

   • Use a pesquisa detalhada na página Pesquisa. Selecione as caixas de verificação em Tipos de dados, Projetos e Etiquetas.

   • No campo de pesquisa, anexe um parâmetro de pesquisa após system=vertex_ai. Separe os parâmetros por espaços.

     Por exemplo, para ver apenas modelos, introduza o seguinte texto no campo de pesquisa e, em seguida, prima Enter.

     system=vertex_ai type=model
     

     Também pode usar parênteses e os operadores lógicos and e or para expressões complexas. Para saber mais sobre as expressões que pode usar no campo de pesquisa, consulte a sintaxe de pesquisa do catálogo de dados.

4. Na tabela de resultados, clique no nome de um recurso para ver os metadados desse recurso.

5. Opcional: faça qualquer uma das seguintes ações:

   • Clique em ADICIONAR VISTA GERAL para adicionar uma descrição de texto formatado do recurso.
   • Clique em ANEXAR ETIQUETAS para adicionar uma etiqueta ao recurso.

Funções e autorizações de IAM necessárias para o Data Catalog

A visualização, a etiquetagem e a pesquisa de recursos do Vertex AI no Data Catalog têm requisitos de autorização diferentes.

Autorização para ver etiquetas públicas e privadas

Para receber as autorizações necessárias para ver etiquetas públicas e privadas em recursos do Vertex AI, peça ao seu administrador para lhe conceder as seguintes funções de IAM:

• roles/datacatalog.tagTemplateViewer
• roles/aiplatform.viewer

Autorização para pesquisar recursos da Vertex AI

Para receber as autorizações necessárias para pesquisar recursos do Vertex AI no Data Catalog, peça ao seu administrador que lhe conceda a seguinte função do IAM:

• roles/aiplatform.user

Autorização para anexar etiquetas a recursos do Vertex AI

Para receber as autorizações necessárias para anexar etiquetas a recursos do Vertex AI no Data Catalog, peça ao seu administrador para lhe conceder as seguintes funções do IAM:

• roles/datacatalog.tagTemplateUser
• roles/datacatalog.tagEditor
• roles/aiplatform.admin

Para mais informações, consulte o artigo Funções predefinidas.

O que se segue?

• O que é o catálogo de dados
• Funções para pesquisar Google Cloud recursos