ST_GEOMETRYFROMWKB¶
WKB (well-known binary) または EWKB (拡張well-known binary)入力を解析し、型 GEOMETRY の値を返します。
エイリアス:
ST_GEOMFROMWKB , ST_GEOMETRYFROMEWKB , ST_GEOMFROMEWKB
- こちらもご参照ください。
構文¶
ST_GEOMETRYFROMWKB( <varchar_or_binary_expression> , [ <allow_invalid> ] )
ST_GEOMFROMWKB( <varchar_or_binary_expression> , [ <allow_invalid> ] )
ST_GEOMETRYFROMEWKB( <varchar_or_binary_expression> , [ <allow_invalid> ] )
ST_GEOMFROMEWKB( <varchar_or_binary_expression> , [ <allow_invalid> ] )
引数¶
varchar_or_binary_expression
引数は、有効な地理空間オブジェクトを表す WKB または EWKB の文字列またはバイナリ式である必要があります。
文字列式は16進数形式である必要があります(先頭に
0x
なし)。
オプション:
allow_invalid
TRUE の場合、入力形状が無効で修復できない場合でも、関数が GEOGRAPHY または GEOMETRY オブジェクトを返す必要があることを指定します。詳細については、 Specifying How Invalid Geospatial Shapes Are Handled をご参照ください。
使用上の注意¶
入力が 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) | +-------------------------------------------------------------------+