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à.

# Funzione STR\$1TO\$1MAP
<a name="STR_TO_MAP"></a>

La funzione STR\$1TO\$1MAP è una funzione di conversione. string-to-map Converte una rappresentazione in formato stringa di una mappa (o dizionario) in una vera struttura di dati cartografici.

Questa funzione è utile quando è necessario lavorare con strutture di dati cartografiche in SQL, ma i dati vengono inizialmente memorizzati come stringa. Convertendo la rappresentazione della stringa in una mappa effettiva, è quindi possibile eseguire operazioni e manipolazioni sui dati della mappa.

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

```
str_to_map(text[, pairDelim[, keyValueDelim]])
```

## Arguments (Argomenti)
<a name="STR_TO_MAP-arguments"></a>

 *testo*   
Un'espressione STRING che rappresenta la mappa.

 *PairDelim*   
Un valore letterale STRING opzionale che specifica come separare le voci. Il valore predefinito è una virgola (). `','`

 *keyValueDelim*   
Un valore letterale STRING opzionale che specifica come separare ogni coppia chiave-valore. Il valore predefinito è i due punti (). `':'`

## Tipo restituito
<a name="STR_TO_MAP-returns"></a>

La funzione STR\$1TO\$1MAP restituisce una MAP di STRING sia per le chiavi che per i valori. Sia *PairDelim* che vengono trattati come espressioni regolari *keyValueDelim*. 

## Esempio
<a name="STR_TO_MAP-examples"></a>

L'esempio seguente prende la stringa di input e i due argomenti di delimitazione e converte la rappresentazione della stringa in una vera struttura di dati della mappa. In questo esempio specifico, la stringa di input `'a:1,b:2,c:3'` rappresenta una mappa con le seguenti coppie chiave-valore: `'a'` è la chiave e è il valore. `'1'` `'b'`è la chiave ed `'2'` è il valore. `'c'`è la chiave ed `'3'` è il valore. Il `','` delimitatore viene utilizzato per separare le coppie chiave-valore e il `':'` delimitatore viene utilizzato per separare la chiave e il valore all'interno di ciascuna coppia. L'output di questa query è:. `{"a":"1","b":"2","c":"3"}` Questa è la struttura dei dati della mappa risultante, dove le chiavi sono `'a'` `'b'``'c'`, e, e i valori corrispondenti sono `'1'``'2'`, e`'3'`.

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

L'esempio seguente dimostra che la funzione STR\$1TO\$1MAP prevede che la stringa di input sia in un formato specifico, con le coppie chiave-valore delimitate correttamente. Se la stringa di input non corrisponde al formato previsto, la funzione tenterà comunque di creare una mappa, ma i valori risultanti potrebbero non essere quelli previsti.

```
SELECT str_to_map('a');
 {"a":null}
```