カテゴリ：: 地理空間関数、変換関数

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

ST_GEOMFROMWKB( <varchar_or_binary_expression> )

ST_GEOMETRYFROMEWKB( <varchar_or_binary_expression> )

ST_GEOMFROMEWKB( <varchar_or_binary_expression> )

引数¶

varchar_or_binary_expression

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

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

戻り値¶

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

使用上の注意¶

入力が WKB または EWKB として解析できない場合は、エラーを発行します。
WKB 入力の場合、結果の GEOMETRY オブジェクトでは SRID が0に設定されます。

GEOMETRY オブジェクトの SRID を変更するには、 GEOMETRY オブジェクトを ST_SETSRID に渡し、設定する SRID を指定します。ST_SETSRID は、指定された SRID を持つ GEOMETRY オブジェクトを返します。

例¶

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

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

SELECT ST_GEOMETRYFROMEWKB('0101000020797F000066666666A9CB17411F85EBC19E325641');

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

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

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

SELECT ST_GEOMETRYFROMEWKB('010100000066666666A9CB17411F85EBC19E325641');

+-------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKB('010100000066666666A9CB17411F85EBC19E325641') |
|-------------------------------------------------------------------|
| SRID=0;POINT(389866.35 5819003.03)                                |
+-------------------------------------------------------------------+