TO_GEOMETRY¶

Syntax¶

Verwenden Sie eine der folgenden Optionen:

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

TO_GEOMETRY( <binary_expression> , [ <allow_invalid> ] )

TO_GEOMETRY( <variant_expression> , [ <allow_invalid> ] )

Argumente¶

varchar_expression

Das Argument muss ein Zeichenfolgenausdruck sein, der ein gültiges geometrisches Objekt in einem der folgenden Formate repräsentiert:

• WKT (Well-Known Text)

• WKB (Well-Known Binary) im Hexadezimalformat (ohne führendes 0x)

• EWKT (Extended Well-Known Text)

• EWKB (Extended Well-Known Binary) im Hexadezimalformat (ohne führendes 0x)

• GeoJSON.

binary_expression

Das Argument muss ein Binärausdruck im WKB- oder EWKB-Format sein.

variant_expression

Das Argument muss ein OBJECT im GeoJSON-Format sein.

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 eines der unterstützten Formate (WKT, WKB, EWKT, EWKB, GeoJSON) analysiert werden kann.

• Bei GeoJSON-, WKT- und WKB-Eingaben wird die SRID des resultierenden GEOMETRY-Objekts auf 0 gesetzt. Um die SRID 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 mit der gewünschten SRID zurück.

• Um ein GEOMETRY-Objekt aus der WKT- oder EWKT-Eingabe zu erstellen, können Sie auch ST_GEOMETRYFROMWKT verwenden.

• Um ein GEOMETRY-Objekt aus der WKB- oder EWKB-Eingabe zu erstellen, können Sie auch ST_GEOMETRYFROMWKB verwenden.

Beispiele¶

Das folgende Beispiel zeigt eine einfache Verwendung der Funktion TO_GEOMETRY mit VARCHAR-Daten:

alter session set geometry_output_format='WKT';

select to_geometry('POINT(1820.12 890.56)');

Copy

+--------------------------------------+
| TO_GEOMETRY('POINT(1820.12 890.56)') |
|--------------------------------------|
| POINT(1820.12 890.56)                |
+--------------------------------------+

Copy