ST_GeomFromText - Amazon Redshift
语法参数返回类型示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

ST_GeomFromText

ST_GeomFromText 从输入几何体的已知文本 (WKT) 表示形式构造几何体对象。

ST_GeomFromText 接受 3DZ、3DM 和 4D，其中几何类型分别以 Z、M 或 ZM 作为前缀。

语法

ST_GeomFromText(wkt_string)
ST_GeomFromText(wkt_string, srid)

参数

wkt_string

一个 VARCHAR 数据类型的值，它是几何体的 WKT 表示形式。

您可以使用 WKT 关键字 EMPTY 指定一个空点、一个带有空点的多点或一个带有空点的几何体集合。以下示例创建一个多点，其中包括一个空点和一个非空点。

ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');
srid

一个 INTEGER 数据类型的值，它是空间参考标识符 (SRID)。如果提供了一个 SRID 值，则返回的几何体将具有此 SRID 值。否则，返回的几何体的 SRID 值将设置为零 (0)。

返回类型

GEOMETRY

如果 wkt_string 或 srid 为 null，则返回 null。

如果 srid 为负，则返回 null。

如果 wkt_string 无效，则返回一个错误。

如果 srid 无效，则返回一个错误。

示例

以下 SQL 从 WKT 表示形式和 SRID 值构造几何体对象。

SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);

st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000