Compartilhar via


st_geomfromwkb 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.

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 que é definido como o SRID do valor retornado GEOMETRY .

Returns

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

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

Condições de erro

  • Se o valor for uma descrição wkbExprWKB inválida, a função retornará WKB_PARSE_ERROR.
  • Se o valor de sridExpr não for suportado, 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)