Tipi di dati SQL precedenti

Questo documento descrive in dettaglio i tipi di dati supportati dalla sintassi delle query SQL precedente di BigQuery. La sintassi di query preferita per BigQuery è GoogleSQL. Per informazioni sui tipi di dati in GoogleSQL, consulta i tipi di dati di GoogleSQL.

Tipi di dati SQL precedenti

I tuoi dati possono includere i seguenti tipi di dati:

Tipo di dati Valori possibili
STRING Dati di caratteri (UTF-8) di lunghezza variabile.
BYTES Dati binari di lunghezza variabile.
  • I dati BYTES importati devono essere codificati in base64, ad eccezione dei dati BYTES Avro, che BigQuery può leggere e convertire.
  • I dati BYTES letti da una tabella BigQuery sono codificati in base64, a meno che non esporti in formato Avro, nel qual caso si applica il tipo di dato Avro.
INTEGER

Numero intero a 64 bit con segno.

Se utilizzi l'API BigQuery per caricare un numero intero al di fuori dell'intervallo [-253+1, 253-1] (nella maggior parte dei casi, significa maggiore di 9.007.199.254.740.991), in una colonna di numeri interi (INT64), devi passarlo come stringa per evitare la corruzione dei dati. Questo problema è causato da una limitazione delle dimensioni degli interi in JSON/ECMAScript. Per ulteriori informazioni, consulta la sezione Numeri di RFC 7159.

FLOAT Formato a virgola mobile a precisione doppia.
NUMERIC L'SQL precedente ha un supporto limitato per NUMERIC. Per ulteriori informazioni, consulta Numeri esatti in SQL precedente.
BIGNUMERIC L'SQL precedente ha un supporto limitato per BIGNUMERIC. Per ulteriori informazioni, consulta Numeri esatti in SQL precedente.
BOOLEANO
  • Formato CSV: 1 o 0, true o false, t o f, yes o no oppure y o n (tutte le lettere non sono sensibili alle maiuscole).
  • Formato JSON: true o false (non è sensibile alle maiuscole).
RECORD Una raccolta di uno o più altri campi.
TIMESTAMP

Puoi descrivere i tipi di dati TIMESTAMP come timestamp UNIX o date e ora di calendario. BigQuery memorizza internamente i dati TIMESTAMP come timestamp UNIX con una precisione di microsecondi.

Timestamp UNIX

Un numero decimale positivo o negativo. Un numero positivo specifica il numero di secondi dall'epoca (01-01-1970 00:00:00 UTC) e un numero negativo specifica il numero di secondi prima dell'epoca. Vengono conservate fino a 6 cifre decimali (precisione in microsecondi).

Stringhe di data e ora

Una stringa di data e ora nel formato YYYY-MM-DD HH:MM:SS. I parametri UTC e Z sono supportati.

Puoi specificare un offset di fuso orario nelle stringhe di data e ora, ma BigQuery non conserva l'offset dopo aver convertito il valore nel suo formato interno. Se devi conservare i dati originali del fuso orario, archivia l'offset del fuso orario in una colonna separata. Lo zero iniziale è obbligatorio quando specifichi un offset del fuso orario a una cifra.

Le stringhe di data e ora devono essere racchiuse tra virgolette quando si utilizza il formato JSON.

Esempi

Gli esempi riportati di seguito mostrano modi identici per descrivere date specifiche, sia in formato timestamp UNIX che in formato di stringa di data e ora.

Evento Formato del timestamp UNIX Formato della stringa data/ora
Terremoto di lieve entità (M4,2) nei pressi di Oklahoma City 
1408452095.220
1408452095.220000

2014-08-19 07:41:35.220 -05:00
2014-08-19 12:41:35.220 UTC
2014-08-19 12:41:35.220
2014-08-19 12:41:35.220000
2014-08-19T12:41:35.220Z
Neil Armstrong mette piede sulla Luna 
-14182916

1969-07-20 20:18:04
1969-07-20 20:18:04 UTC
1969-07-20T20:18:04
Scadenza per la correzione del bug Y10k 
253402300800
2.53402300800e11

10000-01-01 00:00
DATA L'SQL precedente ha un supporto limitato per DATE. Per ulteriori informazioni, consulta Ora civile in SQL precedente.
TEMPO L'SQL precedente ha un supporto limitato per TIME. Per ulteriori informazioni, consulta Ora civile in SQL precedente.
DATETIME L'SQL precedente ha un supporto limitato per DATETIME. Per ulteriori informazioni, consulta Ora civile in SQL precedente.

Numero esatto in SQL precedente

Puoi leggere i valori NUMERIC o BIGNUMERIC in clausole non modificatrici come SELECT list (with aliases), GROUP BY keys e campi di passaggio nelle funzioni finestra e così via. Tuttavia, qualsiasi calcolo sui valori NUMERIC o BIGNUMERIC, inclusi i confronti, produce risultati non definiti.

Le seguenti funzioni di conversione e conversione sono supportate in SQL precedente:

  • CAST(<numeric> AS STRING)
  • CAST(<bignumeric> AS STRING)
  • CAST(<string> AS NUMERIC)
  • CAST(<string> AS BIGNUMERIC)

Tempo civile in SQL precedente

Puoi leggere i tipi di dati relativi al tempo civile (DATE, TIME e DATETIME) ed elaborarli con operatori non modificatori come SELECT list (with aliases), GROUP BY keys e campi di passaggio nelle funzioni window e così via. Tuttavia, qualsiasi altro calcolo sui valori del tempo civile, inclusi i confronti, produce risultati non definiti.

Le seguenti funzioni di conversione e trasmissione sono supportate in SQL precedente:

  • CAST(<date> AS STRING)
  • CAST(<time> AS STRING)
  • CAST(<datetime> AS STRING)
  • CAST(<string> AS DATE)
  • CAST(<string> AS TIME)
  • CAST(<string> AS DATETIME)

In pratica, SQL precedente interpreta i valori di tempo civile come numeri interi e le operazioni su numeri interi che ritieni essere valori di tempo civile producono risultati imprevisti.

Per calcolare i valori utilizzando i tipi di dati relativi al tempo civile, valuta la possibilità di utilizzare GoogleSQL, che supporta tutte le operazioni SQL sui tipi di dati DATE, DATETIME e TIME.

Passaggi successivi