# Creación de matrices
<a name="creating-arrays"></a>

Para crear una matriz literal en Athena, utilice la palabra clave `ARRAY` seguida de paréntesis `[ ]` e incluya los elementos de matriz separados por comas.

## Ejemplos
<a name="examples"></a>

Esta consulta crea una matriz con cuatro elementos.

```
SELECT ARRAY [1,2,3,4] AS items
```

Devuelve:

```
+-----------+
| items     |
+-----------+
| [1,2,3,4] |
+-----------+
```

Esta consulta crea dos matrices.

```
SELECT ARRAY[ ARRAY[1,2], ARRAY[3,4] ] AS items
```

Devuelve:

```
+--------------------+
| items              |
+--------------------+
| [[1, 2], [3, 4]]   |
+--------------------+
```

Para crear una matriz a partir de columnas seleccionadas de tipos compatibles, utilice una consulta tal y como se muestra en el ejemplo siguiente:

```
WITH
dataset AS (
  SELECT 1 AS x, 2 AS y, 3 AS z
)
SELECT ARRAY [x,y,z] AS items FROM dataset
```

Esta consulta devuelve:

```
+-----------+
| items     |
+-----------+
| [1,2,3]   |
+-----------+
```

En el siguiente ejemplo, se seleccionan dos matrices y se devuelven como mensaje de bienvenida.

```
WITH
dataset AS (
  SELECT
    ARRAY ['hello', 'amazon', 'athena'] AS words,
    ARRAY ['hi', 'alexa'] AS alexa
)
SELECT ARRAY[words, alexa] AS welcome_msg
FROM dataset
```

Esta consulta devuelve:

```
+----------------------------------------+
| welcome_msg                            |
+----------------------------------------+
| [[hello, amazon, athena], [hi, alexa]] |
+----------------------------------------+
```

Para crear una matriz de pares de clave-valor, utilice el operador `MAP` que toma una matriz de claves seguida de una matriz de valores, tal y como se muestra en ejemplo siguiente:

```
SELECT ARRAY[
   MAP(ARRAY['first', 'last', 'age'],ARRAY['Bob', 'Smith', '40']),
   MAP(ARRAY['first', 'last', 'age'],ARRAY['Jane', 'Doe', '30']),
   MAP(ARRAY['first', 'last', 'age'],ARRAY['Billy', 'Smith', '8'])
] AS people
```

Esta consulta devuelve:

```
+-----------------------------------------------------------------------------------------------------+
| people                                                                                              |
+-----------------------------------------------------------------------------------------------------+
| [{last=Smith, first=Bob, age=40}, {last=Doe, first=Jane, age=30}, {last=Smith, first=Billy, age=8}] |
+-----------------------------------------------------------------------------------------------------+
```