ST_AsWKB-Methode

geometry-expression.ST_AsWKB([ format])

Name	Typ	Beschreibung
format	VARCHAR(128)	Eine Zeichenfolge, die das WKB-Format für die Konvertierung von geometry-expression in eine binäre Darstellung definiert. Wenn sie nicht festgelegt wird, ist der Standardwert 'WKB'.

LONG BINARY Gibt die WKB-Darstellung von geometry-expression zurück.

Die ST_AsWKB-Methode gibt eine Binärzeichenfolge zurück, die die Geometrie im WKB-Format darstellt. Verschiedene Formate werden unterstützt (mit den dazugehörigen Optionen) und das gewünschte Format wird mit dem optionalen format-Parameter ausgewählt. Wenn der format-Parameter nicht angegeben wird, ist der Standardwert 'WKB'.

Die Formatzeichenfolge definiert ein Ausgabeformat und Parameter für das Format. Die Formatzeichenfolge hat eines der folgenden Formate:

format-name

format-name(parameter1=value1;parameter2=value2;...)

parameter1=value1;parameter2=value2;...

Das erste Format legt den Formatnamen und keine Parameter fest. Alle Formatparameter benutzen ihre Standardwerte. Das zweite Format legt den Formatnamen und eine Liste von Parameterwerten fest. Nicht angegebene Parameter verwenden die Standardwerte. Das letzte Format gibt nur Parameterwerte an, der Formatname verwendet den Standardnamen 'WKB'.

Die folgenden Formatnamen können benutzt werden:

WKB Das Well-Known-Binärformat laut der Definition von SQL/MM und OGC.
EWKB Das erweiterte Well-Known-Binärformat laut der Definition von PostGIS. Dieses Format enthält die SRID der Geometrie und unterscheidet sich vom WKB durch die Darstellung der Z- und M-Werte.

Die folgenden format-Parameter können angegeben werden:

Formatname	Parametername	Standardwert	Zulässige Werte	Beschreibung
WKB	Version	1.2	1.1 Das WKB gemäß der OGC SFS 1.1-Definition. Dieses Format enthält keine Z- und M-Werte. Wenn die Geometrie Z- oder M-Werte enthält, werden sie in der Ausgabe entfernt. 1.2 Das WKB gemäß der OGC SFS 1.2-Definition. Dies passt zu Version 1.1 bei 2D-Daten und erweitert das Format zur Unterstützung von Z- und M-Werten.	Der version-Parameter steuert die Version der benutzten WKB-Spezifikation.

Hinweis

Standardmäßig verwendet ST_AsWKB das Originalformat für eine Geometrie, wenn es verfügbar ist. Andernfalls wird das interne Format verwendet. Weitere Hinweise zu den internen Formaten und Originalformaten finden Sie unter STORAGE FORMAT-Klausel, CREATE SPATIAL REFERENCE SYSTEM-Anweisung.

SQL/MM (ISO/IEC 13249-3: 2006) Erweiterung des Herstellers

Das folgende Beispiel gibt den Wert 0x01b90b0000000000000000f03f000000000000004000000000000008400000000000001040 zurück.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsWKB('endian=little')

Die folgende Anweisung gibt die Ergebnismenge 0x0101000000000000000000f03f0000000000000040 zurück. Die Z- und M-Werte werden ausgeklammert, weil die Version 1.1 der OGC-Spezifikation für WKB keine Unterstützung dafür bietet.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsWKB('WKB(Version=1.1;endian=little)')

Die folgende Anweisung gibt die Ergebnismenge 0x01010000e0e6100000000000000000f03f000000000000004000000000000008400000000000001040 zurück.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsWKB('EWKB(endian=little)')

ST_AsWKB-Methode

Syntax

Parameter

Rückgabe

Bemerkungen

Hinweis

Standards und Kompatibilität

Beispiel