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.
Correggere i link alle voci mancanti in Knowledge Catalog
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 hai le autorizzazioni IAM necessarie per visualizzare la voce di origine o la voce di destinazione associata al link.
Tipo di link alla voce non valido: il link alla 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 salta la risorsa.
Per risolvere il problema, esegui i seguenti controlli:
Verifica le autorizzazioni: assicurati di avere le 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: controlla il terminale o i log dello script per individuare gli avvisi contenenti
Skipping redacted entrylink. I log restituiscono gli ID risorsa specifici dei link alle voci saltati e il motivo per cui sono stati omessi.Controlla la validità dello schema dei link: se in precedenza hai modificato questi link a livello di programmazione, verifica che le relative proprietà corrispondano ai requisiti dello schema.
Errore "Non è stato trovato alcun termine nel glossario"
Quando
esporti i glossari in un Foglio Google,
l'esecuzione non riesce 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 recuperarne i contenuti. Le cause comuni includono:
- URL del glossario errato: l'URL del glossario configurato nei parametri di esecuzione è errato o contiene errori di battitura.
- Autorizzazioni IAM insufficienti: il service account autenticato o le credenziali utente che eseguono lo script non hanno l'autorizzazione per visualizzare o elencare i termini all'interno del glossario di destinazione.
- Mancata corrispondenza dell'ID del glossario: l'ID del 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 del glossario: nella Google Cloud console, 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: verifica che alle credenziali autenticate (il account di servizio o l'account utente rappresentato) siano stati concessi i ruoli richiesti.
Convalida la struttura dell'URL del glossario: se stai passando un percorso o un URL della risorsa diretto allo script, assicurati che segua il formato corretto della risorsa di Knowledge Catalog:
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID
Avviso "Voci non trovate in Knowledge Catalog"
Durante un'operazione di importazione dei link alle voci, lo script si mette in pausa 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 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 delle voci nel documento di origine corrispondano esattamente ai nomi delle risorse in Knowledge Catalog. Correggi le risorse mancanti o gli errori di battitura, quindi esegui di nuovo lo script di importazione.
Risolvere i problemi relativi ai job di importazione di Knowledge Catalog non riusciti
Se un job di importazione viene interrotto o non riesce a metà dell'esecuzione, non devi riavviare l'intero processo o modificare il Foglio Google di origine.
L'utilità tiene traccia dei 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 mostra il seguente prompt:
Found X existing file(s) in archive folder from a previous incomplete import Continue using existing files? [y/N]:Digita
y. L'utilità salta 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, va in timeout o restituisce errori SSL nel terminale.
Questo problema si verifica a causa dei seguenti errori a livello di rete:
- Intercettazione del proxy aziendale o del firewall: un proxy di sicurezza o un firewall intercetta e ispeziona il traffico HTTPS, invalidando i certificati SSL.
- Restrizioni VPN attive: la configurazione VPN limita il traffico in uscita a determinati Google Cloud endpoint delle API o di Fogli Google.
- Instabilità della rete locale: un'interruzione temporanea della connettività internet ha interrotto la sessione.
Per risolvere questi problemi di rete, prova a seguire questi passaggi:
Assicurati di avere una connessione di rete stabile.
Controlla le impostazioni del proxy e del firewall
Controlla la configurazione VPN.
Affidati ai tentativi integrati: lo script dell'utilità ha una logica di tentativi integrata per i problemi di rete temporanei. Se l'interruzione della rete è momentanea, attendi che lo script completi i tentativi 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 del Foglio Google fornito o non ha l'autorizzazione per visualizzare il file. Le cause comuni includono:
- URL non valido: l'URL non corrisponde al formato del percorso standard di Fogli Google.
- ID del foglio di lavoro mancante: nel percorso manca l'ID alfanumerico univoco che rimanda al foglio specifico.
- Restrizioni di accesso: il 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 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: verifica 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.
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 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 ha l'autorizzazione per visualizzare la risorsa. Le cause comuni includono:
- Percorso della risorsa non valido: il percorso della risorsa non corrisponde al formato del percorso del glossario standard di Knowledge Catalog.
- ID errato: il percorso contiene un ID progetto, una località della regione o un ID del glossario errato.
- Restrizioni di accesso o risorsa mancante: il glossario non esiste oppure il 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 del glossario corretti.
Verifica l'esistenza e l'accesso alla risorsa: verifica che il glossario esista con l'ID specificato e che account di servizio autenticato siano stati concessi i ruoli IAM necessari.
Visualizzare log di esecuzione
Le utilità di importazione ed esportazione generano log di esecuzione dettagliati durante l'esecuzione. Se il job di importazione non riesce, 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 in modo da poter individuare i log per un'esecuzione specifica.