En este documento, se explica cómo solucionar problemas habituales relacionados con los feeds de cambios de metadatos de Dataplex Universal Catalog.
Errores de creación de feeds de cambios de metadatos
En esta sección, se describe cómo resolver los errores que puedes encontrar cuando creas feeds de cambios de metadatos.
Errores de permiso denegado
Recibes un error PERMISSION_DENIED cuando intentas crear un feed de cambios en los metadatos.
El problema se produce porque es posible que tú o la cuenta de servicio de Dataplex Universal Catalog no tengan los permisos necesarios.
Para resolver este problema, revisa los siguientes requisitos:
Asegúrate de tener el permiso
dataplex.metadataFeeds.create.Asegúrate de tener el permiso
dataplex.entryGroups.exporten el alcance del feed (organización, proyecto o grupo de entradas).Asegúrate de que la cuenta de servicio de Dataplex Universal Catalog (
service-{PROJECT_NUMBER}@gcp-sa-dataplex.iam.gserviceaccount.com) tenga el rolroles/pubsub.publisheren el tema de Pub/Sub de destino.
Errores en los Controles del servicio de VPC
Recibes un error de PERMISSION_DENIED o de los Controles del servicio de VPC cuando creas un feed.
Para resolver el problema, verifica que el feed de cambios de metadatos y los recursos que supervisa pertenezcan al mismo perímetro de los Controles del servicio de VPC:
Si el feed tiene un alcance a nivel de la organización, solo se supervisan los proyectos dentro del mismo perímetro.
Si el feed tiene permiso del proyecto o del grupo de entradas, asegúrate de que todos los proyectos o grupos de entradas especificados estén en el mismo perímetro que el proyecto en el que creas el feed.
Problemas con la entrega de notificaciones
En esta sección, se describe cómo resolver problemas relacionados con la entrega de notificaciones.
No se reciben las notificaciones
No recibes notificaciones en tu tema de Pub/Sub. Esto puede deberse a varios factores:
Faltan permisos: La cuenta de servicio de Dataplex Universal Catalog perdió el rol
roles/pubsub.publisheren el tema.Demora en la activación: Un feed recién creado o actualizado puede tardar hasta 10 minutos en activarse.
Se borró el tema: Si se borra el tema de Pub/Sub de destino, Dataplex Universal Catalog dejará de publicar.
Incompatibilidad de alcance o filtro: Es posible que los cambios no coincidan con el alcance o los filtros configurados.
Para resolver el problema, verifica lo siguiente:
Verifica que la cuenta de servicio de Dataplex Universal Catalog tenga el rol
roles/pubsub.publisheren el tema.Espera al menos 10 minutos después de crear o actualizar un feed.
Verifica si existe el tema de Pub/Sub. Si se borró, debes volver a crearla.
Revisa la configuración de tu feed para asegurarte de que el alcance y los filtros coincidan con los cambios de metadatos que esperas recibir.
Notificaciones duplicadas
Recibes mensajes de notificación duplicados. Dataplex Universal Catalog garantiza la entrega "al menos una vez", lo que significa que pueden producirse mensajes duplicados, especialmente durante los reintentos.
Configura tu aplicación de suscriptor para que controle los posibles duplicados. Puedes usar el campo messageId o la marca de tiempo del cambio para identificar y quitar los mensajes duplicados.
Problemas de contenido
En esta sección, se describe cómo resolver problemas relacionados con el contenido de las notificaciones del feed de cambios en los metadatos.
Faltan metadatos completos en la carga útil
El mensaje de notificación solo contiene el nombre del recurso y el tipo de cambio, pero no los metadatos completos ni los cambios específicos.
Esto se debe a que, por diseño, las notificaciones del feed de cambios de metadatos proporcionan "firmas de cambio" (qué cambió) en lugar de la carga útil completa. Esto mantiene los mensajes livianos y evita los límites de tamaño de la carga útil.
Usa el nombre del recurso proporcionado en la notificación para llamar a la API de Dataplex Universal Catalog (por ejemplo, GetEntry) y recuperar el estado actual del recurso.