

 Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の 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\$1Boundary
<a name="ST_Boundary-function"></a>

ST\$1Boundary は、次のように入力ジオメトリの境界を返します。
+ 入力ジオメトリが空の場合 (つまり、ポイントが含まれていない場合)、そのまま返されます。
+ 入力ジオメトリがポイントまたは空ではないマルチポイントの場合、空のジオメトリコレクションが返されます。
+ 入力がライン文字列またはマルチライン文字列の場合、境界上のすべてのポイントを含むマルチポイントが返されます。マルチポイントが空である可能性があります)。
+ 入力が内部リングのないポリゴンである場合、その境界を表す閉じたライン文字列が返されます。
+ 入力が内部リングのあるポリゴンであるか、マルチポリゴンである場合、マルチライン文字列が返されます。マルチライン文字列には、面積ジオメトリ内のすべてのリングのすべての境界が閉じたライン文字列として含まれます。

ポイントの等価性を判断するために、ST\$1Boundary は入力ジオメトリの 2D 射影に対して作用します。入力ジオメトリが空の場合、入力のコピーが同じディメンションで返されます。空でない 3DM および 4D ジオメトリの場合、`m` 座標はドロップされます。3DZ および 4D マルチライン文字列の特殊なケースでは、マルチラインストリングの境界ポイントにおける `z` 座標は、同じ 2D 射影法を使用するライン文字列の境界ポイントにおける、個別の Z 値の平均として計算されます。

## 構文
<a name="ST_Boundary-function-syntax"></a>

```
ST_Boundary(geom)
```

## 引数
<a name="ST_Boundary-function-arguments"></a>

 *geom*   
データ型 `GEOMETRY` の値または `GEOMETRY` 型と評価される式の値。

## 戻り型
<a name="ST_Boundary-function-return"></a>

`GEOMETRY`

*geom* が null の場合、null が返されます。

*geom* が `GEOMETRYCOLLECTION` である場合、エラーが返されます。

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

次の SQL は、入力ポリゴンの境界をマルチライン文字列として返します。

```
SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromText('POLYGON((0 0,10 0,10 10,0 10,0 0),(1 1,1 2,2 1,1 1))')));
```

```
st_asewkt
--------------------
 MULTILINESTRING((0 0,10 0,10 10,0 10,0 0),(1 1,1 2,2 1,1 1))
```