Proyectos de recursos de Data Catalog

Para usar Data Catalog, debes habilitar la API de Data Catalog en un proyecto de Google Cloud que contenga los recursos que crearás en Data Catalog o acceso en otros sistemas de Google Cloud con la API. Nos referimos a este proyecto como el “proyecto de recurso” de Data Catalog.

En el caso común, si solo tienes un proyecto, solo necesitas habilitar la API de Data Catalog para acceder a todos los recursos que contiene. La guía de inicio rápido de Data Catalog es un ejemplo de la creación de un proyecto que tiene habilitada la API de Data Catalog y contiene una tabla de BigQuery a la que accedes, así como una plantilla y etiqueta de Data Catalog.

Usa plantillas de etiquetas en varios proyectos

Todos los componentes de Google Cloud se encuentran en los proyectos, incluidas tus plantillas de etiquetas. Sin embargo, puedes usar plantillas de etiquetas de un proyecto para crear etiquetas en otro si autorizas que otro proyecto las use. Para ello, usa las funciones de IAM TagTemplate Owner, Creator, User y Viewer.

Por ejemplo: si el proyecto A otorga la función TagTemplate User a una cuenta de servicio que pertenece al proyecto B, esto autoriza que el proyecto B cree etiquetas con sus plantillas. El proyecto A también puede autorizar la misma cuenta de servicio para modificar las etiquetas creadas con la función Tag Editor.

Si en el proyecto A no se autoriza el proyecto B, el proyecto B no puede etiquetar sus propios recursos de datos mediante las plantillas de etiquetas del proyecto A, debe crear sus propias plantillas.

Práctica recomendada: Crea plantillas en un proyecto central si son relevantes para más de un proyecto. Además, tu equipo de administración de datos debe ser el propietario de las plantillas de etiquetas compartidas y mantenerlas en nombre de la organización.

Identifica el proyecto de recursos de Data Catalog

En la siguiente tabla, se enumeran las API de Data Catalog y los proyectos de recursos asociados en los que se debe habilitar la API de Data Catalog.

API de Data Catalog Proyecto de recursos Notas
get/lookup/search proyecto de cuenta de servicio Si el X-Goog-User-Project se especifica en el encabezado HTTP/gRPC, habilite también la API de Data Catalog en el proyecto de usuario para habilitar la cuota y la facturación de X-Goog-User-Project en lugar de la cuenta de servicio.
create/update/delete proyecto identificado por el /project-id/ en el parámetro de recurso de la solicitud de API. Excepciones: consulta createTag/updateTag/deleteTag en la siguiente fila.
createTag/updateTag/deleteTag Proyecto de contenedor de plantilla de etiqueta Dado que la API de Data Catalog se habilitó en el proyecto del contenedor de plantillas de etiquetas cuando se creó la plantilla, no es necesaria ninguna otra acción para llamar a estas API. Nota: El proyecto identificado por el parámetro parent para la etiqueta y la plantilla de etiqueta utilizada con el fin de crear la etiqueta debe ser de la misma organización.

Notas:

  • service account project: el proyecto en el que generaste las credenciales de cuenta de servicio para autenticar tu código de la aplicación.

  • resource parameter: el parámetro pasado en la solicitud a la API que identifica el recurso asociado con la solicitud (para ver un ejemplo, consulta project-id en el parámetro parent de tagTemplates.create).

¿Qué sigue?