Usa Data Catalog para buscar recursos de modelos y conjuntos de datos

En esta página, se explica cómo puedes buscar y administrar tu modelo de Vertex AI y los recursos de conjuntos de datos mediante Data Catalog. Puedes acceder a todos tus recursos administrados en diferentes proyectos mediante la función de Data Catalog de Dataplex.

Data Catalog es un servicio de administración de metadatos escalable y completamente administrado dentro de Dataplex. El servicio cataloga automáticamente los siguientes metadatos sobre los modelos y conjuntos de datos de Vertex AI:

  • Nombre y nombre completamente calificado de los recursos de los recursos de conjunto de datos y modelo,
  • Ubicación (región),
  • Fecha de creación y fecha de la última modificación,
  • Cantidad de elementos de datos del conjunto de datos de ID de versión del modelo y alias del modelo
  • Descripción.

Los metadatos del conjunto de datos y el modelo de Vertex AI se sincronizan con Data Catalog de forma automática a intervalos regulares, por lo general, cada unas horas. Puedes usar Data Catalog para descubrir y comprender tus metadatos de Vertex AI. Usa Data Catalog para realizar las siguientes actividades:

  • Busca modelos con un alias y un nombre de modelo específicos en todos los proyectos y las ubicaciones a las que tienes acceso. Por ejemplo, para buscar un alias de modelo específico, usa model_version_alias=my-model-alias.
  • Busca conjuntos de datos con el nombre y el ID del conjunto de datos en todos los proyectos y las ubicaciones a las que tienes acceso.

Con Data Catalog, puedes seleccionar los metadatos si adjuntas etiquetas a los recursos de Vertex AI. Cada etiqueta puede tener varios campos de metadatos y se puede basar en una plantilla de etiqueta predefinida o personalizada.

Por ejemplo, puedes adjuntar la siguiente etiqueta a una columna que contiene el nombre del entorno de implementación:

deployed_to:Test

Para obtener más información sobre Data Catalog, consulta Descripción general de Data Catalog.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  5. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  6. Habilita la API de Data Catalog para el proyecto.

    Habilite la API de Data Catalog

  7. Comprueba los permisos.

    Necesitas ciertos roles y permisos de Identity and Access Management (IAM) para buscar y adjuntar etiquetas a los activos de Vertex AI. Si deseas obtener más detalles, consulta Roles y permisos de IAM obligatorios para Data Catalog.

Crea plantillas de etiquetas

Las plantillas de etiquetas son estructuras reutilizables que puedes usar para crear etiquetas nuevas con rapidez. Las plantillas te ayudan a evitar la duplicación de trabajos y etiquetas incompletas. Crea tantas plantillas de etiquetas como necesites.

Para obtener más información, consulta Etiquetas y plantillas de etiquetas.

Adjunta etiquetas a los activos de Vertex AI

Adjuntar etiquetas a los activos de Vertex AI te permite hacer lo siguiente:

  • Agregar metadatos empresariales a los activos.
  • Busca activos por metadatos empresariales y otros metadatos personalizados.

Para obtener más información, consulta Etiquetas y plantillas de etiquetas.

Buscar activos de Vertex AI

Usa la página de búsqueda de Dataplex en la consola de Google Cloud para buscar activos de Vertex AI.

  1. Ve a la página de búsqueda de Dataplex.

    Ir a Dataplex

  2. En el panel Filtros, en Sistemas, selecciona Vertex AI.

    Dataplex muestra todos los elementos conocidos de Vertex AI.

  3. Opcional: Realiza una de las siguientes acciones para limitar la búsqueda:

    • Usa la búsqueda por facetas en la página Buscar. Selecciona las casillas de verificación de Tipos de datos, Proyectos y Etiquetas.

    • En el campo de búsqueda, agrega un parámetro de búsqueda después de system=vertex_ai. Separa los parámetros con espacios.

      Por ejemplo, para ver solo los modelos, ingresa el siguiente texto en el campo de búsqueda y, luego, presiona Enter.

      system=vertex_ai type=model
      

      También puedes usar paréntesis y los operadores lógicos and y or para expresiones complejas. Para obtener más información sobre las expresiones que puedes usar en el campo de búsqueda, consulta Sintaxis de búsqueda de Data Catalog.

  4. En la tabla de resultados, haz clic en el nombre de un activo para ver sus metadatos.

  5. Opcional: Realiza cualquiera de las siguientes acciones:

    • Haz clic en AGREGAR DESCRIPCIÓN GENERAL para agregar una descripción de texto enriquecido del activo.
    • Haga clic en ADJUNTAR ETIQUETAS para agregar una etiqueta al activo.

Roles y permisos de IAM obligatorios para Data Catalog

La visualización, el etiquetado y la búsqueda de recursos de Vertex AI en Data Catalog tienen requisitos de permisos diferentes.

Permiso para ver las etiquetas públicas y privadas

A fin de obtener los permisos que necesitas para ver las etiquetas públicas y privadas en los recursos de Vertex AI, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener los permisos que necesitas a fin de buscar recursos de Vertex AI en Data Catalog, pídele a tu administrador que te otorgue el siguiente rol de IAM:

Permiso para adjuntar etiquetas a los recursos de Vertex AI

Para obtener los permisos que necesitas a fin de adjuntar etiquetas a los recursos de Vertex AI en Data Catalog, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información, consulta Roles predefinidos.

¿Qué sigue?