I feed delle modifiche dei metadati di Knowledge Catalog (in precedenza Dataplex Universal Catalog) ti consentono di monitorare le modifiche alle voci e agli aspetti dei metadati quasi in tempo reale pubblicando notifiche in Pub/Sub. Durante la configurazione o il monitoraggio di questi feed, puoi diagnosticare e risolvere i problemi comuni relativi alle autorizzazioni di creazione dei feed, ai perimetri dei Controlli di servizio VPC, alla distribuzione delle notifiche e ai payload dei messaggi. Per saperne di più, consulta Informazioni sui feed delle modifiche dei metadati.
Se hai bisogno di aiuto per risolvere un problema non trattato in questo documento, consulta Assistenza clienti Google Cloud.
Errori di creazione dei feed di modifica dei metadati
Questa sezione descrive come risolvere gli errori che potresti riscontrare durante la creazione dei feed di modifiche dei metadati.
Errori di autorizzazione negata
Ricevi un errore PERMISSION_DENIED quando provi a creare un feed delle modifiche dei metadati.
Il problema si verifica perché tu o il account di servizio di Knowledge Catalog potreste non disporre delle autorizzazioni richieste.
Per risolvere il problema, esamina i seguenti requisiti:
Assicurati di avere l'autorizzazione
dataplex.metadataFeeds.create.Assicurati di disporre dell'autorizzazione
dataplex.entryGroups.exportper l'ambito del feed (organizzazione, progetto o gruppo di voci).Assicurati che il account di servizio Knowledge Catalog (
service-{PROJECT_NUMBER}@gcp-sa-dataplex.iam.gserviceaccount.com) abbia il ruoloroles/pubsub.publishernell'argomento Pub/Sub di destinazione.
Errori dei Controlli di servizio VPC
Ricevi un errore PERMISSION_DENIED o dei Controlli di servizio VPC durante la creazione di un feed.
Per risolvere il problema, verifica che il feed delle modifiche dei metadati e le risorse che monitora appartengano allo stesso perimetro dei Controlli di servizio VPC:
Se il feed ha come ambito l'organizzazione, vengono monitorati solo i progetti all'interno dello stesso perimetro.
Se il feed ha come ambito un progetto o un gruppo di voci, assicurati che tutti i progetti o i gruppi di voci specificati si trovino nello stesso perimetro del progetto in cui stai creando il feed.
Problemi di invio delle notifiche
Questa sezione descrive come risolvere i problemi relativi alla consegna delle notifiche.
Notifiche non ricevute
Non ricevi notifiche nel tuo argomento Pub/Sub. Questo può essere dovuto a diversi fattori:
Autorizzazioni mancanti: il account di servizio di Knowledge Catalog ha perso il ruolo
roles/pubsub.publishernell'argomento.Ritardo di attivazione: l'attivazione di un feed appena creato o aggiornato può richiedere fino a 10 minuti.
Argomento eliminato: se l'argomento Pub/Sub di destinazione viene eliminato, Knowledge Catalog interrompe la pubblicazione.
Mancata corrispondenza dell'ambito o dei filtri: le modifiche potrebbero non corrispondere all'ambito o ai filtri configurati.
Per risolvere il problema, verifica quanto segue:
Verifica che il account di servizio Knowledge Catalog abbia il ruolo
roles/pubsub.publisherper l'argomento.Attendi almeno 10 minuti dopo aver creato o aggiornato un feed.
Controlla se l'argomento Pub/Sub esiste. Se è stato eliminato, devi ricrearlo.
Controlla la configurazione del feed per assicurarti che l'ambito e i filtri corrispondano alle modifiche ai metadati che prevedi di ricevere.
Notifiche duplicate
Ricevi messaggi di notifica duplicati. Knowledge Catalog garantisce la consegna "almeno una volta", il che significa che potrebbero verificarsi messaggi duplicati, soprattutto durante i nuovi tentativi.
Configura l'applicazione del sottoscrittore in modo che gestisca i potenziali duplicati. Puoi utilizzare messageId o il timestamp della modifica per identificare ed eliminare i messaggi duplicati.
Problemi con i contenuti
Questa sezione descrive come risolvere i problemi relativi ai contenuti delle notifiche del feed delle modifiche dei metadati.
Metadati completi mancanti nel payload
Il messaggio di notifica contiene solo il nome della risorsa e il tipo di modifica, ma non i metadati completi o le modifiche specifiche.
Questo perché, per impostazione predefinita, le notifiche del feed delle modifiche dei metadati forniscono "firme delle modifiche" (cosa è cambiato) anziché il payload completo. In questo modo i messaggi rimangono leggeri e si evitano i limiti di dimensione del payload.
Utilizza il nome della risorsa fornito nella notifica per chiamare l'API Dataplex (ad esempio, GetEntry) e recuperare lo stato attuale della risorsa.