

 Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

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

ST\$1Dimension 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\$1Dimension 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
```