Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Funzioni costruttore
<a name="sql-functions-constructor"></a>

Una funzione di costruzione SQL è una funzione utilizzata per creare nuove strutture di dati, come matrici o mappe.

 Prendono alcuni valori di input e restituiscono un nuovo oggetto della struttura dati. Le funzioni di costruzione in genere prendono il nome dal tipo di dati che creano, ad esempio ARRAY o MAP.

Le funzioni di costruzione sono diverse dalle funzioni scalari o dalle funzioni aggregate, che operano su dati esistenti e restituiscono un singolo valore. Le funzioni di costruzione vengono utilizzate per creare nuove strutture di dati che possono quindi essere utilizzate per ulteriori elaborazioni o analisi dei dati.

AWS Clean Rooms supporta le seguenti funzioni di costruzione:

**Topics**
+ [funzione di costruzione MAP](map_function.md)
+ [funzione di costruzione NAMED\$1STRUCT](named-struct_function.md)
+ [funzione di costruzione STRUCT](struct_function.md)

# funzione di costruzione MAP
<a name="map_function"></a>

La funzione di costruzione MAP crea una mappa con le coppie chiave/valore specificate.

Le funzioni di costruzione come MAP sono utili quando è necessario creare nuove strutture di dati a livello di codice all'interno delle query SQL. Consentono di creare strutture di dati complesse che possono essere utilizzate per ulteriori elaborazioni o analisi dei dati. 

## Sintassi
<a name="map_function-syntax"></a>

```
map(key0, value0, key1, value1, ...)
```

## Argomenti
<a name="map_function-arguments"></a>

 *chiave 0*   
Un'espressione di qualsiasi tipo comparabile. Tutte le *key0* devono condividere un tipo meno comune.

 *valore 0*   
Un'espressione di qualsiasi tipo. Tutti i *ValueN* devono condividere un tipo meno comune.

## Valori restituiti
<a name="map_function-returns"></a>

*La funzione MAP restituisce un MAP con tasti digitati come tipo meno comune di *key0* e valori digitati come tipo meno comune di value0.*

## Esempi
<a name="map_function-examples"></a>

L'esempio seguente crea una nuova mappa con due coppie chiave-valore: La chiave è associata al valore. `1.0` `'2'` La chiave `3.0` è associata al valore. `'4'` La mappa risultante viene quindi restituita come output dell'istruzione SQL. 

```
SELECT map(1.0, '2', 3.0, '4');
 {1.0:"2",3.0:"4"}
```

# funzione di costruzione NAMED\$1STRUCT
<a name="named-struct_function"></a>

La funzione di costruzione NAMED\$1STRUCT crea una struttura con i nomi e i valori dei campi specificati.

Le funzioni di costruzione come NAMED\$1STRUCT sono utili quando è necessario creare nuove strutture di dati a livello di codice all'interno delle query SQL. Consentono di creare strutture di dati complesse, come strutture o record, che possono essere utilizzate per ulteriori elaborazioni o analisi dei dati.

## Sintassi
<a name="named-struct_function-syntax"></a>

```
named_struct(name1, val1, name2, val2, ...)
```

## Argomenti
<a name="snamed-truct_function-arguments"></a>

 *nome1*   
Un campo di denominazione letterale STRING 1.

 *val1*   
Un'espressione di qualsiasi tipo che specifica il valore per il campo 1.

## Valori restituiti
<a name="named-struct_function-returns"></a>

*La funzione NAMED\$1STRUCT restituisce una struttura con il campo 1 corrispondente al tipo di val1.* 

## Esempi
<a name="named-struct_function-examples"></a>

L'esempio seguente crea una nuova struttura con tre campi denominati: Al campo `"a"` viene assegnato il valore. `1` Al campo `"b"` viene assegnato il valore `2.` Al campo `"c"` viene assegnato il valore`3`. La struttura risultante viene quindi restituita come output dell'istruzione SQL. 

```
SELECT named_struct("a", 1, "b", 2, "c", 3);
 {"a":1,"b":2,"c":3}
```

# funzione di costruzione STRUCT
<a name="struct_function"></a>

La funzione di costruzione STRUCT crea una struttura con i valori di campo specificati.

Le funzioni di costruzione come STRUCT sono utili quando è necessario creare nuove strutture di dati a livello di codice all'interno delle query SQL. Consentono di creare strutture di dati complesse, come strutture o record, che possono essere utilizzate per ulteriori elaborazioni o analisi dei dati.

## Sintassi
<a name="struct_function-syntax"></a>

```
struct(col1, col2, col3, ...)
```

## Argomenti
<a name="struct_function-arguments"></a>

 *col1*   
Un nome di colonna o qualsiasi espressione valida.

## Valori restituiti
<a name="struct_function-returns"></a>

*La funzione STRUCT restituisce una struttura con *field1* corrispondente al tipo di expr1.*

Se gli argomenti sono denominati riferimenti, i nomi vengono utilizzati per denominare il campo. Altrimenti, i campi sono *denominati colN*, dove N è la posizione del campo nella struttura.

## Esempi
<a name="struct_function-examples"></a>

L'esempio seguente crea una nuova struttura con tre campi: Al primo campo viene assegnato il valore 1. Al secondo campo viene assegnato il valore 2. Al terzo campo viene assegnato il valore 3. Per impostazione predefinita, i campi nella struttura risultante sono `col1` denominati e `col3` in base alla loro posizione nell'elenco degli argomenti. `col2` La struttura risultante viene quindi restituita come output dell'istruzione SQL.

```
SELECT struct(1, 2, 3);
 {"col1":1,"col2":2,"col3":3}
```