Codici di stato ed errore HTTP per l'API BigQuery

Questa pagina descrive i codici di stato HTTP e i messaggi di errore restituiti dall'API BigQuery. Puoi utilizzare questi codici per risolvere i problemi e gli errori delle richieste e verificare il comportamento dell'API.

Per saperne di più sugli errori non relativi alle API, sugli errori di connettività della libreria client e sugli errori della console Cloud de Confiance , consulta Messaggi di errore.

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

Per saperne di più sugli errori di inserimento di flussi di dati, consulta Risolvi i problemi relativi agli inserimenti di flussi di dati.

Formato della risposta di errore

BigQuery utilizza il formato di Error Reporting HTTP standard per la sua API. Le richieste andate a buon fine restituiscono codici di stato HTTP nell'intervallo 2xx. Le richieste non riuscite restituiscono codici di stato negli intervalli 4xx e 5xx. Le richieste che richiedono un reindirizzamento restituiscono codici di stato nell'intervallo 3xx. Le risposte di errore di solito includono un documento JSON nel corpo della risposta, che contiene un oggetto di errore con informazioni sull'errore.

Nelle risposte dell'API BigQuery, un oggetto di errore è in genere uno dei seguenti:

La colonna Motivo nelle tabelle dei codici di stato di questa pagina corrisponde alla proprietà reason in un oggetto ErrorProto. Se utilizzi lo strumento a riga di comando bq per controllare lo stato del job, utilizza il flag --format=prettyjson (ad esempio bq --format=prettyjson show -j <var>JOB_ID</var>) o --apilog=stdout per visualizzare l'oggetto di errore e la relativa proprietà reason.

La tabella seguente descrive gli elementi che possono essere visualizzati nel corpo della risposta di un errore. I campi devono essere utilizzati insieme per identificare il problema. Inoltre, i valori di esempio nella tabella seguente sono a scopo illustrativo e non costituiscono un elenco esaustivo di tutti i valori possibili.

Elemento Descrizione
code Un valore del codice di stato HTTP, senza la descrizione testuale.

I valori di esempio includono: 400 (Richiesta non valida), 403 (Accesso negato) e 404 (Non trovato).
error Un container per le informazioni sull'errore.
errors Un container per i dettagli dell'errore.
errori.domain L'ambito dell'errore. I valori di esempio includono: global e usageLimits.
errori.location L'elemento specifico all'interno di locationType che ha causato l'errore. Ad esempio, se specifichi un valore non valido per un parametro, location sarà il nome del parametro.

I valori di esempio includono: Authorization e project.
errori.locationType La posizione o la parte della richiesta che ha causato l'errore. Utilizzalo con location per individuare l'errore.

I valori di esempio includono header e parameter.
errori.message Descrizione dell'errore.

I valori di esempio includono Invalid argument, Access Denied e Not Found: Dataset myproject:foo.
errori.reason Un identificatore univoco della causa dell'errore.

I valori di esempio includono invalid, accessDenied e notFound.
message Descrizione dell'errore. Uguale a errors.message.

Codici di stato ed errore HTTP

Questa sezione contiene un elenco non esaustivo di codici di stato ed errore HTTP dell'API BigQuery. I codici informativi 1xx e di esito positivo 2xx vengono omessi. Per saperne di più, consulta i codici di stato della risposta in RFC 7231 §6, RFC 7232 §4, RFC 7233 §4, RFC 7235 §3 e RFC 6585.

400 - Richiesta non valida

Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
badRequest 400

Un'istruzione DML tenta di modificare le righe che sono state trasmesse in streaming di recente con l'API tabledata.insertAll legacy e rimangono nel buffer di streaming della tabella. L'errore restituisce: UPDATE or DELETE statement over table project.dataset.table would affect rows in the streaming buffer, which is not supported.

Esegui la migrazione all'API BigQuery Storage Write (gRPC), attendi qualche minuto per lo svuotamento del buffer di flussi di dati o filtra l'istruzione per escludere le righe inserite di recente. Per saperne di più, consulta Istruzioni DML su tabelle con un buffer di flussi.

invalid 400

La richiesta contiene un input non valido diverso da una query non valida, inclusi i seguenti casi:

  • Uno schema non corrispondente (Provided Schema does not match Table table).
  • Una colonna, un file o una routine RECORD che supera il limite di nidificazione di 15 livelli (Schema nested too deeply).
  • Una tabella di destinazione che viene eliminata o scade durante un job (Destination deleted/expired during operation).

Assicurati che gli schemi forniti corrispondano alle colonne e alle modalità esistenti, appiattisci le strutture che superano i 15 livelli di nidificazione (o archiviale come JSON) e imposta i tempi di scadenza della tabella di destinazione in modo che sopravvivano ai job in esecuzione. Per i passaggi relativi ai singoli sottotipi, consulta Risolvi i problemi relativi a input non validi ed errori dello schema.

invalidQuery 400

Una query SQL non supera i controlli di convalida o esecuzione per uno dei seguenti motivi:

  • Sintassi SQL, identificatori o tipi di dati non validi.
  • Opzioni delle funzionalità non soddisfatte o filtri di partizionamento obbligatori.
  • Superamento dei limiti di nidificazione delle visualizzazioni o di output delle partizioni.
  • Un conflitto di transazioni DML simultanee (ad esempio Concurrent conflicting update to details).

Controlla la posizione [line:column] per verificare la presenza di errori di sintassi o di tipo GoogleSQL, soddisfa i filtri OPTIONS o di partizione richiesti o esegui il rollback delle sessioni bloccate e riprova i job DML in conflitto. Per saperne di più, consulta Errori di query non valide ed Errore di transazione interrotta a causa di un aggiornamento simultaneo.

jobBackendError 400

In jobs.query o jobs.getQueryResults, è stato creato un job che poi non è riuscito durante l'esecuzione con un backendError. L'errore restituisce: The job encountered an error during execution. Retrying the job may solve the problem.

Riprova il job con un nuovo jobId utilizzando il backoff esponenziale troncato, assicurandoti che la logica di ripetizione del client gestisca le risposte HTTP 400 oltre ai codici 5xx. Per saperne di più, consulta Risolvi gli errori jobBackendError e jobInternalError.

jobInternalError 400

In jobs.query o jobs.getQueryResults, è stato creato un job che poi non è riuscito durante l'esecuzione con un errore interno. L'errore restituisce: The job encountered an internal error during execution and was unable to complete.

Riprova a eseguire il job con un nuovo jobId utilizzando il backoff esponenziale troncato. Per saperne di più, consulta Risolvi gli errori jobBackendError e jobInternalError.

preconditionFailed 400

Una condizione preliminare della richiesta non è soddisfatta, inclusi i seguenti casi:

  • Un errore di mancata corrispondenza dell'ETag If-Match durante un aggiornamento dei metadati.
  • Una chiave di crittografia CMEK mancante richiesta dalla policy dell'organizzazione.
  • Una funzionalità non supportata nella versione Standard.
  • Una scrittura in un set di dati di failover al di fuori di una prenotazione principale Enterprise Plus.
  • Una query di vista materializzata su una tabella di base CDC con upsert in attesa.

Recupera la risorsa corrente etag prima di riprovare, specifica la chiave Cloud Key Management Service richiesta, esegui il workload in una prenotazione Enterprise o Enterprise Plus oppure attendi qualche minuto per l'applicazione degli upsert CDC in attesa. Per i passaggi relativi ai singoli sottotipi, consulta Precondizione della richiesta non riuscita.

resourceInUse 400

Una richiesta di eliminazione ha come target una risorsa ancora attiva o compilata:

  • Un set di dati che contiene ancora tabelle, viste o routine.
  • Un job ancora in attesa o in esecuzione.

L'errore restituisce: resource_type resource_id is still in use.

Svuota il set di dati prima di eliminarlo (o imposta deleteContents=true, esegui bq rm -r -f -d o esegui DROP SCHEMA IF EXISTS dataset_name CASCADE) oppure attendi il completamento di un job attivo o annullalo prima di eliminare i metadati del job. Per saperne di più, consulta La risorsa è ancora in uso.

resourcesExceeded 400

Un job supera i limiti delle risorse di esecuzione in una delle seguenti aree:

  • Code di concorrenza DML per tabella o limiti di concorrenza delle sessioni.
  • Budget di memoria per worker, UDF, shuffle o modelli ML.
  • Limiti di partizione della tabella (10.000 partizioni) o delle colonne di output.
  • Tassi di richieste CMEK di Cloud Key Management Service, letture in modalità flusso o trasferimenti di dati tra regioni.
  • Limiti di complessità del piano di query.

L'errore restituisce: Resources exceeded during query execution: details.

Semplifica le query, raggruppa le operazioni DML, riduci le colonne o le partizioni scansionate, evita i job simultanei nella stessa sessione o esegui il provisioning della capacità degli slot dedicati per i workload con un elevato numero di operazioni di shuffle. Per i passaggi relativi a ciascun sottotipo, consulta Risolvi i problemi relativi al superamento delle risorse e La query supera le risorse di memoria.

storageUnusable 400

Lo spazio di archiviazione interno di BigQuery che contiene i dati della tabella non è temporaneamente disponibile a causa di un problema di archiviazione lato servizio. L'errore restituisce: Storage of resource_id is unusable because reason.

Riprova il job utilizzando il backoff esponenziale troncato. Per ulteriori informazioni, consulta Lo spazio di archiviazione della tabella è inutilizzabile.

streamingDataUnavailable 400

I dati trasmessi di recente in un'archiviazione ottimizzata per la scrittura non sono temporaneamente disponibili per un job di lettura. L'errore restituisce: Job failed because streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

Riprova a eseguire il job con un nuovo jobId utilizzando il backoff esponenziale troncato, assicurandoti che la logica di ripetizione del client gestisca le risposte HTTP 400. Per saperne di più, consulta I dati in streaming non sono al momento disponibili.

tableUnavailable 400

BigQuery non può leggere una tabella di cui non gestisce i dati, inclusi i seguenti casi:

  • Il recupero di uno schema di tabella Apache Iceberg o Delta Lake va in timeout.
  • Una tabella esterna partizionata Hive non ha chiavi di partizione.
  • Una tabella di supporto gestita da Google non è temporaneamente disponibile.

Riprova il recupero dello schema o i timeout della tabella di supporto utilizzando il backoff esponenziale troncato oppure verifica i percorsi URI Cloud Storage key=value e ricrea le tabelle esterne partizionate Hive con almeno una chiave di partizione. Per saperne di più, consulta Tabella esterna o di supporto non disponibile.

userOwnedResourceError 400

Una risorsa esterna di tua proprietà restituisce un errore quando vi accede BigQuery. L'errore restituisce: Error when accessing a user-owned external resource_type resource resource_name. The resource provided error: external_error.

Esamina resource_type e resource_name nel messaggio di errore per identificare la risorsa esterna e risolvere l'errore sottostante segnalato in external_error. Per saperne di più, consulta Errore della risorsa esterna di proprietà dell'utente.

vortexDataUnavailable 400

I dati di cui è stato eseguito lo streaming di recente utilizzando l'API BigQuery Storage Write (gRPC) nello spazio di archiviazione ottimizzato per la scrittura non sono temporaneamente disponibili per una query. L'errore restituisce: Job failed because vortex streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

Riprova il job di query con un nuovo jobId utilizzando il backoff esponenziale troncato, assicurandoti che la logica di ripetizione del client gestisca le risposte HTTP 400. Per saperne di più, consulta I dati in streaming non sono al momento disponibili.

billingTierLimitExceeded 400

Una query on demand supera il limite di utilizzo massimo della CPU per i dati scansionati. L'errore restituisce: Query exceeded resource limits. This query used cpu_seconds_used CPU seconds but would charge only analysis_megabytes_billed M Analysis bytes... cpu_seconds_used CPU seconds were used, and this query must use less than cpu_seconds_limit CPU seconds.

Rifattorizza l'SQL per rimuovere prodotti cartesiani indesiderati, join inesatti, funzioni finestra non partizionate o UDF JavaScript pesanti oppure passa ai prezzi basati sulla capacità (slot). Per saperne di più, consulta La query supera le risorse della CPU ed Evita i pattern anti-SQL.

bytesBilledLimitExceeded 400

La stima dei byte del limite superiore prima dell'esecuzione di una query supera maximumBytesBilled prima dell'inizio dell'esecuzione. L'errore restituisce: Query exceeded limit for bytes billed: limit_bytes. required_bytes or higher required.

Visualizza l'anteprima dei byte stimati con un dry run, seleziona solo le colonne necessarie e filtra in base alle colonne partizionate per ridurre il trattamento dei dati oppure aumenta maximumBytesBilled ad almeno required_bytes. Per saperne di più, consulta La query supera il limite massimo di byte fatturati.

jobRateLimitExceeded 400

In jobs.query o jobs.getQueryResults, un job non riesce per uno dei seguenti motivi:

  • Il job supera un limite di frequenza durante l'esecuzione (Job exceeded rate limits: Your scope exceeded quota for quota_metric...).
  • La query non viene ammessa perché è stata raggiunta la concorrenza della coda di query o il limite di slot per le query continue (ad esempio Query was not admitted as the maximum concurrency has been reached...).

Riduci gli invii simultanei (o utilizza la priorità batch o la scalabilità automatica degli slot per le query continue) e riprova il job con un nuovo jobId utilizzando il backoff esponenziale troncato. Per saperne di più, consulta Il job ha superato i limiti di frequenza e Ammissione della query negata.

timeout 400

Un'operazione supera il limite di tempo di esecuzione, inclusi i seguenti casi:

  • Una query o un dry run supera il limite di esecuzione di 6 ore.
  • Un job secondario all'interno di una query con più istruzioni va in timeout.
  • Timeout del rilevamento automatico dello schema della tabella esterna.

Filtra in base alle colonne partizionate o raggruppate in cluster e suddividi le query complesse o con più istruzioni in fasi più piccole oppure specifica uno schema esplicito e URI di origine più ristretti durante la creazione di tabelle esterne. Per ulteriori informazioni, consulta La query supera il limite di tempo di esecuzione e Risolvi gli errori relativi a quote e limiti.

invalidUser 400

Una query pianificata è stata configurata con credenziali utente non valide.

Aggiorna le credenziali utente per la query pianificata. Per saperne di più, consulta Pianificazione delle query.

required 400

Manca un input obbligatorio prima dell'esecuzione:

  • Non è stato fornito un campo obbligatorio nel payload o nell'URL di una richiesta API.
  • Un oggetto di configurazione obbligatorio in una libreria client è vuoto o non assegnato.

L'errore restituisce: Required parameter is missing: parameter_name.

Verifica il corpo della richiesta e parametri di ricerca obbligatori nel riferimento API BigQuery o nella documentazione della libreria client e controlla l'oggetto di configurazione prima di chiamare l'API. Per saperne di più, consulta Parametro obbligatorio mancante.

401 - Unauthorized

Di seguito è riportato un esempio di risposta di errore che ricevi se la tua richiesta non contiene credenziali di autenticazione valide.

401 Unauthorized

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "unauthenticated",
        "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential."
      }
    ],
    "code": 401,
    "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential.",
    "status": "UNAUTHENTICATED"
  }
}
Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
unauthenticated 401

L'autenticazione della richiesta non va a buon fine per uno dei seguenti motivi:

  • La richiesta non dispone di credenziali di autenticazione valide o utilizza un token di accesso OAuth 2.0 scaduto.
  • Mancano le credenziali dell'utente finale o le autorizzazioni di simulazione dell'identità dei account di servizio.
  • L'account utente del chiamante è limitato o eliminato.

Aggiorna le Credenziali predefinite dell'applicazione o OAuth, concedi roles/iam.serviceAccountUser o roles/iam.serviceAccountTokenCreator quando esegui con o impersoni un account di servizio oppure contatta l'amministratore per ripristinare un account con limitazioni. Per saperne di più, consulta Risolvi gli errori di mancata autenticazione.

403 — Forbidden

Questo è un esempio di risposta di errore che ricevi se non hai l'autorizzazione per accedere alla risorsa richiesta.

403 Forbidden

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "accessDenied",
        "message": "Access Denied: Dataset myproject:mydataset: User does not have bigquery.datasets.get permission in project myproject."
      }
    ],
    "code": 403,
    "message": "Access Denied: Dataset myproject:mydataset: User does not have bigquery.datasets.get permission in project myproject."
  }
}
Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
responseTooLarge 403

Una risposta di lettura di una query o di una tabella supera i limiti di dimensioni in uno dei seguenti modi:

L'errore restituisce: Response too large to return. details.

Specifica una tabella di destinazione (e imposta configuration.query.allowLargeResults su true per l'SQL precedente), rimuovi ORDER BY o aggiungi LIMIT oppure leggi righe di grandi dimensioni utilizzando l'API BigQuery Storage Read o EXPORT DATA. Per saperne di più, consulta La risposta alla query è troppo grande e Limite di dimensioni della risposta per una singola riga superato.

apiLimitExceeded 403

Una richiesta supera uno dei seguenti limiti relativi all'API o ai metadati:

  • Limiti di tasso di richieste API al minuto.
  • Quote di valutazione dei metadati di tabelle o policy.
  • Limiti di creazione delle repliche dei set di dati tra regioni (Cannot add more than limit replicas for a region within window day(s)).

L'errore restituisce: API limit exceeded: details.

Riprova le richieste non riuscite con backoff esponenziale troncato, carichi e letture in batch, semplifica le policy di sicurezza IAM granulari per tabella o a livello di riga e attendi la finestra temporale prima di aggiungere repliche del set di dati. Per maggiori informazioni, consulta Errori relativi alla frequenza delle API e al limite di valutazione dei metadati ed Errori relativi al limite di creazione delle repliche dei set di dati tra regioni.

quotaExceeded 403

Il tuo progetto supera una delle seguenti quote di utilizzo:

L'errore restituisce: Quota exceeded: Your scope exceeded quota for quota_metric. For more information, see https://cloud.google.com/bigquery/docs/troubleshoot-quotas.

Esamina l'errore message per identificare la quota superata, ottimizza le query con scansione elevata o esegui l'upgrade dalla sandbox oppure modifica le quote personalizzate nella pagina Quote. Per saperne di più, consulta Errori relativi alla quota di query giornaliere personalizzate.

rateLimitExceeded 403

Una richiesta viene rifiutata per uno dei seguenti limiti di frequenza o contemporaneità:

  • Limiti di frequenza delle richieste API o dei job di query a breve termine (Exceeded rate limits: too many quota_metric for this scope...).
  • Concorrenza della coda di query o limiti degli slot di prenotazione per le query continue (ad esempio, Query was not admitted as the maximum concurrency has been reached...).

Riduci il tasso di richieste e riprova utilizzando il backoff esponenziale troncato oppure esegui query non urgenti con priorità batch e regola la contemporaneità delle prenotazioni o la scalabilità automatica degli slot. Per saperne di più, consulta Risolvi gli errori relativi a quote e limiti e Query admission denied.

accessDenied 403

L'accesso a una risorsa BigQuery viene negato per uno dei seguenti motivi:

  • L'entità non dispone delle autorizzazioni IAM richieste per il progetto, il set di dati o la tabella di destinazione.
  • L'accesso è limitato da una vista autorizzata, da una policy di accesso a livello di riga o da un tag di criteri a livello di colonna.
  • Mancano le autorizzazioni CMEK di Cloud Key Management Service o le autorizzazioni per l'origine dati esterna.

L'errore restituisce: Access Denied: resource_type resource_id: details.

Esamina Cloud Audit Logs (protoPayload.authorizationInfo) e Policy Analyzer per identificare l'autorizzazione mancante e concedi il ruolo BigQuery predefinito con privilegi minimi. Per saperne di più, consulta Risolvi i problemi relativi agli scenari di accesso negato più comuni.

policyViolation 403

Un perimetro di sicurezza o una policy dell'organizzazione blocca la richiesta:

  • Un perimetro dei Controlli di servizio VPC limita l'accesso (incluse le esportazioni di Google Drive o le tabelle esterne nei progetti VPC-SC).
  • Un vincolo della policy dell'organizzazione, ad esempio constraints/gcp.resourceLocations, non consente l'operazione.

Filtra Esplora log in base a vpcServiceControlsUniqueIdentifier e controlla Violation Analyzer, esporta o carica i dati utilizzando un bucket Cloud Storage all'interno del perimetro o seleziona una regione consentita dai vincoli delle policy dell'organizzazione. Per saperne di più, consulta Risolvi gli errori di violazione delle policy.

billingNotEnabled 403

Il progetto non dispone di un account di fatturazione attivo per l'operazione richiesta:

  • La fatturazione non è abilitata per il progetto.
  • Il progetto viene eseguito nella sandbox di BigQuery, dove tabelle, viste e partizioni scadono dopo 60 giorni (expiration time must be less than 60 days).

L'errore restituisce: Billing has not been enabled for this project. Enable billing at https://console.cloud.s3nscloud.fr/billing. details.

Abilita la fatturazione per il progetto nella console Cloud de Confiance per eseguire l'upgrade dalla sandbox di BigQuery, quindi aggiorna le date di scadenza predefinite per tabelle, viste e partizioni. Per saperne di più, consulta La fatturazione non è abilitata per il progetto.

blocked 403

BigQuery ha aggiunto temporaneamente l'operazione tentata a una lista bloccata per evitare un'interruzione del servizio. L'errore restituisce: Request was blocked to protect the system's operation. Please contact support at https://cloud.google.com/support.

Contatta l'assistenza clienti Google Cloud con il timestamp esatto, l'ID progetto e l'ID job BigQuery per esaminare la regola di mitigazione amministrativa. Per saperne di più, consulta La richiesta è stata bloccata per proteggere il funzionamento del sistema.

termsOfServiceNotAccepted 403

Il progetto non ha accettato i Termini di servizio di BigQuery. L'errore restituisce: BigQuery Terms of Service have not been accepted.

Accedi alla consoleCloud de Confiance , seleziona il tuo paese e la casella di controllo dei Termini di servizio nella pagina di benvenuto, se richiesto, quindi fai clic su Accetta e continua. Per saperne di più, consulta Termini di servizio di BigQuery non accettati.

404 - Non trovato

Di seguito è riportato un esempio di risposta di errore che ricevi se provi a recuperare un set di dati o una risorsa che non esiste.

404 Not Found

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "Not Found: Dataset myproject:foo"
      }
    ],
    "code": 404,
    "message": "Not Found: Dataset myproject:foo"
  }
}
Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
notFound 404

Impossibile trovare una risorsa richiesta per uno dei seguenti motivi:

  • Il set di dati, la tabella o il job di destinazione non esiste o è scaduto.
  • Un URI di file Cloud Storage o Google Drive esterno non esiste.
  • La località della richiesta non corrisponde a quella del set di dati o del job.

L'errore restituisce: Not found: resource_type resource_id.

Verifica l'identificatore e la località esatti del progetto, del set di dati e della tabella, sensibili alle maiuscole, ripristina le tabelle eliminate nella finestra di viaggio nel tempo, esegui nuovamente le query le cui tabelle dei risultati memorizzate nella cache sono scadute o verifica l'esistenza di file esterni di Cloud Storage o Google Drive. Per ulteriori informazioni, vedi Tabella non trovata, Località non trovata e Job non trovato.

409 - Conflict

Di seguito è riportato un esempio di risposta di errore che ricevi se provi a creare una risorsa già esistente.

409 Conflict

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "duplicate",
        "message": "Already Exists: Dataset myproject:mydataset"
      }
    ],
    "code": 409,
    "message": "Already Exists: Dataset myproject:mydataset"
  }
}
Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
abortd 409

Un'operazione si interrompe a causa di una modifica o di un conflitto simultaneo (restituito con il motivo abortd).

Riprova l'operazione al termine dell'operazione in conflitto utilizzando il backoff esponenziale troncato oppure esegui il rollback delle transazioni con più istruzioni interrotte prima di riprovare. Per saperne di più, consulta L'operazione è stata interrotta.

duplicate 409

Una richiesta è in conflitto con una risorsa esistente in uno dei seguenti modi:

  • Creazione di una risorsa di set di dati, tabella o job già esistente.
  • Esecuzione di un job con writeDisposition impostato su WRITE_EMPTY quando la tabella di destinazione esiste già.

L'errore restituisce: Already Exists: resource_type resource_id.

Utilizza un nome di risorsa diverso, utilizza IF NOT EXISTS o CREATE OR REPLACE nelle istruzioni DDL, modifica writeDisposition in WRITE_APPEND o WRITE_TRUNCATE oppure consenti a BigQuery di generare un jobId casuale. Per i passaggi per sottotipo, consulta La risorsa esiste già.

499 - Client closed request

Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
stopped 499

Un job si interrompe prima del completamento per uno dei seguenti motivi (il polling di jobs.get restituisce HTTP 200 con reason: stopped):

  • Un chiamante annulla esplicitamente il job (User requested cancellation).
  • Il job supera un timeout di esecuzione o di coda configurato (Job timed out after duration o Job timed out in the queue after duration).

L'errore restituisce: Job execution was cancelled: details.

Aumenta le opzioni di timeout della coda del progetto o di configuration.jobTimeoutMs (oppure ottimizza il runtime e la contemporaneità delle query) o controlla Cloud Audit Logs per le chiamate jobservice.cancel. Per i passaggi relativi ai singoli sottotipi, consulta L'esecuzione del job è stata annullata.

500 - Errore interno del server

Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
internalError 500

Si è verificato un errore interno in BigQuery. L'errore restituisce: An internal error occurred and the request could not be completed.

Attendi in base ai requisiti di backoff indicati nell'accordo sul livello del servizio BigQuery e riprova utilizzando il backoff esponenziale troncato oppure utilizza Prenotazioni per ridurre la frequenza degli errori temporanei. Per saperne di più, consulta Risolvi gli errori internalError.

501 - Non implementata

Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
notImplemented 501

Una richiesta tenta di utilizzare una funzionalità o un'operazione non implementata per la risorsa di destinazione, ad esempio:

  • Copia di una tabella con un tipo di spazio di archiviazione non gestito.
  • Esecuzione di un'opzione ALTER SEARCH INDEX non supportata.

L'errore restituisce: Not Implemented: details.

Materializza le origini di copia delle tabelle non supportate utilizzando CREATE TABLE destination_table AS SELECT * FROM source_table oppure elimina e ricrea gli indici della Ricerca con DROP SEARCH INDEX e CREATE SEARCH INDEX. Per i passaggi relativi ai singoli sottotipi, consulta Funzionalità o operazione non implementata.

503 - Servizio non disponibile

Motivo Codice di stato HTTP Descrizione Risoluzione dei problemi
backendError 503

Il servizio non è al momento disponibile per uno dei seguenti motivi:

  • Un picco di domanda del servizio (perdita di carico) o l'esaurimento delle risorse interne.
  • Problemi di connessione di rete intermittenti.
  • Un problema temporaneo del componente di backend.

L'errore restituisce: Error encountered during execution. Retrying may solve the problem.

Riprova a inviare le richieste utilizzando il backoff esponenziale troncato e riprova a eseguire i job non riusciti con un nuovo jobId. Se gli errori persistono anche dopo i nuovi tentativi, confronta il tasso di errore di 30 giorni con lo SLA di BigQuery e contatta l'assistenza clienti Google Cloud; consulta Risolvi gli errori backendError.