Tipi di dati buffer di protocollo e Arrow supportati

L'API BigQuery Storage Write (gRPC) mappa ogni tipo di dati delle colonne BigQuery a tipi di input e formati di codifica specifici di buffer di protocollo e Apache Arrow. Le tabelle di riferimento in questo documento elencano le mappature dei tipi, gli intervalli di valori e i parametri di conversione supportati. Per i concetti di base dell'API, consulta Panoramica dell'API BigQuery Storage Write (gRPC).

Tipi di dati dei buffer di protocollo supportati

La tabella seguente mostra i tipi di dati supportati nei buffer di protocollo e il formato di input corrispondente in BigQuery:

Tipo di dati BigQuery	Tipi di buffer di protocollo supportati
BOOL	bool, int32, int64, uint32, uint64, google.protobuf.BoolValue
BYTES	bytes, string, google.protobuf.BytesValue
DATE	int32 (preferito), int64, string Il valore è il numero di giorni trascorsi dall'epoca di Unix (1970-01-01). L'intervallo valido è compreso tra -719162 (0001-01-01) e 2932896 (9999-12-31).
DATETIME, TIME	string Il valore deve essere un valore letterale DATETIME o TIME.
	int64 Utilizza la classe CivilTimeEncoder per eseguire la conversione.
FLOAT	double, float, google.protobuf.DoubleValue, google.protobuf.FloatValue
GEOGRAPHY	string Il valore è una geometria in formato WKT o GeoJSON.
INTEGER	int32, int64, uint32, enum, google.protobuf.Int32Value, google.protobuf.Int64Value, google.protobuf.UInt32Value
JSON	string
NUMERIC, BIGNUMERIC	int32, int64, uint32, uint64, double, float, string
	bytes, google.protobuf.BytesValue Utilizza la classe BigDecimalByteStringEncoder per eseguire la conversione.
STRING	string, enum, google.protobuf.StringValue
TIME	string Il valore deve essere un valore letterale TIME.
TIMESTAMP	int64 (preferito), int32, uint32, google.protobuf.Timestamp Il valore è espresso in microsecondi dall'epoca di Unix (1970-01-01).
INTERVAL	string, google.protobuf.Duration Il valore della stringa deve essere un valore letterale INTERVAL.
RANGE<T>	message Un tipo di messaggio nidificato nel proto con due campi, start e end, in cui entrambi i campi devono essere dello stesso tipo di buffer di protocollo supportato che corrisponde a un tipo di dati BigQuery T. T deve essere DATE, DATETIME o TIMESTAMP. Se un campo (start o end) non è impostato nel messaggio proto, rappresenta un confine illimitato. Nell'esempio seguente, f_range_date rappresenta una colonna RANGE in una tabella. Poiché il campo end non è impostato nel messaggio proto, il limite finale di questo intervallo non è limitato. { f_range_date: { start: 1 } }
REPEATED FIELD	array Un tipo di array nel proto corrisponde a un campo ripetuto in BigQuery.
RECORD	message Un tipo di messaggio nidificato nel proto corrisponde a un campo di record in BigQuery.

Tipi di dati Apache Arrow supportati

La tabella seguente mostra i tipi di dati supportati in Apache Arrow e il formato di input corrispondente in BigQuery.

Tipo di dati BigQuery	Tipi di Apache Arrow supportati	Parametri di tipo supportati
BOOL	Boolean
BYTES	Binary
DATE	Date	unit = Day
	String, int32
DATETIME	Timestamp	unit = MICROSECONDS il fuso orario è vuoto
FLOAT	FloatingPoint	Precisione in {SINGLE, DOUBLE}
GEOGRAPHY	Utf8 Il valore è una geometria in formato WKT o GeoJSON.
INTEGER	int	bitWidth in {8, 16, 32, 64} is_signed = false
JSON	Utf8
NUMERIC	Decimal128	Puoi fornire un valore NUMERIC con qualsiasi precisione o scala inferiore all' intervallo supportato da BigQuery.
BIGNUMERIC	Decimal256	Puoi fornire un valore BIGNUMERIC con qualsiasi precisione o scala inferiore all' intervallo supportato da BigQuery.
STRING	Utf8
TIMESTAMP	Timestamp	unit= MICROSECONDS timezone = UTC
INTERVAL	Interval	unità in {YEAR_MONTH, DAY_TIME, MONTH_DAY_NANO}
	Utf8
RANGE<T>	Struct Lo struct Arrow deve avere due sottocampi denominati start e end. Per la colonna RANGE<DATE>, i campi devono essere di tipo Arrow Date con unit=Day. Per la colonna RANGE<DATETIME>, i campi devono essere di tipo Arrow Timestamp con unit=MICROSECONDS, senza il fuso orario. Per RANGE<TIMESTAMP>, i campi devono essere di tipo Arrow Timestamp con unit=MICROSECONDS, timezone=UTC. Un valore NULL in uno dei campi start e end verrà trattato come UNBOUNDED.
REPEATED FIELD	List	Un valore NULL deve essere rappresentato da un elenco vuoto.
RECORD	Struct