Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les détails de la fin de vie de Python et des options de migration, consultez [ le billet de ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/) blog publié le 30 juin 2025. 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# ST\_Dimension
<a name="ST_Dimension-function"></a>

ST\_Dimension renvoie la dimension inhérente d’une géométrie d’entrée. La *dimension inhérente* est la valeur de la dimension du sous-type défini dans la géométrie. 

Pour les entrées de géométrie 3DM, 3DZ et 4D, ST\_Dimension renvoie le même résultat que pour les entrées de géométrie 2D.

## Syntaxe
<a name="ST_Dimension-function-syntax"></a>

```
ST_Dimension(geom)
```

## Arguments
<a name="ST_Dimension-function-arguments"></a>

 *geom*   
Valeur de type de données `GEOMETRY` ou expression qui est évaluée sur un type `GEOMETRY`. 

## Type de retour
<a name="ST_Dimension-function-return"></a>

`INTEGER` représentant la dimension inhérente de *geom*. 

Si *geom* est null, null est renvoyé. 

Les valeurs renvoyées sont comme suit :


| Valeur renvoyée | Sous-type de géométrie | 
| --- | --- | 
| 0 | Renvoyé si *geom* est un sous-type `POINT` ou `MULTIPOINT`. | 
| 1 | Renvoyé si *geom* est un sous-type `LINESTRING` ou `MULTILINESTRING`. | 
| 2 | Renvoyé si *geom* est un sous-type `POLYGON` ou `MULTIPOLYGON`. | 
| 0 | Renvoyé si *geom* est un sous-type `GEOMETRYCOLLECTION` vide. | 
| Dimension la plus importantes des composants de la collection. | Renvoyé si *geom* est un sous-type `GEOMETRYCOLLECTION` | 

## Exemples
<a name="ST_Dimension-function-examples"></a>

Le SQL suivant convertit une représentation WKT (well-known text) d’une LINESTRING à quatre points en objet GEOMETRY et renvoie la dimension de la linestring. 

```
SELECT ST_Dimension(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
```

```
st_dimension
-------------
1
```