Messaggi di errore

Questo documento descrive i messaggi di errore che potresti riscontrare quando utilizzi BigQuery, inclusi i codici di errore HTTP e i passaggi per la risoluzione dei problemi suggeriti.

Per saperne di più sugli errori di query, consulta Risolvere gli errori di query.

Per ulteriori informazioni sugli errori di inserimento di flussi di dati, consulta Risolvere i problemi di inserimento di flussi di dati.

Tabella degli errori

Le risposte dell'API BigQuery includono un codice di errore HTTP e un oggetto errore nel corpo della risposta. Un oggetto errore è in genere uno dei seguenti:

• Un oggetto errors, che contiene un array di oggetti ErrorProto.
• Un oggetto errorResults, contenente un singolo oggetto ErrorProto.

La colonna Messaggio di errore nella tabella seguente corrisponde alla proprietà reason in un oggetto ErrorProto.

La tabella non include tutti i possibili errori HTTP o altri errori di rete. Pertanto, non dare per scontato che un oggetto errore sia presente in ogni risposta di errore di BigQuery. Inoltre, potresti ricevere errori o oggetti errore diversi se utilizzi le librerie client Cloud per l'API BigQuery. Per ulteriori informazioni, consulta le librerie client dell'API BigQuery.

Se ricevi un codice di risposta HTTP che non compare nella tabella seguente, il codice di risposta indica un problema o un risultato previsto con la richiesta HTTP. I codici di risposta nell'intervallo 5xx indicano un errore lato server. Se ricevi un codice risposta 5xx, riprova a inviare la richiesta in un secondo momento. In alcuni casi, un codice di risposta 5xx potrebbe essere fornito da un server intermedio, ad esempio un proxy. Esamina il corpo della risposta e le intestazioni della risposta per avere dettagli sull'errore. Per un elenco completo dei codici di risposta HTTP, consulta Codici di risposta HTTP.

Se utilizzi lo strumento a riga di comando bq per controllare lo stato del job, l'oggetto errore non viene restituito per impostazione predefinita. Per visualizzare l'oggetto errore e la proprietà reason corrispondente che si mappa alla tabella seguente, utilizza il flag --format=prettyjson. Ad esempio: bq --format=prettyjson show -j <job id>. Per visualizzare i log dettagliati per lo strumento bq, utilizza --apilog=stdout. Per scoprire di più sulla risoluzione dei problemi relativi allo strumento bq, consulta Debug.

Esempio di risposta di errore

GET https://bigquery.googleapis.com/bigquery/v2/projects/12345/datasets/foo
Response:
[404]
{
  "error": {
  "errors": [
  {
    "domain": "global",
    "reason": "notFound",
    "message": "Not Found: Dataset myproject:foo"
  }],
  "code": 404,
  "message": "Not Found: Dataset myproject:foo"
  }
}

Errori di autenticazione

Gli errori generati dal sistema di generazione dei token OAuth restituiscono il seguente oggetto JSON, come definito dalla specifica OAuth2.

{"error" : "description_string"}

L'errore è accompagnato da un errore HTTP 400 Bad Request o da un errore HTTP 401 Unauthorized. description_string è uno dei codici di errore definiti dalla specifica OAuth2. Ad esempio:

{"error":"invalid_client"}

Errori di revisione

Puoi utilizzare l'esploratore dei log per visualizzare gli errori di autenticazione per job, utenti o altri ambiti specifici. Di seguito sono riportati diversi esempi di filtri di Explorer dei log che puoi utilizzare per esaminare gli errori di autenticazione.

Cerca i job non riusciti con problemi di autorizzazione negli audit log di criteri negati:

    resource.type="bigquery_resource"
    protoPayload.status.message=~"Access Denied"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access"
  

Cerca un account utente o di servizio specifico utilizzato per l'autenticazione:

    resource.type="bigquery_resource"
    protoPayload.authenticationInfo.principalEmail="EMAIL"
  

Sostituisci EMAIL con l'indirizzo email dell'utente o dell'account di servizio.

Cerca le modifiche ai criteri IAM nei log di controllo delle attività di amministrazione:

    protoPayload.methodName=~"SetIamPolicy"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity"
  

Cerca le modifiche a un set di dati BigQuery specifico negli audit log per l'accesso ai dati:

    resource.type="bigquery_resource"
    protoPayload.resourceName="projects/PROJECT_ID/datasets/DATASET_ID"
    logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
  

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto contenente la risorsa
• DATASET_ID: l'ID del set di dati contenente la risorsa

Messaggi di errore relativi alla connettività

La tabella seguente elenca i messaggi di errore che potresti visualizzare a causa di problemi di connettività intermittenti quando utilizzi le librerie client o chiami l'API BigQuery dal tuo codice:

Messaggi di errore della console Google Cloud

La tabella seguente elenca i messaggi di errore che potresti visualizzare mentre lavori nella console Google Cloud.