As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Função SUBSTRING no Amazon QLDB
<a name="ql-functions.substring"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `SUBSTRING` para retornar uma substring de uma determinada string. A substring começa no índice de início especificado e termina no último caractere da string ou no comprimento especificado.

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

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

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

*string*  
O nome do campo ou a expressão do tipo de dados `string` do qual extrair uma substring.

*start-index*  
A posição inicial dentro *string* da qual iniciar a extração. Esse número pode ser negativo.  
O primeiro caractere de *string* tem um índice de 1.

*length*  
(Opcional) O número de caracteres (pontos de código) a serem extraídos do*string*, começando em *start-index* e terminando em (*start-index*\$1*length*) - 1. Em outras palavras, o comprimento da substring. Esse número não pode ser negativo.  
Se esse parâmetro não for fornecido, a função prosseguirá até o final do*string*.

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

`string`

## Exemplos
<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"
```

## Funções 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)