Questo documento ti aiuta a risolvere i problemi più comuni relativi ai feed di modifiche ai metadati di Dataplex Universal Catalog.
Errori di creazione dei feed di modifica dei metadati
Questa sezione descrive come risolvere gli errori che potresti riscontrare durante la creazione di feed di modifiche ai metadati.
Errori di autorizzazione negata
Ricevi un errore PERMISSION_DENIED quando provi a creare un feed di modifiche ai metadati.
Il problema si verifica perché a te o all'account di servizio Dataplex Universal Catalog potrebbero mancare le autorizzazioni richieste.
Per risolvere il problema, esamina questi requisiti:
Assicurati di disporre dell'autorizzazione
dataplex.metadataFeeds.create.Assicurati di disporre dell'autorizzazione
dataplex.entryGroups.exportnell'ambito del feed (organizzazione, progetto o gruppo di voci).Assicurati che il account di servizio Dataplex Universal 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
Quando crei un feed, ricevi un errore PERMISSION_DENIED o dei Controlli di servizio VPC.
Per risolvere il problema, verifica che il feed delle modifiche ai metadati e le risorse che monitora appartengano allo stesso perimetro dei Controlli di servizio VPC:
Se il feed è limitato all'organizzazione, vengono monitorati solo i progetti all'interno dello stesso perimetro.
Se il feed ha ambito a livello di progetto o di 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 pubblicazione delle notifiche
Questa sezione descrive come risolvere i problemi relativi alla distribuzione delle notifiche.
Notifiche non ricevute
Non ricevi notifiche nell'argomento Pub/Sub. Ciò può essere causato da diversi fattori:
Autorizzazioni mancanti: il account di servizio Dataplex Universal Catalog ha perso il ruolo
roles/pubsub.publishernell'argomento.Ritardo di attivazione: un feed appena creato o aggiornato può richiedere fino a 10 minuti per diventare attivo.
Argomento eliminato: se l'argomento Pub/Sub di destinazione viene eliminato, Dataplex Universal Catalog interrompe la pubblicazione.
Mancata corrispondenza di ambito o filtro: le modifiche potrebbero non corrispondere all'ambito o ai filtri configurati.
Per risolvere il problema, verifica quanto segue:
Verifica che il account di servizio Dataplex Universal Catalog abbia il ruolo
roles/pubsub.publishernell'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. Il Catalogo universale Dataplex garantisce la consegna "almeno una volta", il che significa che potrebbero verificarsi messaggi duplicati, soprattutto durante i nuovi tentativi.
Configura l'applicazione dell'abbonato per gestire i potenziali duplicati. Puoi utilizzare messageId o il timestamp di modifica per identificare ed eliminare i duplicati dei messaggi.
Problemi relativi ai contenuti
Questa sezione descrive come risolvere i problemi relativi al contenuto delle notifiche dei feed di modifica 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 progettazione, le notifiche del feed delle modifiche ai metadati forniscono "firme di modifica" (cosa è cambiato) anziché il payload completo. In questo modo i messaggi rimangono leggeri ed evitano i limiti di dimensione del payload.
Utilizza il nome della risorsa fornito nella notifica per chiamare l'API Dataplex Universal Catalog (ad esempio GetEntry) e recuperare lo stato attuale della risorsa.