Partilhar via


st_asbinary Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 e superior

Important

Este recurso está no Public Preview.

Observação

Esse recurso não está disponível nos armazéns Databricks SQL Classic. Para saber mais sobre os armazéns SQL do Databricks, consulte Tipos de armazém SQL.

Retorna o valor da entrada GEOGRAPHY ou GEOMETRY no formato WKB usando o "endianness" especificado, se fornecido. Se o endianness não for especificado, o valor retornado será codificado em formato little-endian.

Syntax

st_asbinary ( geoExpr[, endiannessExpr] )

Arguments

  • geoExpr: um valor GEOGRAPHY ou GEOMETRY.
  • endiannessExpr: Um valor opcional STRING , representando a endianidade da saída WKB, 'NDR' para little-endian (padrão) ou 'XDR' para big-endian.

Returns

Um valor do tipo BINARY. O valor retornado é a descrição WKB do valor de entrada GEOGRAPHY ou do GEOMETRY, usando o endianness especificado, se fornecido. Se o endianness não for especificado, o valor retornado será codificado em formato little-endian.

A função retorna NULL se qualquer uma das entradas for 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