Teilen über

st_geomfromtext-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Analysiert die WKT-Beschreibung einer Geometrie und gibt den entsprechenden GEOMETRY Wert zurück. Der SRID-Wert des zurückgegebenen GEOMETRY Werts ist der Wert des sridExpr falls angegeben oder 0 andernfalls.

Syntax

st_geomfromtext ( wktExpr[, sridExpr] )

Arguments

  • wktExpr: Ein STRING Wert, der eine Geometrie im WKT-Format darstellt.
  • sridExpr: Ein optionaler INTEGER Wert, der als SRID des zurückgegebenen GEOMETRY Werts festgelegt ist.

Returns

Ein Wert vom Typ GEOMETRY(srid), bei dem srid der Wert von sridExpr ist, falls sridExpr ein konstanter (faltbarer) Ausdruck ist, oder GEOMETRY(ANY) anderweitig. Wenn sridExpr weggelassen wird, ist der Typ des zurückgegebenen Werts GEOMETRY(0). Der zurückgegebene Wert ist die Geometrie, die der Eingabe-WKT-Beschreibung entspricht.

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Fehlerbedingungen

  • Wenn der Wert wktExpr einer ungültigen WKT-Beschreibung ist, gibt die Funktion WKT_PARSE_ERROR zurück.
  • Wenn der Wert von sridExpr nicht unterstützt wird, gibt die Funktion zurück 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