Compartilhar via


st_asbinary Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Esse recurso está em Visualização Pública.

Observação

Esse recurso não está disponível em databricks SQL Classic warehouses. Para saber mais sobre os sql warehouses do Databricks, consulte os tipos de sql warehouse.

Retorna o valor de entrada GEOGRAPHY ou GEOMETRY no formato WKB usando a endianidade especificada, se fornecida. Se a endianidade não for especificada, o valor retornado será codificado em little-endian.

Syntax

st_asbinary ( geoExpr[, endiannessExpr] )

Arguments

  • geoExpr: Um valor GEOGRAPHY ou GEOMETRY.
  • endiannessExpr: um valor opcionalSTRING, que representa a endianidade do WKB de saída, '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 GEOMETRY, usando a endianidade especificada, se fornecida. Se a endianidade não for especificada, o valor retornado será codificado em little-endian.

A função retornará 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