Freigeben über


st_asbinary-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt die Eingabe GEOGRAPHY oder GEOMETRY den Wert im WKB-Format mit der angegebenen Endianität zurück, sofern angegeben. Wenn die Endianität nicht angegeben ist, ist der zurückgegebene Wert little-endian codiert.

Syntax

st_asbinary ( geoExpr[, endiannessExpr] )

Arguments

  • geoExpr: Ein GEOGRAPHY- oder GEOMETRY-Wert.
  • endiannessExpr: Ein optionaler STRING Wert, der die Endianität der Ausgabe-WKB darstellt, 'NDR' für Little-Endian (Standard) oder 'XDR' für Big-Endian.

Returns

Ein Wert vom Typ BINARY. Der zurückgegebene Wert ist die WKB-Beschreibung des Eingabe-GEOGRAPHY- oder GEOMETRY-Werts unter Verwendung der angegebenen Endianität, sofern angegeben. Wenn die Endianität nicht angegeben ist, ist der zurückgegebene Wert little-endian codiert.

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Examples

-- Export a 3DZ Cartesian point in WKB format (default endianness).
> SELECT hex(st_asbinary(st_geomfromtext('POINT Z (1 2 100)')));
  01E9030000000000000000F03F00000000000000400000000000005940

-- Export a 3DZ geographic point in big -endianness WKB format.
> SELECT hex(st_asbinary(st_geogfromtext('POINT Z (1 2 100)'), 'XDR'));
  00000003E93FF000000000000040000000000000004059000000000000