# COUNT

> الدالة التجميعية COUNT في StackQL: عدد الصفوف في مورد، أو عدد القيم غير NULL لعمود داخل مجموعة.

Source: https://stackql.io/ar/language-spec/functions/aggregate/count

تعيد العدد الإجمالي للصفوف في مورد، أو عدد القيم غير `NULL` لعمود في مجموعة.  

راجع أيضًا:  
[[` SELECT `]](/language-spec/select)

* * * 

## بناء الجملة

```sql
SELECT COUNT( * | columnExpression ) FROM <multipartIdentifier>
[ GROUP BY groupByColumn ];
```

## الوسيطات

__*columnExpression*__  أو __*__  
عمود أو تعبير.  إذا حددت __*__ فإن الدالة تحسب جميع الصفوف في المورد أو المجموعة.  

> لا تحسب الدالة قيم `NULL` في *columnExpression*.  إذا كانت جميع القيم `NULL`، تعيد الدالة `COUNT` القيمة `0`.

__*groupByColumn*__  
عمود أو أعمدة تجري عليها عمليات التلخيص أو التجميع.  تعيد عبارة `GROUP BY` صفًا واحدًا لكل مجموعة أعمدة.

## القيمة المرجعة

تعيد عددًا صحيحًا يمثل ناتج العد.

* * *

## أمثلة

### إرجاع عدد الصفوف في مورد كامل

```sql
SELECT count(*) as num_instances
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

### إرجاع عدد الصفوف مجمعة حسب تعبير عمود

```sql
SELECT SPLIT_PART(machineType, '/', -1) as machine_type, count(*) as num_instances
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a'
GROUP BY SPLIT_PART(machineType, '/', -1);
```

### استخدام `COUNT` كدالة نافذة لحساب الأعداد التراكمية

```sql
-- Track cumulative issue counts over time
SELECT
    number,
    title,
    state,
    created_at,
    COUNT(*) OVER (ORDER BY created_at) as cumulative_issues,
    COUNT(*) OVER (PARTITION BY state ORDER BY created_at) as cumulative_by_state
FROM github.issues.issues
WHERE owner = 'stackql'
  AND repo = 'stackql'
ORDER BY created_at;
```

لمزيد من المعلومات، راجع [https://www.sqlite.org/lang_aggfunc.html#count](https://www.sqlite.org/lang_aggfunc.html#count).
