# JSON_GROUP_ARRAY

> Агрегування значень у масив JSON за допомогою SQL у StackQL.

Source: https://stackql.io/uk/language-spec/functions/json/json_group_array

Агрегує значення у вигляді масиву JSON. Функція `JSON_GROUP_ARRAY()` збирає всі значення кожної групи у вказаному стовпці й об'єднує їх у масив JSON.

Див. також:  
[[`SELECT`]](/language-spec/select) [[` JSON_EXTRACT `]](/language-spec/functions/json/json_extract)

* * * 

## Синтаксис

```sql
SELECT grouping_column, JSON_GROUP_ARRAY(column_name) FROM <multipartIdentifier>
WHERE condition
GROUP BY grouping_column;
```

## Аргументи

__*column_name*__  
Стовпець, значення якого агрегуються в масив JSON.

## Значення, що повертається
Повертає масив JSON з усіма агрегованими значеннями вказаного стовпця.

* * *

## Приклади

### Агрегування імен груп ресурсів у масив JSON

```sql
-- Collects all resource group names into a JSON array
SELECT JSON_GROUP_ARRAY(name) as res_groups
FROM azure.resource.resource_groups
WHERE subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468';
```

Цей запит повертає масив JSON з іменами груп ресурсів, наприклад `["stackqlenv1","stackqlenv2","stackqlenv3"]`.

### Агрегування груп ресурсів за розташуванням

```sql
-- Collects resource group names into a JSON array grouped by location
SELECT
  location,
  JSON_GROUP_ARRAY(name) AS resource_groups
FROM
  azure.resource.resource_groups
WHERE
  subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468'
GROUP BY
  location;
```

Цей запит розподіляє групи ресурсів між масивами JSON відповідно до їхнього розташування й повертає кілька масивів, один для кожного розташування, з іменами груп ресурсів у цьому розташуванні.
