st_exteriorring 函数

适用于： Databricks Runtime 17.2 及更高版本

返回输入多边形的外部环作为线字符串。

Syntax

st_exteriorring ( geoExpr )

Arguments

• geoExpr：GEOGRAPHY或GEOMETRY值。

退货

与 . 类型相同的 geoExpr值。 如果输入为空多边形，该函数将返回空行字符串。 否则，该函数将多边形的外部环作为一个（封闭）线字符串返回。 输出值的 SRID 等于输入值的 SRID。

注释

如果输入为 NULL.，则函数返回 NULL 。

错误条件

• 如果 geoExpr 不是多边形，函数将返回 ST_INVALID_ARGUMENT_TYPE。

例子

-- Example taking an empty 2D polygon GEOMETRY.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON EMPTY')));
  LINESTRING EMPTY
-- Example taking an empty 2D polygon GEOMETRY with one empty ring.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON(EMPTY)')));
  LINESTRING EMPTY
-- Example taking a 2D polygon GEOMETRY with one non-empty ring.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))', 3857)));
  SRID=3857;LINESTRING(0 0,10 0,0 10,0 0)
-- Example taking a 3DZ polygon GEOGRAPHY with two rings.
> SELECT st_asewkt(st_exteriorring(st_geogfromtext('POLYGON Z ((0 0 -1,10 0 -2,0 10 -3,0 0 -1),(1 1 -5,4 1 -6,1 4 -7,1 1 -5))')));
  SRID=4326;LINESTRING Z (0 0 -1,10 0 -2,0 10 -3,0 0 -1)
-- Example taking a NULL input.
> SELECT st_exteriorring(NULL);
  NULL