Risoluzione dei problemi

Questo documento elenca gli errori visibili acquisiti e visualizzati dall'estensione Data Agent Kit per VS Code. Questi errori vengono in genere visualizzati come Notifiche (popup) o come Avvisi della barra di stato nell'IDE. Utilizza questa guida per identificare e risolvere i problemi.

Se non riesci a identificare l'origine di un problema dopo aver esaminato i possibili errori elencati qui, prova a uscire e ad accedere di nuovo.

Errori di autenticazione e gcloud CLI

Questi errori influiscono sulla connettività di base dell'estensione.

Messaggio di errore

Possibile causa

Correzione

Google Cloud CLI is required... but was not found.

Il file binario gcloud non è nel percorso del sistema.

Installa la Google Cloud CLI e riavvia VS Code.

You must be logged in to both the Google Cloud CLI and ADC...

Non è stato eseguito gcloud auth login o gcloud auth application-default login.

Fai clic sulla barra di stato o sulla notifica per attivare il flusso di accesso nel terminale.

La barra di stato mostra un'icona $(warning) accanto al nome dell'account.

L'account dell'estensione con cui hai eseguito l'accesso è diverso dall'account gcloud CLI attivo.

Esegui gcloud auth login e gcloud auth application-default login con lo stesso account utilizzato per l'accesso Google Cloud.

La barra di stato mostra un'icona $(warning).

Le impostazioni dell'estensione, come l'ID progetto, la regione o l'ID progetto di fatturazione, non corrispondono alle impostazioni di gcloud CLI.

Fai clic sull'icona di avviso nella barra di stato del progetto per sincronizzare le impostazioni tra l'estensione e gcloud CLI. In alternativa, aggiorna manualmente le configurazioni in uno dei due strumenti per assicurarti che corrispondano.

Cannot sync settings: gcloud CLI or ADC account does not match extension account.

Tentativo di sincronizzare le impostazioni mentre gli account non sono coerenti.

Allinea gli account tra gcloud CLI e l'estensione. Assicurati che utilizzino lo stesso account utente, progetto, regione e progetto di fatturazione.

Cannot sync settings: Google Cloud CLI is not installed.

Tentativo di sincronizzare le impostazioni mentre gcloud CLI non è installato.

Installa gcloud CLI.

Errori di recupero dell'Explorer e dell'API

Di seguito sono riportati gli errori generali riscontrati durante la navigazione nelle risorse cloud nell'albero del menu di Google Cloud Data Agent Kit.

Messaggio di errore

Possibile causa

Correzione

Failed to load ${itemKind}: ${error.message}

Il server non può autorizzare la tua richiesta (HTTP 403 Forbidden codice di stato), non riesce a trovare le risorse (HTTP 404 Not Found codice di stato) o l'API non è abilitata.

Verifica le autorizzazioni di Identity and Access Management (IAM) e assicurati che l'API pertinente ad esempio BigQuery, sia abilitata nelle impostazioni.

No Google Cloud project selected.

È stata attivata una funzionalità senza un progetto attivo.

Utilizza il selettore dei progetti nella barra di stato per selezionare un progetto.

Invalid table name format: ${tableName}

Convenzione di denominazione non corretta (mancano l'ID progetto o l'ID set di dati).

Utilizza il nome completo: project.dataset.table.

Errori di BigQuery e Dataform

I seguenti errori sono specifici delle trasformazioni SQL e della gestione dei progetti Dataform.

Messaggio di errore

Possibile causa

Correzione

Dataform CLI is not installed. Dataform features will not work.

Il pacchetto npm Dataform non è installato a livello globale.

Fai clic su Installa Dataform CLI nella finestra di dialogo per automatizzare l'installazione.

Failed to compile project in folder...: ${stderr}

Errori di sintassi nei file .sqlx o workflow_settings.yaml non valido.

Controlla la visualizzazione Compiled Query di Dataform per errori di sintassi specifici.

Failed to run Dataform project: ${message}

Errore di esecuzione del job BigQuery.

Esamina la cronologia dei job BigQuery per i log di esecuzione dettagliati.

No content found for saved query: ${label}

La voce Knowledge Catalog o BigQuery esiste, ma non contiene contenuti NoSQL.

Verifica i contenuti della query eseguendola nella Google Cloud console.

Errori di Managed Service for Apache Spark e Spark

I seguenti errori sono correlati alla gestione dei cluster e all'esecuzione di Spark.

Messaggio di errore

Possibile causa

Correzione

Error starting/stopping/restarting cluster ${name}: ${message}

Autorizzazioni IAM insufficienti o cluster in transizione.

Assicurati di avere il ruolo roles/dataproc.editor; controlla se lo stato del cluster è già UPDATING.

Error: No cluster name found.

Errore di riferimento interno nella visualizzazione ad albero.

Aggiorna la visualizzazione Spark Resource Explorer.

Failed to redirect to Spark UI: ${message}

Il cluster è arrestato o Component Gateway è disabilitato.

Avvia il cluster e assicurati che Component Gateway sia abilitato nella configurazione del cluster.

Failed to load [clusters/jobs/sessions/session templates]: [message]

Errore API

Aggiorna la visualizzazione Spark Resource Explorer.

Failed to start Jupyter process / Pip install failed.

Avvio del server Jupyter locale non riuscito o installazione dei pacchetti richiesti non riuscita.

Apri un nuovo notebook Spark con il kernel remoto.

No sample notebooks found for the selected kernel type.

I notebook di esempio per il tipo di kernel selezionato (locale o remoto) non sono disponibili.

Non applicabile

This system does not have Windows Long Path support enabled. Please enable long paths and restart VS Code to work with Spark Notebooks on remote kernels. Learn More

Questo vale in particolare per gli utenti Windows quando i percorsi lunghi non sono abilitati sulla macchina.

Abilita i percorsi lunghi facendo riferimento al link nella notifica.

google-cloud-jupyter-config and jupyter_server are required to connect to remote kernels on Managed Service for Apache Spark. Install them?

Questo messaggio viene visualizzato quando l'utente tenta di utilizzare un kernel remoto per la prima volta.

Installa le dipendenze facendo clic sulla notifica e selezionando Sì nella finestra di dialogo di conferma.

Requires package installation

Visualizzato nella descrizione del selettore del kernel accanto a Kernel remoto se mancano le dipendenze di Jupyter.

Installa le dipendenze facendo clic sulla notifica e selezionando Sì nella finestra di dialogo di conferma.

Install dependencies for remote Spark kernels. Require google-cloud-jupyter-config and jupyter_server

Visualizzato nella descrizione del selettore del kernel quando l'utente esegue un notebook esistente su Kernel remoto.

Installa le dipendenze facendo clic sulla notifica e selezionando Sì nella finestra di dialogo di conferma.

Errori di Cloud Storage

I seguenti errori vengono visualizzati durante la gestione di bucket e oggetti.

Messaggio di errore

Possibile causa

Correzione

A folder with the name... already exists.

Conflitto di denominazione nel bucket.

Scegli un nome di cartella univoco.

Upload/Download failed: ${message}

Autorizzazione negata o timeout di rete.

Verifica i ruoli Storage Object Admin o Creator.

Failed to create bucket: ${message}

Nome già utilizzato a livello globale o caratteri non validi.

Segui le regole di denominazione dei bucket Cloud Storage.

Errori generici dell'interfaccia

Questi errori indicano errori a livello di UI.

Messaggio di errore

Possibile causa

Correzione

No workspace folder open.

L'utente è in modalità Nessuna cartella in VS Code.

Apri una cartella utilizzando File > Open Folder.

No active notebook editor found.

Stai eseguendo comandi Spark o SQL senza un notebook aperto.

Apri un file .ipynb o .sql.

Cannot insert item: unsupported resource type.

Tentativo di trascinare e rilasciare una risorsa con rappresentazione di stringa NoSQL.

Negli editor possono essere inserite solo tabelle, viste e colonne.

Errori del database

I seguenti errori vengono restituiti durante l'esecuzione di query sui Google Cloud database.

AlloyDB

Messaggio di errore

Possibile causa

Correzione

postgresql error: role "[USER_EMAIL]" does not exist

L'utente che ha eseguito l'accesso all'estensione non è stato aggiunto come utente IAM all'istanza.

Consulta Gestire l'autenticazione IAM per aggiungere l'utente come utente IAM.

postgresql error: permission denied for table [TABLE_NAME]

L'utente IAM non dispone dell'autorizzazione per l' oggetto.

Consulta Concedere le autorizzazioni di database appropriate agli utenti IAM per concedere l'autorizzazione all'utente IAM per l'oggetto.

Cloud SQL per MySQL

Messaggio di errore Possibile causa Correzione
Invalid request: Some of your SQL statements failed to execute. Details: Error 1045 (28000): Access denied for user '[USER]'@'localhost' (using password: YES). L'utente che ha eseguito l'accesso all'estensione non è stato aggiunto come utente IAM all'istanza. Consulta Autenticazione IAM autenticazione per aggiungere l'utente come utente IAM per l' istanza.
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. L'utente IAM non dispone dell'autorizzazione per accedere al database. Consulta Concedere i privilegi di database a un singolo utente IAM o service account per concedere i privilegi agli utenti IAM per il database.
Invalid request: The instance doesn't allow using ExecuteSql to access this instance. You can allow it by patching the instance with {settings: { dataApiAccess: "ALLOW_DATA_API" }}. L'accesso all'API Data non è abilitato. Abilita l'accesso all'API Data dalle impostazioni della query o consulta Eseguire istruzioni SQL utilizzando l'API Cloud SQL Data per abilitarlo dalla Google Cloud console o da gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. Il flag di autenticazione IAM non è abilitato. Abilita il flag di autenticazione IAM dalle impostazioni della query o consulta Autenticazione IAM per abilitarlo dalla Google Cloud console o da gcloud CLI.

Cloud SQL per PostgreSQL

Messaggio di errore Possibile causa Correzione
Invalid request: The instance doesn't allow using ExecuteSql to access this instance. You can allow it by patching the instance with {settings: { dataApiAccess: "ALLOW_DATA_API" }}. L'accesso all'API Data non è abilitato. Abilita l'accesso all'API Data dalle impostazioni della query o consulta Eseguire istruzioni SQL utilizzando l' API Cloud SQL Data per abilitarlo dalla Google Cloud console o da gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. Il flag di autenticazione IAM non è abilitato. Abilita il flag di autenticazione IAM dalle impostazioni della query o consulta Autenticazione IAM per abilitarlo dalla Google Cloud console o da gcloud CLI.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER_EMAIL]". L'utente che ha eseguito l'accesso all'estensione non è stato aggiunto come utente IAM all'istanza. Consulta Autenticazione IAM per aggiungere l'utente come utente IAM per l'istanza.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] L'utente IAM non dispone dell'autorizzazione per accedere all'oggetto. Consulta Gestire gli utenti con l'autenticazione IAM dei database per concedere i privilegi agli utenti IAM per il database.

Spanner

Messaggio di errore

Possibile causa

Correzione

Result set too large. Result sets larger than 10.00M can only be yielded through the streaming API.

Le dimensioni dei risultati superiori a 10,00 MiB non sono supportate.

See executeSql.

Passaggi successivi