适用于:
Databricks SQL
Databricks Runtime 17.2 及更高版本
重要
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型。
返回输入多边形的外部环作为线字符串。
Syntax
st_exteriorring ( geoExpr )
Arguments
-
geoExpr:GEOGRAPHY或GEOMETRY值。
退货
与 . 类型相同的 geoExpr值。 如果输入为空多边形,该函数将返回空行字符串。 否则,该函数将多边形的外部环作为一个(封闭)线字符串返回。 输出值的 SRID 等于输入值的 SRID。
注释
如果输入为 NULL.,则函数返回 NULL 。
错误条件
- 如果
geoExpr不是多边形,函数将返回 ST_INVALID_ARGUMENT。INVALID_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