Knowledge Catalog (precedentemente Dataplex Universal Catalog) ti consente di importare ed esportare in blocco glossari aziendali e link alle voci per gestire il tuo vocabolario aziendale su larga scala. Quando esegui gli script dell'utilità di importazione o esportazione, puoi diagnosticare e risolvere problemi comuni come link di voci mancanti, esportazioni di glossari vuoti, URL di glossari o fogli di lavoro non validi, job di importazione interrotti e timeout di rete degli script. Per saperne di più, consulta Informazioni sull'importazione e sull'esportazione di glossari e link alle voci.
Se hai bisogno di aiuto per risolvere un problema non trattato in questo documento, consulta Assistenza clienti Google Cloud.
Correggi i link delle voci mancanti in Knowledge Catalog
Dopo aver esportato i link alle voci da Knowledge Catalog a un foglio Google eseguendo l'utilità di esportazione dei link alle voci, noti che alcuni link alle voci (associazioni) non sono presenti nel foglio Google generato.
Questo problema si verifica se l'utilità di esportazione salta automaticamente i link alle voci a causa delle seguenti condizioni:
Autorizzazioni insufficienti (risorse oscurate): non disponi delle autorizzazioni IAM necessarie per visualizzare la voce di origine o la voce di destinazione associata al link.
Tipo di link della voce non valido: il link della voce utilizza un tipo di relazione non supportato o non riconosciuto. I tipi validi sono limitati a
definition,relatedesynonym.Riferimenti alle voci incompleti: nei metadati della voce mancano i campi dello schema obbligatori, per cui il controllo di convalida ignora la risorsa.
Per risolvere il problema, esegui i seguenti controlli:
Verifica le autorizzazioni: assicurati di disporre delle autorizzazioni per visualizzare i link delle voci mancanti. Verifica che all'entità che esegue lo script siano stati concessi i ruoli richiesti.
Ispeziona i log di esecuzione: controlla i log del terminale o dello script per verificare se sono presenti avvisi contenenti
Skipping redacted entrylink. I log mostrano gli ID risorsa specifici dei link alle voci ignorati e il motivo per cui sono stati omessi.Verifica la validità dello schema dei link: se in precedenza hai modificato questi link in modo programmatico, verifica che le loro proprietà corrispondano ai requisiti dello schema.
Errore: nessun termine trovato nel glossario
Quando
esporti i glossari in un foglio Google,
l'esecuzione non va a buon fine o restituisce un risultato vuoto con il messaggio
No terms found in the glossary, anche se il glossario aziendale contiene
termini attivi.
Questo problema si verifica se lo script non riesce a individuare il glossario specificato o non dispone delle autorizzazioni di accesso necessarie per recuperarne i contenuti. Di seguito sono elencate alcune delle possibili cause:
- URL del glossario errato: l'URL del glossario configurato nei parametri di esecuzione è errato o contiene errori di ortografia.
- Autorizzazioni IAM insufficienti: il service account autenticato o le credenziali utente che eseguono lo script non dispongono dell'autorizzazione per visualizzare o elencare i termini all'interno del glossario di destinazione.
- ID glossario non corrispondente: l'ID glossario specificato nel comando dello script non corrisponde all'ID risorsa del glossario effettivo in Knowledge Catalog.
Per risolvere il problema, verifica la configurazione e le autorizzazioni:
Controlla l'ID glossario: nella console Google Cloud , vai alla pagina Knowledge Catalog Glossari, seleziona il tuo glossario e verifica che l'ID risorsa corrisponda all'ID che stai passando allo script di utilità.
Verifica le autorizzazioni IAM: verifica che alle tue credenziali autenticate (il account di servizio o l'account utente di cui hai eseguito l'impersonificazione) siano stati concessi i ruoli richiesti.
Convalida la struttura dell'URL del glossario: se passi un percorso o un URL di risorsa diretto allo script, assicurati che segua il formato corretto della risorsa del Knowledge Catalog:
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID
Avviso: voci non trovate in Knowledge Catalog
Durante un'operazione di importazione dei link di accesso, lo script si mette in pausa e visualizza un avviso simile al seguente:
Found X entries not found in Knowledge Catalog. EntryLinks associated with
these entries will be skipped. Continue with import? [y/N]:
Questo problema si verifica se il foglio Google contiene link alle voci che fanno riferimento ad asset di dati o termini del glossario che non esistono in Knowledge Catalog.
Per risolvere il problema, scegli una delle seguenti opzioni:
Per procedere con un'importazione parziale, digita
yal prompt. L'utilità importa tutti i link alle voci validi e salta solo i link che fanno riferimento alle risorse mancanti.Per annullare e correggere le risorse mancanti, digita
nper annullare l'esecuzione. Verifica che gli ID voce nel documento di origine corrispondano esattamente ai nomi delle risorse nel Knowledge Catalog. Correggi eventuali risorse mancanti o errori di battitura, quindi esegui di nuovo lo script di importazione.
Risolvi i problemi relativi ai job di importazione di Knowledge Catalog non riusciti
Se un job di importazione viene interrotto o non va a buon fine durante l'esecuzione, non è necessario riavviare l'intero processo o modificare il foglio Google di origine.
L'utilità monitora i batch importati correttamente utilizzando una cartella di archivio nel bucket di gestione temporanea di Cloud Storage.
Per riprendere il job:
Esegui di nuovo l'utilità di importazione. L'utilità rileva lo stato dell'esecuzione precedente e visualizza il seguente prompt:
Found X existing file(s) in archive folder from a previous incomplete import Continue using existing files? [y/N]:Digita
yL'utilità ignora i batch già importati correttamente ed elabora solo i file rimanenti.
Timeout degli script o errori SSL durante l'esecuzione
Durante l'esecuzione dello script dell'utilità di importazione o esportazione, l'esecuzione si interrompe, scade o restituisce errori SSL nel terminale.
Questo problema si verifica a causa dei seguenti errori a livello di rete:
- Intercettazione del proxy o del firewall aziendale: un proxy o un firewall di sicurezza intercetta e ispeziona il traffico HTTPS, invalidando i certificati SSL.
- Limitazioni VPN attive: la configurazione della VPN limita il traffico in uscita verso determinati endpoint delle API Google Cloud o di Fogli Google.
- Instabilità della rete locale: un calo temporaneo della connessione a internet ha interrotto la sessione.
Per risolvere questi problemi di rete, prova i seguenti passaggi:
Assicurati di avere una connessione di rete stabile.
Controlla le impostazioni del proxy e del firewall
Controlla la configurazione della VPN.
Affidati ai tentativi di ripetizione integrati: lo script di utilità ha una logica di ripetizione integrata per i problemi di rete temporanei. Se l'interruzione della rete è momentanea, attendi che lo script completi i tentativi di ripetizione prima di riavviare l'esecuzione.
Errore URL del foglio di lavoro non valido
Quando tenti di eseguire un'utilità di importazione o esportazione, l'interfaccia a riga di comando restituisce un errore Invalid spreadsheet URL e interrompe l'esecuzione.
Questo problema si verifica se lo script non riesce ad analizzare il link di Fogli Google fornito o non dispone dell'autorizzazione per visualizzare il file. Di seguito sono elencate alcune delle possibili cause:
- URL non valido: l'URL non corrisponde al formato del percorso standard di Fogli Google.
- ID foglio di lavoro mancante: nel percorso manca l'ID alfanumerico univoco che rimanda al foglio specifico.
- Limitazioni di accesso: il tuo account di servizio autenticato non dispone dell'autorizzazione per visualizzare o modificare il foglio, impedendo all'utilità di convalidare il link.
Per risolvere il problema, verifica il link del foglio di lavoro e le impostazioni di accesso:
Convalida il prefisso dell'URL: assicurati che l'URL del foglio di lavoro che passi all'utilità inizi con il seguente percorso standard di Fogli Google:
https://docs.google.com/spreadsheets/Verifica l'ID del foglio di lavoro: controlla che l'URL includa l'ID univoco del foglio. Un URL valido deve seguire questa struttura:
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/editControlla le autorizzazioni di accesso: apri il foglio Google in un browser, fai clic su Condividi e verifica di aver aggiunto l'indirizzo email del account di servizio come Editor.
Risolvi gli errori relativi agli URL dei glossari non validi
Quando provi a eseguire un'utilità di importazione o esportazione per i glossari, l'interfaccia a riga di comando restituisce un errore Invalid glossary URL e interrompe l'esecuzione. Verifica che nei parametri non sia presente un URL del glossario non valido.
Questo problema si verifica se lo script non riesce ad analizzare il percorso della risorsa del glossario di Knowledge Catalog fornito o non dispone dell'autorizzazione per visualizzare la risorsa. Di seguito sono elencate alcune delle possibili cause:
- Percorso della risorsa non valido: il percorso della risorsa non corrisponde al formato standard del percorso del glossario di Knowledge Catalog.
- ID non valido: il percorso contiene un ID progetto, una località della regione o un ID glossario non validi.
- Limitazioni di accesso o risorsa mancante: il glossario non esiste o il tuo account di servizio autenticato non dispone delle autorizzazioni IAM necessarie per accedervi.
Per risolvere il problema, verifica il percorso della risorsa del glossario e le credenziali:
Convalida la struttura del percorso della risorsa: assicurati che il percorso del glossario che passi all'utilità corrisponda al seguente formato standard di Knowledge Catalog:
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_IDVerifica gli identificatori nel percorso: utilizza l'ID progetto, la località e l'ID glossario corretti.
Verifica l'esistenza e l'accesso alle risorse: verifica che il glossario esista con l'ID specificato e che al tuo account di servizio autenticato siano stati concessi i ruoli IAM necessari.
Visualizza log di esecuzione
Le utilità di importazione ed esportazione generano log di esecuzione dettagliati durante l'esecuzione. Se il job di importazione non va a buon fine, controlla i log per individuare errori specifici. Questi log ti aiutano a controllare il processo di trasferimento e a identificare le voci saltate o gli avvisi di formattazione.
- Posizione dei log: le utilità di importazione ed esportazione scrivono i file di log nella directory
logs/nel percorso di esecuzione locale. - Formato dei log: a ogni file di log viene aggiunto un timestamp per consentirti di individuare i log di un'esecuzione specifica.