Partager via


st_asbinary Fonction

S’applique à :check marqué oui Databricks SQL vérifié marqué oui Databricks Runtime 17.1 et versions ultérieures

Important

Cette fonctionnalité est disponible en préversion publique.

Note

Cette fonctionnalité n’est pas disponible sur les entrepôts Databricks SQL Classic. Pour en savoir plus sur les entrepôts SQL Databricks, consultez les types d’entrepôts SQL.

Retourne la valeur d'entrée GEOGRAPHY ou GEOMETRY au format WKB selon l'ordre des octets spécifié, le cas échéant. Si le boutisme (endianness) n’est pas spécifié, la valeur retournée est encodée en little-endian.

Syntax

st_asbinary ( geoExpr[, endiannessExpr] )

Arguments

  • geoExpr: Une valeur GEOGRAPHY ou GEOMETRY.
  • endiannessExpr: valeur facultative STRING , représentant l’endianité du WKB de sortie, 'NDR' pour little-endian (par défaut) ou 'XDR' pour big-endian.

Returns

Valeur de type BINARY. La valeur retournée est la description WKB de la valeur d’entrée GEOGRAPHY ou GEOMETRY, en utilisant le boutisme (endianness) spécifié, le cas échéant. Si le boutisme (endianness) n’est pas spécifié, la valeur retournée est encodée en little-endian.

La fonction retourne NULL si l’une des entrées est 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