Usa productos de datos

Los productos de datos en Knowledge Catalog (antes Dataplex Universal Catalog) te permiten encontrar colecciones de recursos seleccionadas y solicitar acceso a través de flujos de trabajo de aprobación integrados. Una vez aprobada, puedes consultar los datos subyacentes, como las tablas de BigQuery, con tus credenciales de usuario, una cuenta de servicio o un servidor remoto del Protocolo de contexto del modelo (MCP).

Este documento está dirigido a los consumidores de productos de datos. Para obtener más información sobre la arquitectura y los conceptos clave de los productos de datos, consulta Acerca de los productos de datos.

Antes de comenzar

  1. Habilita las APIs de Dataplex y BigQuery, si aún no están habilitadas.

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

    Habilitar las API

Roles obligatorios

Para obtener los permisos que necesitas para buscar, acceder y usar productos de datos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el producto de datos o el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Como consumidor de productos de datos, para ver los metadatos de un recurso, debes tener el permiso viewer para acceder al recurso correspondiente en el sistema de origen. Por ejemplo, para buscar metadatos de un conjunto de datos o una tabla en un producto de datos, necesitas el rol de visualizador de metadatos de BigQuery (roles/bigquery.metadataViewer). Para obtener más información, consulta Roles necesarios para acceder a los resultados de la búsqueda.

Console

  1. En la consola de Google Cloud , ve a la página Búsqueda de Knowledge Catalog.

    Ir a Búsqueda

  2. Realiza búsquedas con palabras clave o lenguaje natural. Para obtener más información, consulta Busca recursos.

  3. En los resultados de la búsqueda, haz clic en el producto de datos cuyos detalles deseas ver. Puedes revisar la descripción, los recursos, el contrato, los aspectos, los datos de contacto y otra documentación asociada con el producto de datos.

REST

Para buscar un producto de datos, usa el método searchEntries.

Por ejemplo, envía la siguiente solicitud POST:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d \
  '{
  "query": "ADDITIONAL_KEYWORDS (type=(DATA_PRODUCT))",
  "pageSize": 10
  }' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/global:searchEntries"

Reemplaza lo siguiente:

  • ADDITIONAL_KEYWORDS (opcional): cualquier palabra clave o criterio de búsqueda adicional para limitar los resultados (por ejemplo, displayName:'My Data Product' o description:'sales')
  • PROJECT_ID: Es el ID de tu proyecto de Google Clouden el que se crea el producto de datos.

Solicita acceso a los productos de datos

Como consumidor de productos de datos, si no tienes permisos de IAM para acceder a un producto de datos, puedes solicitar acceso con los flujos de trabajo de aprobación de acceso integrados.

Envía una solicitud de acceso

Console

  1. En la consola de Google Cloud , ve a la página Productos de datos de Knowledge Catalog.

    Ir a Productos de datos

  2. Haz clic en el producto de datos al que deseas acceder.

  3. Haz clic en Solicitar acceso.

  4. En el panel Detalles de la solicitud, especifica los siguientes parámetros:

    • Grupos de acceso: Selecciona el grupo de acceso funcional al que quieres unirte.

    • Cuenta propia o Cuenta de servicio: Selecciona el tipo de principal:

      • Si solicitas acceso para ti, selecciona Para mí.

      • Si solicitas acceso para la identidad programática, selecciona Cuenta de servicio. Esta opción solo está disponible si el producto de datos admite cuentas de servicio.

    • Justificación: Ingresa una justificación empresarial para tu solicitud.

  5. Haz clic en Enviar.

Se genera una nueva solicitud de cambio para que la revise el propietario del producto de datos. Recibirás una notificación por correo electrónico con los detalles del estado final en cuanto se apruebe o rechace la solicitud.

REST

Los consumidores de productos de datos que tienen el permiso dataplex.dataProducts.get pueden solicitar acceso creando un recurso ChangeRequest. Envía una solicitud POST al extremo del recurso del producto de datos con el método personalizado :requestAccess:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
  "parent": "projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID",
  "change_request": {
    "justification": "JUSTIFICATION_TEXT",
    "data_product_access_request": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID",
      "access_group_id": "DATA_PRODUCT_ACCESS_GROUP_ID"
    }
  }
}' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID:requestAccess"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .

  • LOCATION: Es la región en la que existe el producto de datos (por ejemplo, us-central1).

  • DATA_PRODUCT_ID: Es el identificador único del producto de datos de destino.

  • JUSTIFICATION_TEXT: Es el motivo empresarial que explica por qué se requiere el acceso.

  • DATA_PRODUCT_ACCESS_GROUP_ID: Es el ID del grupo de acceso específico al que solicitas unirte.

Consulta el estado de las solicitudes de acceso

Como consumidor de productos de datos, puedes supervisar el progreso y el ciclo de vida de las solicitudes de acceso que enviaste. Knowledge Catalog hace un seguimiento de estas solicitudes y las muestra con diferentes estados, según si estás viendo una lista de flujos de trabajo unificada o un resumen de acceso de un producto específico.

Consulta una lista unificada de tus solicitudes de acceso

Para ver una lista completa de todas las solicitudes de acceso que enviaste en todos los productos de datos, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página Flujos de trabajo de administración de Knowledge Catalog.

    Ir a Flujos de trabajo de administración

  2. Haz clic en la pestaña Mis solicitudes.

  3. Revisa la lista unificada que muestra tus solicitudes anteriores y pendientes, junto con sus estados de flujo de trabajo actuales:

    • Nueva: Se creó la solicitud de acceso y está pendiente de revisión por parte del responsable de aprobación.

    • Aprobada: Se aprobó la solicitud, pero los sistemas de backend aún están aprovisionando el acceso.

    • Rechazada: Se rechazó la solicitud. Revisa los comentarios del aprobador para ver los motivos del rechazo.

REST

Envía una solicitud GET con el método de colección personalizado :listMine:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests:listMine"

Visualiza el resumen de acceso de un producto de datos específico

Además de la lista de flujos de trabajo globales, puedes verificar tu postura de acceso para un producto de datos individual. Esto te permite verificar si ya tienes acceso heredado a un grupo de recursos sin necesidad de enviar una solicitud nueva.

Para ver el resumen de acceso de un producto de datos, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página Productos de datos de Knowledge Catalog.

    Ir a Productos de datos

  2. Haz clic en el producto de datos específico que deseas inspeccionar.

  3. Haz clic en la pestaña Resumen de acceso. Revisa tu estado en todos los grupos de acceso para ese producto de datos.

    En la pestaña Resumen de acceso, se usan los siguientes estados:

    Estado Descripción
    Sin acceso No tienes acceso al grupo de acceso y aún no lo solicitaste.
    En proceso de revisión Enviaste una solicitud de acceso, y esta se encuentra pendiente de revisión por parte de un aprobador.
    Approved Se aprobó tu solicitud de acceso, pero aún se está procesando la propagación de la membresía al Grupo de Google subyacente.
    Acceso otorgado El acceso está completamente activo. Eres miembro del grupo de acceso y puedes interactuar con los recursos del producto de datos.
    Rechazado Se rechazó tu solicitud de acceso para este grupo de acceso.

REST

Envía una solicitud GET con el ID único que se devolvió cuando se creó la solicitud originalmente:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .

  • LOCATION: Es la región en la que existe el producto de datos (por ejemplo, us-central1).

  • CHANGE_REQUEST_ID: Es el ID único de la solicitud de cambio que enviaste.

Borra una solicitud de acceso

  1. En la consola de Google Cloud , ve a la página Flujos de trabajo de administración de Knowledge Catalog.

    Ir a Flujos de trabajo de administración

  2. Haz clic en la pestaña Mis solicitudes.

  3. Busca la fila que contiene la solicitud de producto de datos de destino. Si es necesario, aplica un filtro para aislar la entrada.

  4. Haz clic en Acciones y, luego, en Borrar.

Consume productos de datos

Para usar un producto de datos, asegúrate de tener los permisos necesarios. Consulta Solicita acceso a los productos de datos.

Después de que el propietario del producto de datos te otorgue permiso, podrás acceder al producto de datos y a sus recursos. Por ejemplo, si se te otorgan permisos para acceder a una tabla de BigQuery, puedes consultarla directamente en BigQuery para generar estadísticas.

Accede a los recursos con las credenciales de usuario

Si se aprobó tu solicitud de acceso para tus credenciales de usuario, sigue estos pasos para acceder a los recursos:

  1. Busca el producto de datos.
  2. En los resultados de la búsqueda, haz clic en el producto de datos que quieras usar.
  3. Haz clic en la pestaña Activos.

  4. Haz clic en el recurso cuyos detalles deseas ver. Se abrirá la página de detalles de la entrada.

    Puedes acceder a detalles como el esquema, las estadísticas y el linaje. Si el recurso es una tabla o vista de BigQuery, puedes hacer clic en Abrir en BigQuery para navegar a BigQuery Studio y consultar los resultados.

Accede a los recursos con una cuenta de servicio

Si se aprobó tu solicitud de acceso para una cuenta de servicio, se te otorgará el rol de IAM de Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator) en la cuenta de servicio del productor de datos. Esto te permite crear una cadena de robo de identidad para acceder a los recursos subyacentes.

Para acceder a los recursos con una cuenta de servicio, sigue estos pasos:

  1. Identifica las cuentas de servicio configuradas para el producto de datos navegando a la pestaña Recursos de datos de la página de detalles del producto de datos.

  2. Para actuar en nombre de la cuenta de servicio del productor de datos, crea una cadena de identidad temporal para tu cuenta de servicio con el siguiente comando de Google Cloud CLI:

    gcloud config set auth/impersonate_service_account CONSUMER_SERVICE_ACCOUNT,PRODUCER_SERVICE_ACCOUNT

    Reemplaza lo siguiente:

    • CONSUMER_SERVICE_ACCOUNT: Es la dirección de correo electrónico completamente calificada de la cuenta de servicio que pertenece al consumidor del producto de datos.

    • PRODUCER_SERVICE_ACCOUNT: Es la dirección de correo electrónico completamente calificada de la cuenta de servicio asignada al grupo de acceso al producto de datos.

    Para obtener más información, consulta Usa la identidad temporal como cuenta de servicio.

Accede a productos de datos con el servidor de MCP remoto

Para las aplicaciones cliente y las herramientas para desarrolladores que interactúan con tus productos de datos fuera del ecosistema de Google Cloud , puedes usar un servidor remoto del Protocolo de contexto del modelo (MCP). Este patrón de arquitectura permite que los clientes desarrolladores externos consulten y descubran de forma segura los recursos de datos catalogados, a la vez que se mantienen los límites de administración unificados.

Para aprender a implementar un servidor externo y conectarte a él, consulta Usa el servidor de MCP remoto del catálogo de conocimiento.

¿Qué sigue?