# JSON_OBJECT

> StackQL の JSON_OBJECT 関数：キーと値の引数から JSON オブジェクトを構築します（INSERT や UPDATE のリクエストボディの作成など）。

Source: https://stackql.io/ja/language-spec/functions/json/json_object

指定した引数から構築したオブジェクトを返します。  

関連項目：  
[[` SELECT `]](/language-spec/select) [[` DESCRIBE `]](/language-spec/describe) [[` JSON_EXTRACT `]](/language-spec/functions/json/json_extract) [[ データ型 ]](/language-spec/data-types)

* * * 

:::tip 

[**DESCRIBE**](/language-spec/describe) 関数を使用すると、StackQL の JSON 関数で使用できる `array` または `object` データ型を確認できます。

:::

:::note 

`postgres` SQL バックエンドで stackql を使用している場合、`json_object` 関数は `jsonb_build_object` として実装されます。

:::

## 構文

```sql
SELECT JSON_OBJECT(key1, value1, key2, value2, ...) 
FROM <multipartIdentifier>;
```

## 引数

__*key1, key2, ...*__  
JSON オブジェクトのラベル。

__*value1, value2, ...*__  
JSON オブジェクト内のラベルに対応する値。

## 戻り値
整形式の JSON オブジェクトを表す文字列。

* * *

## 例

### JSON オブジェクトまたは配列内にネストしたフィールドのデータ型を返す

```sql
SELECT JSON_GROUP_ARRAY(json_object('instance', selfLink)) as instance_links
FROM google.compute.instances 
WHERE project = 'stackql-k8s-the-hard-way-demo'
AND zone = 'australia-southeast1-a'
AND name like '%-dev-controller-%';
/* returns a data structure required for a targetPool in GCP */
```

詳細については、[https://sqlite.org/json1.html#jobj](https://sqlite.org/json1.html#jobj) を参照してください。