st_geomfromtext Función

Se aplica a: Databricks SQL Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Analiza la descripción WKT de una geometría y devuelve el valor correspondiente GEOMETRY . El valor SRID del valor devuelto GEOMETRY es el valor de sridExpr si se especifica o 0 de lo contrario.

Syntax

st_geomfromtext ( wktExpr[, sridExpr] )

Arguments

• wktExpr: valor STRING que representa una geometría en formato WKT .
• sridExpr: valor opcional INTEGER que se establece para que sea el SRID del valor devuelto GEOMETRY .

Returns

Valor de tipo GEOMETRY(srid) donde srid es el valor de sridExpr si sridExpr es una expresión constante (plegable) o GEOMETRY(ANY) de lo contrario. Si sridExpr se omite el tipo del valor devuelto es GEOMETRY(0). El valor devuelto es la geometría correspondiente a la descripción WKT de entrada.

La función devuelve NULL si alguna de las entradas es NULL.

Condiciones de error

• Si el valor de wktExpr es una descripción WKT no válida, la función devuelve WKT_PARSE_ERROR.
• Si el valor de sridExpr no es compatible, la función devuelve 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)

Funciones relacionadas

• st_asbinary Función
• st_asewkb Función
• st_asewkt Función
• st_asgeojson Función
• st_astext Función
• st_geogfromgeojson Función
• st_geogfromtext Función
• st_geogfromwkb Función
• st_geogfromwkt Función
• st_geomfromewkb Función
• st_geomfromgeojson Función
• st_geomfromwkb Función
• st_geomfromwkt Función
• to_geography Función
• to_geometry Función
• try_to_geography Función
• try_to_geometry Función