Compartilhar via

st_geomfromtext 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 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 que representa uma geometria no formato WKT .
  • 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 WKT 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 wktExprWKT inválida, a função retornará WKT_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.
> 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)
  • Last updated on