

 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\_Force3DZ
<a name="ST_Force3DZ-function"></a>

ST\_Force3DZ renvoie une géométrie 3DZ à partir de la géométrie en entrée. Pour les géométries 2D, les coordonnées `z` des points non vides de la géométrie en sortie sont toutes définies sur `0`. Pour les géométries 3DM, la géométrie est projetée sur le plan XY cartésien, et les coordonnées `z` des points non vides de la géométrie en sortie sont toutes définies sur `0`. Pour les géométries 3DZ, une copie de la géométrie en entrée est renvoyée. Pour les géométries 4D, la géométrie est projetée dans l’espace XYZ cartésien. Les points vides de la géométrie en entrée restent des points vides dans la géométrie en sortie.

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

```
ST_Force3DZ(geom)
```

## Arguments
<a name="ST_Force3DZ-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_Force3DZ-function-return"></a>

`GEOMETRY`. 

La valeur de l’identifiant de système de référence spatiale (SRID) de la géométrie renvoyée est la valeur SRID de la géométrie d’entrée. 

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

Si *geom* est vide, une géométrie vide est renvoyée. 

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

Le code SQL suivant renvoie une géométrie 3DZ à partir d’une géométrie 3DM. 

```
SELECT ST_AsEWKT(ST_Force3DZ(ST_GeomFromText('MULTIPOINT M(0 1 2, EMPTY, 2 3 4, 5 6 7)')));
```

```
st_asewkt
-----------
  MULTIPOINT Z ((0 1 0),EMPTY,(2 3 0),(5 6 0))
```