# JSON_GROUP_ARRAY

> تجميع القيم في مصفوفة JSON باستخدام SQL في StackQL.

Source: https://stackql.io/ar/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 JSON_GROUP_ARRAY(column_name) FROM <multipartIdentifier>
WHERE condition
GROUP BY column_name;
```

## الوسيطات

__*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 حسب موقعها، ويعيد عدة مصفوفات، واحدة لكل موقع، تحتوي كل منها على أسماء مجموعات الموارد في ذلك الموقع.
