ST_GeomFromEWKT - Amazon Redshift
構文引数戻り型例

Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

ST_GeomFromEWKT

ST_GeomFromEWKT は、入力ジオメトリの拡張 well-known text (EWKT) 表現からジオメトリオブジェクトを構築します。

ST_GeomFromEWKT は、3DZ、3DM、および 4D を受け入れます。この場合、各ジオメトリタイプの先頭には Z、M、または ZM がプレフィックスされます。

構文

ST_GeomFromEWKT(ewkt_string)

引数

ewkt_string

データ型 VARCHAR の値、または VARCHAR 型に評価される式、つまりジオメトリの EWKT 表現。

WKT キーワード EMPTY を使用すると、空のポイント、空のポイントを持つマルチポイント、あるいは空のポイントを持つジオメトリコレクションを指定することができます。次の例では、空のポイントを 1 つ作成します。

ST_GeomFromEWKT('SRID=4326;POINT EMPTY');

戻り型

GEOMETRY

ewkt_string が null の場合、null が返されます。

ewkt_string が有効でない場合、エラーが返されます。

例

次の SQL は、EWKT 値からマルチライン文字列を作成し、ジオメトリを返します。また、ジオメトリの ST_AsEWKT 結果を返します。

SELECT ST_GeomFromEWKT('SRID=4326;MULTILINESTRING((1 0,1 0),(2 0,3 0),(4 0,5 0,6 0))') as geom, ST_AsEWKT(geom);

                                                                                                                                                       geom                                                                                                                                                       |                          st_asewkt                           
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------
 0105000020E610000003000000010200000002000000000000000000F03F0000000000000000000000000000F03F00000000000000000102000000020000000000000000000040000000000000000000000000000008400000000000000000010200000003000000000000000000104000000000000000000000000000001440000000000000000000000000000018400000000000000000 | SRID=4326;MULTILINESTRING((1 0,1 0),(2 0,3 0),(4 0,5 0,6 0))