適用於：
Databricks SQL Databricks 執行環境 18.1 及以上版本
Note
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲，請參閱 SQL 倉儲類型。
回傳輸入多邊形或多邊形的環總數，包括外部與內部環。 對於多邊形，回傳所有多邊形環的總和。
語法
st_nrings ( geoExpr )
引數
-
geoExpr:GEOGRAPHY或GEOMETRY值。
退貨
代表 INTEGER 輸入多邊形或多邊形中環的總數值。
Notes
如果輸入為 NULL，則函式會傳NULL回 。
錯誤條件
- 若
geoExpr不是多邊形或多邊形，則函數回傳 ST_INVALID_ARGUMENT。INVALID_TYPE。
Examples
-- Example taking an empty 2D polygon GEOMETRY.
> SELECT st_nrings(st_geomfromtext('POLYGON EMPTY'));
0
-- Example taking a 4D polygon GEOGRAPHY with two rings (one exterior, one interior).
> SELECT st_nrings(st_geogfromtext('POLYGON ZM ((0 0 111 -11,10 0 222 -22,0 10 333 -33,0 0 444 -44),(1 1 555 -55,4 1 666 -66,1 4 777 -77,1 1 888 -88))'));
2
-- Example taking an empty 3DZ multipolygon GEOMETRY.
> SELECT st_nrings(st_geomfromtext('MULTIPOLYGON Z EMPTY', 4326));
0
-- Example taking a multipolygon GEOGRAPHY with four rings across two polygons.
> SELECT st_nrings(st_geogfromtext('MULTIPOLYGON (((0 0,10 0,10 10,0 10,0 0),(1 1,4 1,4 4,1 4,1 1),(5 5,6 5,6 6,5 6,5 5)),((20 20,30 20,30 30,20 30,20 20)))'));
4