カテゴリ:

地理空間関数変換関数

ST_GEOMETRYFROMWKB

WKB (well-known binary) または EWKB (拡張well-known binary)入力を解析し、型 GEOMETRY の値を返します。

エイリアス:

ST_GEOMFROMWKB , ST_GEOMETRYFROMEWKB , ST_GEOMFROMEWKB

こちらもご参照ください。

TO_GEOMETRY

構文

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

引数

必須:

varchar_or_binary_expression

引数は、有効な地理空間オブジェクトを表す WKB または EWKB の文字列またはバイナリ式である必要があります。

文字列式は16進数形式である必要があります(先頭に 0x なし)。

オプション:

srid

使用する SRID の整数値。

allow_invalid

TRUE の場合、入力形状が無効で修復できない場合でも、関数が GEOGRAPHY または GEOMETRY オブジェクトを返す必要があることを指定します。詳細については、 無効な地理空間形状の処理方法の指定 をご参照ください。

戻り値

この関数は、 GEOMETRY 型の値を返します。

使用上の注意

  • 入力が WKB または EWKB として解析できない場合は、エラーを発行します。

  • WKB 入力の場合は、 srid 引数が指定されていないと、結果の GEOMETRY オブジェクトの SRID は 0 に設定されます。

次の例は、EWKB 形式内で説明された地理空間オブジェクトに対して、GEOMETRY オブジェクトを返します。

-- 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

次の例では、入力は SRID を指定しない WKB 形式です。

-- 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