Risoluzione dei problemi

Anteprima

Questo prodotto è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici e ai Termini aggiuntivi per i prodotti in anteprima dell'AI generativa. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

VS Code

• VS Code
• Antigravity

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 il possibile errore elencato qui, prova a uscire e ad accedere di nuovo.

Errori di autenticazione e di 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 binario gcloud non si trova nel percorso del sistema.	Installa Google Cloud CLI e riavvia VS Code.
You must be logged in to both the Google Cloud CLI and ADC...	gcloud auth login o gcloud auth application-default login non è stato eseguito.	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 accedere a Google Cloud.
La barra di stato mostra un'icona $(warning).	Le impostazioni dell'estensione, come ID progetto, regione o 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 sincronizzazione delle impostazioni mentre gcloud CLI non è installato.	Installa gcloud CLI.

Errori di recupero di Explorer e dell'API

Di seguito sono riportati gli errori generali riscontrati durante la navigazione delle 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 (codice di stato HTTP 403 Forbidden), non riesce a trovare le risorse (codice di stato HTTP 404 Not Found) o l'API non è abilitata.	Verifica le autorizzazioni di Identity and Access Management (IAM); assicurati che l'API pertinente, ad esempio BigQuery, sia attivata 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 errata (ID progetto o ID set di dati mancante).	Utilizza il nome completo: project.dataset.table.

Errori BigQuery e Dataform

Gli errori seguenti 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 CLI Dataform 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 contiene contenuti NoSQL.	Verifica i contenuti della query eseguendola nella console Google Cloud .

Managed Service for Apache Spark ed errori di 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 disporre del ruolo roles/dataproc.editor; controlla se lo stato del cluster è già AGGIORNAMENTO.
Error: No cluster name found.	Errore di riferimento interno nella visualizzazione ad albero.	Aggiorna la visualizzazione di Spark Resource Explorer.
Failed to redirect to Spark UI: ${message}	Il cluster è arrestato o Component Gateway è disattivato.	Avvia il cluster e assicurati che il gateway dei componenti sia abilitato nella configurazione del cluster.
Failed to load [clusters/jobs/sessions/session templates]: [message]	Errore API	Aggiorna la visualizzazione di Spark Resource Explorer.
Failed to start Jupyter process / Pip install failed.	L'avvio del server Jupyter locale non è riuscito o l'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 sul computer.	Attiva 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?	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	Mostrato 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 Remote Kernel	Installa le dipendenze facendo clic sulla notifica e selezionando Sì nella finestra di dialogo di conferma.

Errori di Cloud Storage

Durante la gestione di bucket e oggetti vengono visualizzati i seguenti errori.

Messaggio di errore	Possibile causa	Correzione
A folder with the name... already exists.	Collisione di nomi nel bucket.	Scegli un nome 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 si trova 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 una risorsa con rappresentazione di stringa NoSQL.	Negli editor possono essere inserite solo tabelle, viste e colonne.

Errori del database

Vengono restituiti i seguenti errori durante l'esecuzione di query sui database Google Cloud .

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 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 privilegi di database a un singolo utente IAM o service account per concedere 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 abilitarla dalla console Google Cloud 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.	Attiva il flag di autenticazione IAM dalle impostazioni della query o consulta la sezione Autenticazione IAM per attivarlo dalla console Google Cloud 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 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 abilitarla dalla console Google Cloud 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.	Attiva il flag di autenticazione IAM dalle impostazioni della query o consulta la sezione Autenticazione IAM per attivarlo dalla console Google Cloud 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 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 MiB non sono supportate.	Vedi executeSql.

Passaggi successivi

• Crea pipeline di data engineering