カテゴリ:

地理空間関数、 変換関数

ST_GEOMETRYFROMWKT

Snowflake logo in black (no text) プレビュー機能 --- オープン

すべてのアカウントで利用可能です。

WKT（well-known text） または EWKT （拡張well-known text）入力を解析し、型 GEOMETRY の値を返します。

エイリアス:

ST_GEOMFROMWKT , ST_GEOMETRYFROMEWKT , ST_GEOMFROMEWKT , ST_GEOMETRYFROMTEXT , ST_GEOMFROMTEXT

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

TO_GEOMETRY

構文

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

引数

varchar_expression

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

オプション:

Snowflake logo in black (no text) プレビュー機能 --- オープン

無効な地理空間形状の処理方法を指定するためのサポートは、すべてのアカウントで使用できるプレビュー機能です。

allow_invalid

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

戻り値

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

使用上の注意

  • 入力が 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)');
Copy
+---------------------------------------------------------------+
| ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)') |
|---------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                        |
+---------------------------------------------------------------+
Copy

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

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

SELECT ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)');
Copy
+----------------------------------------------------+
| ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)')  |
|----------------------------------------------------|
| SRID=0;POINT(389866.35 5819003.03)                 |
+----------------------------------------------------+
Copy
言語: 日本語