# JSON_OBJECT

> Fonction JSON_OBJECT dans StackQL : construire un objet JSON à partir d'arguments clé et valeur, par exemple pour composer les corps de requête d'INSERT et d'UPDATE.

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

Renvoie un objet construit à partir des arguments fournis.  

Voir aussi :  
[[` SELECT `]](/language-spec/select) [[` DESCRIBE `]](/language-spec/describe) [[` JSON_EXTRACT `]](/language-spec/functions/json/json_extract) [[ Types de données ]](/language-spec/data-types)

* * * 

:::tip 

Utilisez la fonction [**DESCRIBE**](/language-spec/describe) pour repérer les types de données `array` ou `object` utilisables avec les fonctions JSON de StackQL.

:::

:::note 

La fonction `json_object` est implémentée en tant que `jsonb_build_object` si vous utilisez stackql avec un backend SQL `postgres`.

:::

## Syntaxe

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

## Arguments

__*key1, key2, ...*__  
Les libellés de l'objet JSON.

__*value1, value2, ...*__  
Les valeurs correspondant aux libellés de l'objet JSON.

## Valeur(s) renvoyée(s)
Une chaîne de caractères représentant l'objet JSON bien formé.

* * *

## Exemples

### Renvoyer le type de données d'un champ imbriqué dans un objet ou un tableau 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 */
```

Pour plus d'informations, consultez [https://sqlite.org/json1.html#jobj](https://sqlite.org/json1.html#jobj)
