st_geomfromwkb Função

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

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.

Analisa a descrição WKB de uma geometria e retorna o valor correspondente GEOMETRY . O valor SRID do valor retornado GEOMETRY é o valor do sridExpr se especificado ou 0 caso contrário.

Syntax

st_geomfromwkb ( wkbExpr[, sridExpr] )

Arguments

  • wkbExpr: Um BINARY valor, representando uma geometria no formato WKB .
  • sridExpr: Um valor opcional INTEGER definido como SRID do valor retornado GEOMETRY .

Returns

Um valor do tipo GEOMETRY(srid) onde srid é o valor de sridExpr, se sridExpr é uma expressão constante (dobrável), ou GEOMETRY(ANY) caso contrário. Se sridExpr for omitido, o tipo do valor retornado é GEOMETRY(0). O valor retornado é a geometria correspondente à descrição WKB de entrada.

A função retorna NULL se qualquer uma das entradas for NULL.

Condições de erro

  • Se o valor de for uma descrição wkbExpr inválida, a função retornará WKB_PARSE_ERROR.
  • Se o valor de não for suportado sridExpr , a função retornará ST_INVALID_SRID_VALUE.

Examples

-- Simple example where we do not specify the output SRID. It defaults to 0. Input is in little-endian format.
> SELECT st_asewkt(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740'));
  POINT M (10 34 23)

-- Simple example where we do not specify the output SRID. It defaults to 0. Input is in big-endian format.
> SELECT st_asewkt(st_geomfromwkb(X'00000007D1402400000000000040410000000000004037000000000000'));
  POINT M (10 34 23)

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740', 3857));
  SRID=3857;POINT M (10 34 23)

-- When invoking st_geomfromwkb with a literal for the SRID value, the output geometry type inherits the SRID value.
> SELECT typeof(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740', 4269));
  geometry(4269)
  • Last updated on