Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# ST\$1NRings
<a name="ST_NRings-function"></a>

ST\$1NRings 會傳回輸入幾何中的環數。

## 語法
<a name="ST_NRings-function-syntax"></a>

```
ST_NRings(geom)
```

## 引數
<a name="ST_NRings-function-arguments"></a>

 *geom*   
`GEOMETRY` 資料類型的值，或是評估為 `GEOMETRY` 類型的表達式。

## 傳回類型
<a name="ST_NRings-function-return"></a>

`INTEGER`

如果 *geom* 為 Null，則會傳回 Null。

傳回的值如下。


| 傳回的值 | 幾何子類型 | 
| --- | --- | 
| 0 | 在 *geom* 是 `POINT`、`LINESTRING`、`MULTIPOINT` 或 `MULTILINESTRING` 子類型時傳回  | 
| 環的數量。 | 在 *geom* 是 `POLYGON` 或 `MULTIPOLYGON` 子類型時傳回 | 
| 所有元件中環的數量 | 在 *geom* 是 `GEOMETRYCOLLECTION` 子類型時傳回 | 

## 範例
<a name="ST_NRings-function-examples"></a>

以下 SQL 會傳回 multipolygon 中環的數量。

```
SELECT ST_NRings(ST_GeomFromText('MULTIPOLYGON(((0 0,10 0,0 10,0 0)),((0 0,-10 0,0 -10,0 0)))'));
```

```
 st_nrings
-------------
 2
```