

 Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la [publicación del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# ST\$1Dimension
<a name="ST_Dimension-function"></a>

ST\$1Dimension devuelve la dimensión inherente de una geometría de datos de entrada. El *inherent dimension* es el valor dimensional del subtipo que se define en la geometría. 

En el caso de las entradas de geometría 3DM, 3DZ y 4D, ST\$1Dimension devuelve el mismo resultado que para las entradas de geometría 2D.

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

```
ST_Dimension(geom)
```

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

 *geom*   
Un valor de tipo de datos `GEOMETRY` o una expresión que toma el valor de un tipo `GEOMETRY`. 

## Tipo de retorno
<a name="ST_Dimension-function-return"></a>

`INTEGER` representa la dimensión inherente de *geom*. 

Si *geom* es nulo, entonces se devuelve el valor nulo. 

Los valores retornados son los siguientes.


| Valor devuelto | Subtipo de geometría. | 
| --- | --- | 
| 0 | Se devuelve si *geom* es un subtipo de `POINT` o `MULTIPOINT` | 
| 1 | Se devuelve si *geom* es un subtipo de `LINESTRING` o `MULTILINESTRING`. | 
| 2 | Se devuelve si *geom* es un subtipo de `POLYGON` o `MULTIPOLYGON` | 
| 0 | Se devuelve si *geom* es un subtipo de `GEOMETRYCOLLECTION` vacío | 
| La dimensión más grande de los componentes de la colección | Se devuelve si *geom* es un subtipo de `GEOMETRYCOLLECTION` | 

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

El siguiente SQL convierte una representación de texto conocida (WKT) de un LINSESTRING de cuatro puntos en un objeto GEOMETRY y devuelve la dimensión del 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
```