Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Función SUBSTRING en Amazon QLDB
<a name="ql-functions.substring"></a>

**importante**  
Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte [Migración de un registro de Amazon QLDB a Amazon Aurora](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) PostgreSQL.

En Amazon QLDB, use la función `SUBSTRING` para devolver una subcadena de una cadena determinada. La subcadena comienza en el índice de inicio especificado y finaliza en el último carácter de la cadena o en la longitud especificada.

## Sintaxis
<a name="ql-functions.substring.syntax"></a>

```
SUBSTRING ( string, start-index [, length ] )
```

## Argumentos
<a name="ql-functions.substring.arguments"></a>

*string*  
El nombre del campo o la expresión del tipo de datos `string` del que se va a extraer una subcadena.

*start-index*  
La posición inicial dentro de la cual se va a iniciar *string* la extracción. Este número puede ser negativo.  
El primer carácter de *string* tiene un índice de 1.

*length*  
(Opcional) El número de caracteres (puntos de código) que se van a extraer de*string*, empezando *start-index* y terminando en (*start-index*\$1*length*) - 1. Es decir, la longitud de la subcadena. Este número no puede ser negativo.  
Si no se proporciona este parámetro, la función continúa hasta el final del*string*.

## Tipo de retorno
<a name="ql-functions.substring.return-type"></a>

`string`

## Ejemplos
<a name="ql-functions.substring.examples"></a>

```
SUBSTRING('123456789', 0)      -- '123456789'
SUBSTRING('123456789', 1)      -- '123456789'
SUBSTRING('123456789', 2)      -- '23456789'
SUBSTRING('123456789', -4)     -- '123456789'
SUBSTRING('123456789', 0, 999) -- '123456789'
SUBSTRING('123456789', 0, 2)   -- '1'
SUBSTRING('123456789', 1, 999) -- '123456789'
SUBSTRING('123456789', 1, 2)   -- '12'
SUBSTRING('1', 1, 0)           -- ''
SUBSTRING('1', 1, 0)           -- ''
SUBSTRING('1', -4, 0)          -- ''
SUBSTRING('1234', 10, 10)      -- ''

-- Runnable statements
SELECT SUBSTRING('123456789', 1) FROM << 0 >>    -- "123456789"
SELECT SUBSTRING('123456789', 1, 2) FROM << 0 >> -- "12"
```

## Funciones relacionadas
<a name="ql-functions.substring.related"></a>
+ [CHAR\$1LENGTH](ql-functions.char_length.md)
+ [LOWER](ql-functions.lower.md)
+ [TRIM](ql-functions.trim.md)
+ [UPPER](ql-functions.upper.md)