適用於:
Databricks SQL
Databricks 執行環境 17.3 及以上版本 勾
Lakehouse//RT
Note
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲,請參閱 SQL 倉儲類型。
傳回輸入多邊形的第 n 個內部環作為線串。
語法
st_interiorringn ( geoExpr, indexExpr )
Arguments
-
geoExpr: AGEOGRAPHY或GEOMETRY值。 -
indexExpr:INTEGER代表多邊形中內環以 1 為基礎的位置的值。
退貨
從 1 開始的索引 indexExpr 處多邊形的內環作為封閉線串。 輸出值具有與 相同的 geoExpr資料類型和 SRID。
註釋
如果輸入為 NULL,則函式會傳NULL回 。
錯誤條件
- 如果不是多邊形,則
geoExpr函數會傳回 ST_INVALID_ARGUMENT。INVALID_TYPE。 - 若
indexExpr無效(小於 1 或大於 ),ST_NumInteriorRings(geoExpr)則函數返回 ST_INVALID_ARGUMENT。INVALID_INDEX_VALUE。
範例
-- Example taking a 2D polygon GEOMETRY with three interior rings.
> SELECT ST_AsEWKT(ST_InteriorRingN(ST_GeomFromText('POLYGON((0 1,10 5,4 20,0 1),(3 12,9 7,5 13,3 12),(1 4,7 5,6 8,1 4),(3 6,4 11,2 10,3 6))', 3857), 3));
SRID=3857;LINESTRING(3 6,4 11,2 10,3 6)
-- Example taking a 3DM polygon GEOGRAPHY with two interior rings.
> SELECT ST_AsEWKT(ST_InteriorRingN(ST_GeogFromText('POLYGON M ((0 1 111,10 5 222,4 20 333,0 1 444),(3 12 111,9 7 222,5 13 333,3 12 444),(1 4 111,7 5 222,6 8 333,1 4 444))'), 2));
SRID=4326;LINESTRING M (1 4 111,7 5 222,6 8 333,1 4 444)
-- Example taking a 4D polygon GEOMETRY with one interior ring.
> SELECT ST_AsEWKT(ST_InteriorRingN(ST_GeomFromText('POLYGON ZM ((0 1 111 -11,10 5 222 -22,4 20 333 -33,0 1 444 -44),(3 12 111 -11,9 7 222 -22,5 13 333 -33,3 12 444 -44))'), 1));
LINESTRING ZM (3 12 111 -11,9 7 222 -22,5 13 333 -33,3 12 444 -44)