Usar o Data Catalog para procurar recursos de modelo e conjunto de dados

Nesta página, explicamos como pesquisar e gerenciar o modelo da Vertex AI e os recursos do conjunto de dados usando o Data Catalog. É possível acessar todos os recursos gerenciados em diferentes projetos usando o recurso Data Catalog do Dataplex.

O Data Catalog é um serviço de metadados totalmente gerenciado e escalonável no Dataplex. O serviço cataloga automaticamente os seguintes metadados sobre modelos e conjuntos de dados da Vertex AI:

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

Os metadados do modelo e do conjunto de dados da Vertex AI são sincronizados automaticamente com o Data Catalog em intervalos regulares, geralmente em algumas horas. É possível usar o Data Catalog para descobrir e entender os metadados da Vertex AI. Use o Data Catalog para ajudar nas seguintes atividades:

  • Pesquise modelos com alias e nome de modelo específicos em todos os projetos e locais aos quais você tem acesso. Por exemplo, para procurar um alias de modelo específico, use model_version_alias=my-model-alias.
  • Pesquise conjuntos de dados usando o nome e o ID do conjunto de dados em todos os projetos e locais a que você tem acesso.

Com o Data Catalog, é possível selecionar metadados anexando tags aos recursos da Vertex AI. Cada tag pode ter vários campos de metadados e pode ser baseada em um modelo de tag predefinido ou personalizado.

Por exemplo, anexe a seguinte tag a uma coluna que contenha o nome do ambiente de implantação:

deployed_to:Test

Para saber mais sobre o Data Catalog, consulte Visão geral do Data Catalog

Antes de começar

  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. Ative a API Data Catalog para o projeto.

    Ativar a API Data Catalog

  7. Verifique as permissões.

    Você precisa de determinados papéis e permissões do Identity and Access Management (IAM) para pesquisar e anexar tags aos recursos da Vertex AI. Para mais detalhes, consulte Permissões e papéis do IAM necessários para o Data Catalog.

Criar modelos de tag

Os modelos de tag são estruturas reutilizáveis que podem ser usadas para criar novas tags rapidamente. Os modelos ajudam a evitar duplicação de trabalho e tags incompletas. Crie quantos modelos de tag precisar.

Para saber mais, consulte Tags e modelos de tag.

Anexar tags aos recursos da Vertex AI

Anexar tags aos recursos da Vertex AI permite que você faça o seguinte:

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

Para saber mais, consulte Tags e modelos de tag.

Pesquisar recursos da Vertex AI

Use a página de pesquisa do Dataplex no console do Google Cloud para pesquisar recursos da Vertex AI.

  1. Acesse a página de pesquisa do Dataplex.

    Acesse o Dataplex.

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

    O Dataplex mostra todos os recursos conhecidos da Vertex AI.

  3. Opcional: siga um destes procedimentos para restringir a pesquisa:

    • Use a pesquisa facetada na página Pesquisa. Marque as caixas de seleção em Tipos de dados, Projetos e Tags.

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

      Por exemplo, para visualizar apenas modelos, insira o texto a seguir no campo de pesquisa e pressione Enter.

      system=vertex_ai type=model

      Também é possível usar parênteses e os operadores lógicos and e or para expressões complexas. Para saber mais sobre as expressões que podem ser usadas no campo de pesquisa, consulte Sintaxe de pesquisa do Data Catalog.

  4. Na tabela de resultados, clique no nome de um recurso para visualizar os metadados dele.

  5. Opcional: faça o seguinte:

    • Clique em ADICIONAR VISÃO GERAL para incluir uma descrição em rich text do recurso.
    • Clique em ANEXAR TAGS para adicionar uma ao recurso.

Permissões e papéis do IAM necessários para o Data Catalog

Visualizar, marcar e pesquisar recursos da Vertex AI no Data Catalog têm diferentes requisitos de permissão.

Permissão para visualizar tags públicas e privadas

Para ter as permissões necessárias para visualizar tags públicas e privadas nos recursos do Vertex AI, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para receber as permissões necessárias para pesquisar recursos da Vertex AI no Data Catalog, peça ao administrador para conceder a você o seguinte papel do IAM:

Permissão para anexar tags aos recursos da Vertex AI

Para receber as permissões necessárias para anexar tags aos recursos do Vertex AI no Data Catalog, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para mais informações, consulte Papéis predefinidos.

A seguir