

 Amazon Redshift unterstützt UDFs ab Patch 198 nicht mehr die Erstellung von neuem Python. Das bestehende Python UDFs wird bis zum 30. Juni 2026 weiterhin funktionieren. Weitere Informationen finden Sie im [Blog-Posting](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# ST\$1Force3DZ
<a name="ST_Force3DZ-function"></a>

ST\$1Force3DZ gibt eine 3DZ-Geometrie von der Eingabegeometrie zurück. Bei 2D-Geometrien werden alle `z`-Koordinaten der nicht leeren Punkte in der Ausgabegeometrie auf `0` festgelegt. Bei 3DM-Geometrien wird die Geometrie auf die kartesische xy-Ebene projiziert und alle `z`-Koordinaten der nicht leeren Punkte in der Ausgabegeometrie werden auf `0` festgelegt. Bei 3DZ-Geometrien wird eine Kopie der Eingabegeometrie zurückgegeben. Bei 4D-Geometrien wird die Geometrie auf den kartesischen XYZ-Raum projiziert. Leere Punkte in der Eingabegeometrie bleiben leere Punkte in der Ausgabegeometrie.

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

```
ST_Force3DZ(geom)
```

## Argumente
<a name="ST_Force3DZ-function-arguments"></a>

 *geom*   
Ein Wert vom Datentyp `GEOMETRY` oder ein Ausdruck, der zu einem `GEOMETRY`-Typ ausgewertet wird. 

## Rückgabetyp
<a name="ST_Force3DZ-function-return"></a>

`GEOMETRY`. 

Der SRID-Wert (Spatial Reference System Identifier) der zurückgegebenen Geometrie ist der SRID-Wert der Eingabegeometrie. 

Wenn *geom* null ist, wird null zurückgegeben. 

Wenn *geom* leer ist, wird eine leere Geometrie zurückgegeben. 

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

Die folgende SQL-Anweisung gibt eine 3DZ-Geometrie aus einer 3DM-Geometrie zurück. 

```
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))
```