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

-- When invoking st_geomfromtext with a literal for the SRID value, the output geometry type inherits the SRID value.
> SELECT typeof(st_geomfromtext('POINT Z (1 2 3)', 4269));
  geometry(4269)
  • Last updated on