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 SIZE no Amazon QLDB
<a name="ql-functions.size"></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 `SIZE` para retornar o número de elementos em um determinado tipo de dados de contêiner (lista, estrutura ou bolsa).

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

```
SIZE ( container )
```

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

*container*  
O nome do campo ou expressão do contêiner no qual a função opera.

## Tipos de dados
<a name="ql-functions.size.data-types"></a>

Tipos de argumento com suporte:
+ list
+ estrutura
+ bolsa

Tipo de retorno: `int`

Se a entrada para `SIZE` não for um contêiner, a função gerará um erro.

## Exemplos
<a name="ql-functions.size.examples"></a>

```
SIZE(`[]`)                   -- 0
SIZE(`[null]`)               -- 1
SIZE(`[1,2,3]`)              -- 3
SIZE(<<'foo', 'bar'>>)       -- 2
SIZE(`{foo: bar}`)           -- 1 (number of key-value pairs)
SIZE(`[{foo: 1}, {foo: 2}]`) -- 2
SIZE(12)                     -- error

-- Runnable statements
SELECT SIZE(`[]`) FROM << 0 >>      -- 0
SELECT SIZE(`[1,2,3]`) FROM << 0 >> -- 3
```

## Funções relacionadas
<a name="ql-functions.size.related"></a>
+ [AVG](ql-functions.avg.md)
+ [CONTAGEM](ql-functions.count.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SUM](ql-functions.sum.md)