ST_GEOMETRYFROMWKT¶
WKT(well-known text) または EWKT (拡張well-known text)入力を解析し、型 GEOMETRY の値を返します。
エイリアス:
ST_GEOMFROMWKT , ST_GEOMETRYFROMEWKT , ST_GEOMFROMEWKT , ST_GEOMETRYFROMTEXT , ST_GEOMFROMTEXT
- こちらもご参照ください。
構文¶
ST_GEOMETRYFROMWKT( <varchar_expression> , [ <allow_invalid> ] )
ST_GEOMFROMWKT( <varchar_expression> , [ <allow_invalid> ] )
ST_GEOMETRYFROMEWKT( <varchar_expression> , [ <allow_invalid> ] )
ST_GEOMFROMEWKT( <varchar_expression> , [ <allow_invalid> ] )
ST_GEOMETRYFROMTEXT( <varchar_expression> , [ <allow_invalid> ] )
ST_GEOMFROMTEXT( <varchar_expression> , [ <allow_invalid> ] )
引数¶
varchar_expression
引数は、有効な地理空間オブジェクトを表す WKT または EWKT の文字列式である必要があります。
オプション:
allow_invalid
TRUE の場合、入力形状が無効で修復できない場合でも、関数が GEOGRAPHY または GEOMETRY オブジェクトを返す必要があることを指定します。詳細については、 Specifying How Invalid Geospatial Shapes Are Handled をご参照ください。
使用上の注意¶
入力が WKT または EWKT として解析できない場合は、エラーを発行します。
WKT 入力の場合、結果の GEOMETRY オブジェクトでは SRID が0に設定されます。
GEOMETRY オブジェクトの SRID を変更するには、 GEOMETRY オブジェクトを ST_SETSRID に渡し、設定する SRID を指定します。ST_SETSRID は、指定された SRID を持つ GEOMETRY オブジェクトを返します。
例¶
次の例は、EWKT 形式内で説明された地理空間オブジェクトに対して、GEOMETRY オブジェクトを返します。
-- Set the output format to EWKT ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT'; SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)');+---------------------------------------------------------------+ | ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)') | |---------------------------------------------------------------| | SRID=32633;POINT(389866.35 5819003.03) | +---------------------------------------------------------------+
次の例では、入力は SRID を指定しない WKT 形式です。
-- Set the output format to WKT ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT'; SELECT ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)');+----------------------------------------------------+ | ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)') | |----------------------------------------------------| | SRID=0;POINT(389866.35 5819003.03) | +----------------------------------------------------+