Unterstützte Protokollzwischenspeicher- und Arrow-Datentypen

In diesem Dokument werden die unterstützten Protokollzwischenspeicher- und Arrow-Datentypen für jeden BigQuery-Datentyp beschrieben. Bevor Sie dieses Dokument lesen, sollten Sie die Übersicht über die BigQuery Storage Write API lesen.

Unterstützte Protokollzwischenspeicher-Datentypen

In der folgenden Tabelle sind die unterstützten Datentypen in Protokollzwischenspeichern und das entsprechende Eingabeformat in BigQuery aufgeführt:

BigQuery-Datentyp	Unterstützte Protokollzwischenspeichertypen
BOOL	bool, int32, int64, uint32, uint64, google.protobuf.BoolValue
BYTES	bytes, string, google.protobuf.BytesValue
DATE	int32 (bevorzugt), int64, string Der Wert ist die Anzahl der Tage seit der Unix-Epoche (1970-01-01). Der Gültigkeitsbereich liegt zwischen -719162 (0001-01-01) und 2932896 (9999-12-31).
DATETIME, TIME	string Der Wert muss ein DATETIME- oder TIME-Literal sein.
	int64 Verwenden Sie die CivilTimeEncoder-Klasse, um die Konvertierung durchzuführen.
FLOAT	double, float, google.protobuf.DoubleValue, google.protobuf.FloatValue
GEOGRAPHY	string Der Wert ist eine Geometrie im WKT- oder GeoJson-Format.
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 Verwenden Sie die Klasse BigDecimalByteStringEncoder, um die Konvertierung durchzuführen.
STRING	string, enum, google.protobuf.StringValue
TIME	string Der Wert muss ein TIME-Literal sein.
TIMESTAMP	int64 (bevorzugt), int32, uint32, google.protobuf.Timestamp Der Wert wird in Mikrosekunden seit der Unix-Epoche (1970-01-01) angegeben.
INTERVAL	string, google.protobuf.Duration Der Stringwert muss ein INTERVAL-Literal sein.
RANGE<T>	message Ein verschachtelter Nachrichtentyp in der Proto-Datei mit den zwei Feldern start und end, wobei beide Felder denselben unterstützten Protokollzwischenspeicher haben müssen, der dem BigQuery-Datentyp T entspricht. T muss DATE, DATETIME oder TIMESTAMP sein. Wenn ein Feld (start oder end) in der Protokollnachricht nicht festgelegt ist, stellt es eine unbegrenzte Grenze dar. Im folgenden Beispiel steht f_range_date für eine RANGE-Spalte in einer Tabelle. Da das Feld end in der Proto-Nachricht nicht festgelegt ist, ist die Endgrenze dieses Bereichs unbegrenzt. { f_range_date: { start: 1 } }
REPEATED FIELD	array Ein Arraytyp in der Proto-Datei entspricht einem wiederkehrenden Feld in BigQuery.
RECORD	message Ein verschachtelter Nachrichtentyp in der Proto-Datei entspricht einem Datensatzfeld in BigQuery.

Unterstützte Apache Arrow-Datentypen

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen sind „wie gesehen“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Hinweis: Wenn Sie Support benötigen oder Feedback zu dieser Funktion in der Vorabversion geben möchten, wenden Sie sich an [e-mail].

Die folgende Tabelle zeigt die unterstützten Datentypen in Apache Arrow und das entsprechende Eingabeformat in BigQuery.

BigQuery-Datentyp	Unterstützte Apache Arrow-Typen	Unterstützte Typparameter
BOOL	Boolean
BYTES	Binary
DATE	Date	Einheit = Tag
	String, int32
DATETIME	Timestamp	unit = MICROSECONDS Zeitzone ist leer
FLOAT	FloatingPoint	Precision in {SINGLE, DOUBLE}
GEOGRAPHY	Utf8 Der Wert ist eine Geometrie im WKT- oder GeoJson-Format.
INTEGER	int	bitWidth in {8, 16, 32, 64} is_signed = false
JSON	Utf8
NUMERIC	Decimal128	Sie können einen NUMERIC-Wert mit einer beliebigen Genauigkeit oder Skalierung angeben, die kleiner als der von BigQuery unterstützte Bereich ist.
BIGNUMERIC	Decimal256	Sie können einen BIGNUMERIC-Wert mit einer beliebigen Genauigkeit oder Skalierung angeben, die kleiner als der von BigQuery unterstützte Bereich ist.
STRING	Utf8
TIMESTAMP	Timestamp	unit= MICROSECONDS timezone = UTC
INTERVAL	Interval	Einheit in {YEAR_MONTH, DAY_TIME, MONTH_DAY_NANO}
	Utf8
RANGE<T>	Struct Die Arrow-Struktur muss zwei Unterfelder mit den Namen start und end haben. Für die Spalte RANGE<DATE> müssen die Felder vom Typ „Pfeil“ Date mit unit=Day sein. Für die Spalte RANGE<DATETIME> müssen die Felder den Pfeiltyp Timestamp mit unit=MICROSECONDS ohne Zeitzone enthalten. Für RANGE<TIMESTAMP> müssen die Felder den Pfeiltyp Timestamp mit unit=MICROSECONDS, timezone=UTC haben. Ein NULL-Wert in einem der Felder start und end wird als UNBOUNDED behandelt.
REPEATED FIELD	List	Ein NULL-Wert muss durch eine leere Liste dargestellt werden.
RECORD	Struct