

 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\$1Covers
<a name="ST_Covers-function"></a>

ST\$1Covers 會在第一個輸入幾何的 2D 投影涵蓋第二個輸入幾何的 2D 投影時傳回 true。如果兩個幾何皆非空白，且 `B` 中的每個點都是 `A` 中的點，則幾何 `A` 涵蓋幾何 `B`。

ST\$1Covers(`A`, `B`) 與 ST\$1CoveredBy(`B`, `A`) 相等。

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

```
ST_Covers(geom1, geom2)
```

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

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

 *geom2*   
`GEOMETRY` 資料類型的值，或是評估為 `GEOMETRY` 類型的表達式。這個值會和 *geom1* 比較，以判斷其是否涵蓋 *geom1*。

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

`BOOLEAN`

如果 *geom1* 或 *geom2* 為 Null，則會傳回 Null。

如果 *geom1* 和 *geom2* 的空間參考系統識別碼 (SRID) 不同，則會傳回錯誤。

如果 *geom1* 或 *geom2* 是幾何集合，則會傳回錯誤。

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

以下 SQL 會檢查第一個多邊形是否涵蓋第二個多邊形。

```
SELECT ST_Covers(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));
```

```
st_covers
-----------
 false
```