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

Pour une géométrie linéaire, ST\$1Length renvoie la longueur cartésienne d’une projection 2D. Les unités de longueur sont les mêmes que les unités dans lesquelles les coordonnées de la géométrie en entrée sont exprimées. La fonction renvoie zéro (0) pour les points, les multipoints et les géométries surfaciques. Lorsque l’entrée est une collection de géométries, la fonction renvoie la somme des longueurs des géométries de la collection. 

Pour une géographie, ST\$1Length renvoie la longueur géodésique de la projection 2D d’une géographie linéaire d’entrée calculée sur le sphéroïde déterminé par le SRID. L’unité de longueur est exprimée en mètres. La fonction renvoie zéro (0) pour les points, les multipoints et les géographies surfaciques. Lorsque l’entrée est une collection de géométries, la fonction renvoie la somme des longueurs des géographies de la collection.

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

```
ST_Length(geo)
```

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

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

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

`DOUBLE PRECISION`

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

Si la valeur SRID est introuvable, une erreur est renvoyée.

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

Le code SQL suivant renvoie la longueur cartésienne d’une multilinestring. 

```
SELECT ST_Length(ST_GeomFromText('MULTILINESTRING((0 0,10 0,0 10),(10 0,20 0,20 10))'));
```

```
st_length
--------------------------------
  44.142135623731
```

Le code SQL suivant renvoie la longueur d’une linestring dans une géographie. 

```
SELECT ST_Length(ST_GeogFromText('SRID=4326;LINESTRING(5 0,6 0,4 0)'));
```

```
 st_length 
------------------
 333958.472379804
```

Le code SQL suivant renvoie la longueur d’un point dans une géographie. 

```
SELECT ST_Length(ST_GeogFromText('SRID=4326;POINT(4 5)'));
```

```
 st_length 
-----------
 0
```