ST_GeomFromText - Amazon Redshift
SyntaxArgumenteRückgabetypBeispiele

Amazon Redshift unterstützt ab dem 1. November 2025 nicht mehr die Erstellung neuer Python-UDFs. Wenn Sie Python-UDFs verwenden möchten, erstellen Sie die UDFs vor diesem Datum. Bestehende Python-UDFs funktionieren weiterhin wie gewohnt. Weitere Informationen finden Sie im Blog-Posting.

ST_GeomFromText

ST_GeomFromText konstruiert ein Geometrieobjekt aus einer WKT-Darstellung einer Eingangsgeometrie.

ST_GeomFromText akzeptiert 3DZ, 3DM und 4D, wobei der Geometrietyp jeweils das Präfix Z, M oder ZM hat.

Syntax

ST_GeomFromText(wkt_string)
ST_GeomFromText(wkt_string, srid)

Argumente

wkt_string

Ein Wert vom Datentyp VARCHAR, der eine WKT-Darstellung einer Geometrie ist.

Sie können das WKT-Schlüsselwort EMPTY verwenden, um einen leeren Punkt, einen Multipoint mit einem leeren Punkt oder eine Geometriesammlung mit einem leeren Punkt festzulegen. Im folgenden Beispiel wird ein Multipoint mit einem leeren und einem nicht leeren Punkt erstellt. 

ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');
srid

Ein Wert vom Datentyp INTEGER, der eine SRID (Spatial Reference Identifier) ist. Wenn ein SRID-Wert angegeben wird, hat die zurückgegebene Geometrie diesen SRID-Wert. Andernfalls wird der Spatial Reference System Identifier (SRID)-Wert der zurückgegebenen Geometrie auf null (0) festgelegt.

Rückgabetyp

GEOMETRY

Wenn wkt_string oder srid null ist, wird null zurückgegeben.

Wenn srid negativ ist, wird null zurückgegeben.

Wenn wkt_string nicht gültig ist, wird ein Fehler zurückgegeben.

Wenn srid nicht gültig ist, wird ein Fehler zurückgegeben.

Beispiele

Das folgende SQL konstruiert ein Geometrieobjekt aus der WKT-Darstellung und dem SRID-Wert. 

SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);

st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000