Kategorien:

Geodatenfunktionen, Konvertierungsfunktionen

ST_GEOMETRYFROMWKT

Analysiert eine Eingabe im WKT (Well-Known Text)- oder EWKT (Extended Well-Known Text) -Format und gibt einen Wert vom Typ GEOMETRY zurück.

Aliasse:

ST_GEOMFROMWKT , ST_GEOMETRYFROMEWKT , ST_GEOMFROMEWKT , ST_GEOMETRYFROMTEXT , ST_GEOMFROMTEXT

Siehe auch:

TO_GEOMETRY

Syntax

ST_GEOMETRYFROMWKT( <varchar_expression> , [ <allow_invalid> ] )

ST_GEOMFROMWKT( <varchar_expression> , [ <allow_invalid> ] )

ST_GEOMETRYFROMEWKT( <varchar_expression> , [ <allow_invalid> ] )

ST_GEOMFROMEWKT( <varchar_expression> , [ <allow_invalid> ] )

ST_GEOMETRYFROMTEXT( <varchar_expression> , [ <allow_invalid> ] )

ST_GEOMFROMTEXT( <varchar_expression> , [ <allow_invalid> ] )
Copy

Argumente

varchar_expression

Das Argument muss ein Zeichenfolgenausdruck in WKT oder EWKT sein, der ein gültiges Geodatenobjekt darstellt.

Optional:

allow_invalid

TRUE gibt an, dass die Funktion ein GEOGRAPHY- oder GEOMETRY-Objekt zurückgeben soll, selbst wenn die Form des Eingabeobjekts ungültig ist und nicht repariert werden kann. Weitere Informationen dazu finden Sie unter Specifying How Invalid Geospatial Shapes Are Handled.

Rückgabewerte

Gibt einen Wert vom Typ GEOMETRY zurück.

Nutzungshinweise

  • Gibt eine Fehlermeldung aus, wenn die Eingabe nicht als WKT oder EWKT analysiert werden kann.

  • Bei einer WKT-Eingabe wird die SRID des resultierenden GEOMETRY-Objekts auf 0 gesetzt.

    Um die SRID eines GEOMETRY-Objekts zu ändern, übergeben Sie das GEOMETRY-Objekt an ST_SETSRID unter Angabe der SRID, die Sie festlegen möchten. ST_SETSRID gibt das GEOMETRY-Objekt zurück, das die angegebene SRID hat.

Beispiele

Das folgende Beispiel gibt das Objekt GEOMETRY für einen Geodatenobjekt im EWKT-Format zurück:

-- Set the output format to EWKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)');
Copy
+---------------------------------------------------------------+
| ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)') |
|---------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                        |
+---------------------------------------------------------------+
Copy

Im nächsten Beispiel erfolgt die Eingabe im WKT-Format, bei dem die SRID nicht angegeben wird:

-- Set the output format to WKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)');
Copy
+----------------------------------------------------+
| ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)')  |
|----------------------------------------------------|
| SRID=0;POINT(389866.35 5819003.03)                 |
+----------------------------------------------------+
Copy