Este documento ajuda a solucionar e resolver problemas comuns com feeds de mudança de metadados do Knowledge Catalog (antigo Dataplex Universal Catalog).
Erros de criação de feeds de mudança de metadados
Esta seção descreve como resolver erros que podem ocorrer ao criar feeds de mudança de metadados.
Erros de permissão negada
Você recebe um erro PERMISSION_DENIED ao tentar criar um feed de mudança de metadados.
O problema ocorre porque você ou a conta de serviço do Knowledge Catalog podem não ter as permissões necessárias.
Para resolver esse problema, revise estes requisitos:
Verifique se você tem a permissão
dataplex.metadataFeeds.create.Verifique se você tem a permissão
dataplex.entryGroups.exportno escopo do feed (organização, projeto ou grupo de entradas).Verifique se a conta de serviço do Knowledge Catalog (
service-{PROJECT_NUMBER}@gcp-sa-dataplex.iam.gserviceaccount.com) tem o papelroles/pubsub.publisherno tópico de destino do Pub/Sub.
Erros do VPC Service Controls
Você recebe um erro PERMISSION_DENIED ou do VPC Service Controls ao criar um feed.
Para resolver o problema, verifique se o feed de mudança de metadados e os recursos que ele monitora pertencem ao mesmo perímetro do VPC Service Controls:
Se o feed tiver escopo na organização, apenas os projetos dentro do mesmo perímetro serão monitorados.
Se o feed tiver escopo no projeto ou no grupo de entradas, verifique se todos os projetos ou grupos de entradas especificados estão no mesmo perímetro do projeto em que você está criando o feed.
Problemas de entrega de notificações
Esta seção descreve como resolver problemas com a entrega de notificações.
Notificações não recebidas
Você não está recebendo notificações no tópico do Pub/Sub. Isso pode ser causado por vários fatores:
Permissões ausentes: a conta de serviço do Knowledge Catalog perdeu o
roles/pubsub.publisherpapel no tópico.Atraso na ativação: um feed recém-criado ou atualizado pode levar até 10 minutos para ser ativado.
Tópico excluído: se o tópico de destino do Pub/Sub for excluído, o Knowledge Catalog vai parar de publicar.
Incompatibilidade de escopo ou filtro: as mudanças podem não corresponder ao escopo ou aos filtros configurados.
Para resolver o problema, verifique o seguinte:
Verifique se a conta de serviço do Knowledge Catalog tem o papel
roles/pubsub.publisherno tópico.Aguarde pelo menos 10 minutos após criar ou atualizar um feed.
Verifique se o tópico do Pub/Sub existe. Se ele foi excluído, você precisa recriá-lo.
Revise a configuração do feed para garantir que o escopo e os filtros correspondam às mudanças de metadados que você espera receber.
Notificações duplicadas
Você recebe mensagens de notificação duplicadas. O Knowledge Catalog garante a entrega "pelo menos uma vez", o que significa que mensagens duplicadas podem ocorrer, especialmente durante novas tentativas.
Configure o aplicativo de assinante para processar possíveis duplicados. É possível usar o messageId ou o carimbo de data/hora da mudança para identificar e remover mensagens duplicadas.
Problemas de conteúdo
Esta seção descreve como resolver problemas com o conteúdo das notificações de feed de mudança de metadados.
Metadados completos ausentes no payload
A mensagem de notificação contém apenas o nome do recurso e o tipo de mudança, mas não os metadados completos ou as mudanças específicas.
Isso ocorre porque, por design, as notificações de feed de mudança de metadados fornecem "assinaturas de mudança" (o que mudou) em vez do payload completo. Isso mantém as mensagens leves e evita limites de tamanho do payload.
Use o nome do recurso fornecido na notificação para chamar a API Dataplex (por exemplo, GetEntry) e recuperar o estado atual do recurso.