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
<a name="size"></a>

A função SIZE usa uma matriz, mapa ou string existente como argumento e retorna um único valor representando o tamanho ou o comprimento dessa estrutura de dados. Isso não cria uma nova estrutura de dados. Ele é usado para consultar e analisar as propriedades das estruturas de dados existentes, em vez de criar novas.

Essa função é útil para determinar o número de elementos em uma matriz ou o comprimento de uma string. Isso pode ser particularmente útil ao trabalhar com matrizes e outras estruturas de dados em SQL, pois permite obter informações sobre o tamanho ou a cardinalidade dos dados.

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

```
size(expr)
```

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

 *expr*  
Uma expressão ARRAY, MAP ou STRING.

## Tipo de retorno
<a name="size-return-type"></a>

A função SIZE retorna um INTEIRO.

## Exemplo
<a name="size-example"></a>

Neste exemplo, a função SIZE é aplicada à matriz `['b', 'd', 'c', 'a']` e retorna o valor`4`, que é o número de elementos na matriz. 

```
SELECT size(array('b', 'd', 'c', 'a'));
 4
```

Neste exemplo, a função SIZE é aplicada ao mapa `{'a': 1, 'b': 2}` e retorna o valor`2`, que é o número de pares de valores-chave no mapa. 

```
SELECT size(map('a', 1, 'b', 2));
 2
```

Neste exemplo, a função SIZE é aplicada à string `'hello world'` e retorna o valor`11`, que é o número de caracteres na string. 

```
SELECT size('hello world');
11
```