Kategorien:

Geodatenfunktionen, Konvertierungsfunktionen

ST_GEOMETRYFROMWKB

Analysiert eine Eingabe im WKB (Well-Known Binary)- oder EWKB (Extended Well-Known Binary) -Format und gibt einen Wert vom Typ GEOMETRY zurück.

Aliasse:

ST_GEOMFROMWKB , ST_GEOMETRYFROMEWKB , ST_GEOMFROMEWKB

Siehe auch:

TO_GEOMETRY

Syntax

ST_GEOMETRYFROMWKB( <varchar_or_binary_expression> [ , <srid> ]  [ , <allow_invalid> ] )

ST_GEOMFROMWKB( <varchar_or_binary_expression> [ , <srid> ]  [ , <allow_invalid> ] )

ST_GEOMETRYFROMEWKB( <varchar_or_binary_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMEWKB( <varchar_or_binary_expression> [ , <srid> ] [ , <allow_invalid> ] )
Copy

Argumente

Erforderlich:

varchar_or_binary_expression

Das Argument muss eine Zeichenfolge oder ein binärer Ausdruck in WKB oder EWKB sein, der ein gültiges Geodatenobjekt darstellt.

Ein Zeichenfolgenausdruck muss im Hexadezimalformat vorliegen (ohne ein führendes 0x).

Optional:

srid

Der Ganzahlwert der zu verwendenden SRID.

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 Festlegen der Verarbeitung von ungültigen Geodaten.

Rückgabewerte

Gibt einen Wert vom Typ GEOMETRY zurück.

Nutzungshinweise

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

  • Wenn bei einer WKB-Eingabe das srid-Argument nicht angegeben ist, wird die SRID des resultierenden GEOMETRY-Objekts auf 0 gesetzt.

Beispiele

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

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

SELECT ST_GEOMETRYFROMEWKB('0101000020797F000066666666A9CB17411F85EBC19E325641');
Copy
+---------------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKB('0101000020797F000066666666A9CB17411F85EBC19E325641') |
|---------------------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                                    |
+---------------------------------------------------------------------------+
Copy

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

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

SELECT ST_GEOMETRYFROMEWKB('010100000066666666A9CB17411F85EBC19E325641');
Copy
+-------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKB('010100000066666666A9CB17411F85EBC19E325641') |
|-------------------------------------------------------------------|
| SRID=0;POINT(389866.35 5819003.03)                                |
+-------------------------------------------------------------------+
Copy
Sprache: Deutsch