Partilhar via


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

Analisa a descrição WKT 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_geomfromtext ( wktExpr[, sridExpr] )

Arguments

  • wktExpr: Um STRING valor, representando uma geometria no formato WKT .
  • 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 WKT 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 wktExpr inválida, a função retornará WKT_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.
> SELECT st_srid(st_geomfromtext('POINT Z (1 2 3)'));
  0

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromtext('POINT Z (1 2 3)', 3857));
  SRID=3857;POINT Z (1 2 3)