翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

STR\$1TO\$1MAP 関数は、string-to-map変換関数です。マップ (またはディクショナリ) の文字列表現を実際のマップデータ構造に変換します。

この関数は、SQL でマップデータ構造を操作する必要がある場合に便利ですが、データは最初は文字列として保存されます。文字列表現を実際のマップに変換することで、マップデータのオペレーションと操作を実行できます。

## 構文
<a name="STR_TO_MAP-syntax"></a>

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

## 引数
<a name="STR_TO_MAP-arguments"></a>

 *text*   
マップを表す STRING 式。

 *pairDelim*   
エントリを分離する方法を指定するオプションの STRING リテラル。デフォルトはカンマ () です`','`。

 *keyValueDelim*   
各キーと値のペアを分離する方法を指定するオプションの STRING リテラル。デフォルトではコロン () になります`':'`。

## 戻り型
<a name="STR_TO_MAP-returns"></a>

STR\$1TO\$1MAP 関数は、キーと値の両方について STRING の MAP を返します。*pairDelim* と *keyValueDelim* はどちらも正規表現として扱われます。

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

次の例では、入力文字列と 2 つの区切り文字引数を取得し、文字列表現を実際のマップデータ構造に変換します。この特定の例では、入力文字列はキーと値のペアを持つマップ`'a:1,b:2,c:3'`を表します。 `'a'` はキー、 `'1'` は値です。 `'b'`はキー、 `'2'`は値です。 はキー、 は 値です。 `'c'` はキー、 `'3'`は 値です。`','` 区切り記号を使用してキーと値のペアを区切り、`':'`区切り記号を使用して各ペア内のキーと値を区切ります。このクエリの出力は です`{"a":"1","b":"2","c":"3"}`。これは結果のマップデータ構造で、キーは `'a'`、、`'b'`および `'c'`で、対応する値は `'1'`、`'2'`、および です`'3'`。

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

次の例は、STR\$1TO\$1MAP 関数が入力文字列が特定の形式で、キーと値のペアが正しく区切られていることを想定していることを示しています。入力文字列が想定された形式と一致しない場合、関数は引き続きマップの作成を試みますが、結果の値は想定どおりではない可能性があります。

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