Resolver problemas com feeds de mudanças de metadados

Os feeds de alteração de metadados do Knowledge Catalog (antigo Dataplex Universal Catalog) permitem acompanhar as mudanças nas entradas e nos aspectos de metadados quase em tempo real, publicando notificações no Pub/Sub. Ao configurar ou monitorar esses feeds, é possível diagnosticar e resolver problemas comuns com permissões de criação de feed, perímetros do VPC Service Controls, entrega de notificações e payloads de mensagens. Para mais informações, consulte Sobre feeds de alteração de metadados.

Se precisar de ajuda para resolver um problema que não é abordado neste documento, consulte o Cloud Customer Care.

Erros de criação de feeds de mudanças de metadados

Nesta seção, descrevemos como resolver erros que podem ser encontrados ao criar feeds de alteração de metadados.

Erros de permissão negada

Você recebe um erro PERMISSION_DENIED ao tentar criar um feed de alterações de metadados.

O problema ocorre porque você ou a conta de serviço do Knowledge Catalog não têm as permissões necessárias.

Para resolver esse problema, confira estes requisitos:

  • Verifique se você tem a permissão dataplex.metadataFeeds.create.

  • Verifique se você tem a permissão dataplex.entryGroups.export no 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 papel roles/pubsub.publisher no 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 alterações de metadados e os recursos que ele monitora pertencem ao mesmo perímetro do VPC Service Controls:

  • Se o feed tiver escopo de organização, somente os projetos no mesmo perímetro serão monitorados.

  • Se o feed tiver escopo de projeto ou de grupo de entrada, verifique se todos os projetos ou grupos de entrada especificados estão no mesmo perímetro que o projeto em que você está criando o feed.

Problemas de entrega de notificações

Nesta seção, descrevemos como resolver problemas com o envio de notificações.

Notificações não recebidas

Você não está recebendo notificações no seu 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 papel roles/pubsub.publisher 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.publisher no tópico.

  • Aguarde pelo menos 10 minutos depois de criar ou atualizar um feed.

  • Verifique se o tópico do Pub/Sub existe. Se ela tiver sido excluída, será necessário recriá-la.

  • 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 lidar com possíveis duplicatas. É possível usar o messageId ou o carimbo de data/hora da alteração para identificar e eliminar a duplicação de mensagens.

Problemas de conteúdo

Nesta seção, descrevemos como resolver problemas com o conteúdo das notificações do feed de alterações de metadados.

Metadados completos ausentes no payload

A mensagem de notificação contém apenas o nome do recurso e o tipo de alteração, mas não os metadados completos ou as alterações específicas.

Ises ocorre porque, por padrão, as notificações do feed de alterações de metadados fornecem "assinaturas de alteração" (o que mudou) em vez do payload completo. Isso mantém as mensagens leves e evita limites de tamanho de 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.