Questo documento descrive come risolvere i problemi e gli errori comuni che potresti riscontrare durante l'importazione e l'esportazione di glossari e link alle voci in Knowledge Catalog (precedentemente Dataplex Universal Catalog).
Se hai bisogno di aiuto per risolvere un problema non trattato in questa pagina, contatta l'assistenza Google Cloud.
Link alle voci mancanti nel foglio Google esportato
Dopo aver esportato i link alle voci da Knowledge Catalog in 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 modificate): non disponi delle autorizzazioni IAM necessarie per visualizzare la voce di origine o la voce di destinazione associata al link.
Tipo di link di voce non valido: il link di 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, pertanto il controllo di convalida ignora la risorsa.
Per risolvere il problema, esegui i seguenti controlli:
Verifica delle autorizzazioni: conferma che all'entità che esegue lo script siano stati concessi i ruoli richiesti.
Controlla i log di esecuzione: verifica la presenza di avvisi contenenti
Skipping redacted entrylinknel terminale o nei log dello script. I log restituiscono gli ID risorsa specifici dei link delle voci ignorate e il motivo per cui sono stati omessi.Controlla 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.
Nessun termine trovato nell'errore del 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. Alcune delle cause più comuni sono:
- URL del glossario errato: l'URL del glossario configurato nei parametri di esecuzione è errato o contiene errori ortografici.
- 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 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 Glossari di Knowledge Catalog, seleziona il glossario e verifica che l'ID risorsa corrisponda all'ID che stai passando allo script dell'utilità.
Verifica le autorizzazioni IAM: conferma che le credenziali autenticate (il account di servizio o il tuo account utente rappresentato) dispongano dei ruoli richiesti.
Convalida la struttura dell'URL del glossario: se stai passando un percorso di risorsa diretto o un URL allo script, assicurati che segua il formato corretto della risorsa Knowledge Catalog:
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID
Avviso relativo alle voci non trovate in Knowledge Catalog
Durante un'operazione di importazione dei link di accesso, lo script si interrompe e mostra 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 ignora 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 le risorse mancanti o gli errori tipografici, quindi esegui di nuovo lo script di importazione.
Il job di importazione non riesce o viene interrotto a metà
Se un job di importazione viene interrotto o non va a buon fine a metà dell'esecuzione, non è necessario riavviare l'intera procedura o modificare il foglio Google di origine.
L'utilità tiene traccia dei batch importati correttamente utilizzando una cartella di archivio nel bucket di staging 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 dello script o errori SSL durante l'esecuzione
Durante l'esecuzione dello script dell'utilità di importazione o esportazione, l'esecuzione si interrompe, si verifica un timeout o vengono restituiti 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 di sicurezza o un firewall intercetta e ispeziona il traffico HTTPS, invalidando i certificati SSL.
- Limitazioni VPN attive: la configurazione della VPN limita il traffico in uscita a determinati endpoint Google Cloud API o Google Sheets.
- Instabilità della rete locale: un calo temporaneo della connettività 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.
Fai affidamento sui tentativi integrati: lo script di utilità ha una logica di ripetizione integrata per i problemi di rete temporanei. Se l'interruzione di rete è momentanea, attendi che lo script termini i tentativi di ripetizione prima di riavviare l'esecuzione.
Errore URL 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 del foglio Google fornito o non dispone dell'autorizzazione per visualizzare il file. Alcune cause comuni sono:
- URL non valido: l'URL non corrisponde al formato standard del percorso di Fogli Google.
- ID foglio di lavoro mancante: nel percorso manca l'ID alfanumerico univoco che rimanda al tuo foglio specifico.
- Limitazioni di accesso: il tuo account di servizio autenticato non ha l'autorizzazione per visualizzare o modificare il foglio, impedendo all'utilità di convalidare il link.
Per risolvere il problema, verifica il link al foglio di lavoro e le impostazioni di accesso:
Convalida il prefisso 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 foglio di lavoro: conferma 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'email del tuo account di servizio come Editor.
Errore URL glossario non valido
Quando tenti di 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.
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. Alcune cause comuni sono:
- Percorso della risorsa non valido: il percorso della risorsa non corrisponde al formato standard del percorso del glossario di Knowledge Catalog.
- ID errato: il percorso contiene un ID progetto, una posizione della regione o un ID glossario errati.
- Limitazioni di accesso o risorsa mancante: il glossario non esiste o il tuo account di serviziot autenticato non dispone delle autorizzazioni IAM necessarie per accedervi.
Per risolvere il problema, verifica il percorso e le credenziali della risorsa del glossario:
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 posizione e l'ID glossario corretti.
Conferma l'esistenza e l'accesso alle risorse: verifica che il glossario esista con l'ID specificato e che al 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. Questi log ti aiutano a controllare la procedura 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 log: a ogni file di log viene aggiunto un timestamp per consentirti di individuare i log per un'esecuzione specifica.