تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
SUM
تعيد مجموع جميع القيم غير NULL في عمود أو مجموعة من الأعمدة.
استخدم الدالة TOTAL لجمع الأعداد ذات الفاصلة العائمة أو القيم الطويلة.
بناء الجملة
SELECT SUM(columnExpression) FROM <multipartIdentifier>
[ GROUP BY groupByColumn ];
الوسيطات
columnExpression
عمود أو تعبير.
إذا كانت جميع القيم في columnExpression هي
NULL، تعيد الدالةSUMالقيمةNULL.
تطرح الدالة
SUMالاستثناء "integer overflow" إذا حدث تجاوز لسعة الأعداد الصحيحة في أي مرحلة أثناء الحساب. أما الدالةTOTALفلا تطرح أبدًا استثناء تجاوز سعة الأعداد الصحيحة.
groupByColumn
عمود أو أعمدة تجري عليها عمليات التلخيص أو التجميع. تعيد عبارة GROUP BY صفًا واحدًا لكل مجموعة أعمدة.
القيمة المرجعة
تعيد عددًا صحيحًا يمثل مجموع columnExpression إذا كانت جميع قيم الإدخال غير NULL أعدادًا صحيحة. إذا لم تكن بعض قيم الإدخال أعدادًا صحيحة أو كانت NULL، تعيد الدالة قيمة بفاصلة عائمة قد تكون تقريبًا للمجموع الحقيقي.
أمثلة
إرجاع مجموع تعبير عمود على مستوى مورد كامل
SELECT sum(json_array_length(disks)) as sum_disks
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
إرجاع مجموع تعبير عمود مجمع حسب تعبير عمود آخر
SELECT status, sum(json_array_length(disks)) as sum_disks
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a'
GROUP BY status;
استخدام SUM كدالة نافذة لحساب المجاميع التراكمية
-- Calculate running total and percentage of contributions
SELECT
login,
contributions,
SUM(contributions) OVER (ORDER BY contributions DESC) as running_total,
SUM(contributions) OVER () as total_contributions,
ROUND(100.0 * contributions / SUM(contributions) OVER (), 2) as pct_of_total
FROM github.repos.contributors
WHERE owner = 'stackql'
AND repo = 'stackql';
لمزيد من المعلومات، راجع https://www.sqlite.org/lang_aggfunc.html#sumunc.