Questa guida ti aiuta a risolvere i problemi di Knowledge Catalog quando importi ed esporti glossari e link alle voci, inclusi link alle voci mancanti, errori di URL del glossario non validi o quando un job di importazione non riesce.
Se hai bisogno di aiuto per risolvere un problema non trattato in questa pagina, contatta l'assistenza Google Cloud.
Correggi i link alle voci mancanti in Knowledge Catalog
Dopo aver esportato i link alle voci dal 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: assicurati di disporre delle autorizzazioni per visualizzare i link alle voci mancanti. Verifica 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 trovare il glossario specificato o non dispone delle autorizzazioni di accesso necessarie per recuperare i suoi contenuti. Alcune cause 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 o le credenziali utente autenticati 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 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.
Risolvere i problemi relativi agli errori del job di importazione di Knowledge Catalog
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 dell'utilità ha una logica di ripetizione integrata per i problemi di rete temporanei. Se l'interruzione della 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 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 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.
Risolvere gli errori relativi a URL del glossario non validi
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. Verifica che non ci sia un URL del glossario non valido nei parametri.
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 località di 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. Se il job di importazione non va a buon fine, controlla i log per individuare errori specifici. 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.