إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

FIRST_VALUE

تعيد قيمة التعبير بعد تقييمه على الصف الأول في إطار النافذة.

تحسب دالة النافذة المدمجة هذه إطار النافذة لكل صف على النحو نفسه الذي تحسبه به دالة نافذة تجميعية. وتعيد لكل صف قيمة التعبير بعد تقييمه على الصف الأول في إطار النافذة.

راجع أيضًا: [SELECT] [LAST_VALUE] [NTH_VALUE]


بناء الجملة​

SELECT FIRST_VALUE(expr) OVER (
[PARTITION BY column]
ORDER BY column
[ROWS BETWEEN frame_start AND frame_end]
) FROM <multipartIdentifier>;

الوسيطات​

expr التعبير المراد تقييمه على الصف الأول في إطار النافذة.

PARTITION BY column اختياري. تقسم مجموعة النتائج إلى أقسام. يتم تطبيق الدالة FIRST_VALUE داخل كل قسم على حدة.

ORDER BY column تحدد ترتيب معالجة الصفوف.

ROWS BETWEEN frame_start AND frame_end اختياري. تحدد إطار النافذة. من الخيارات الشائعة:

  • ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
  • ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING

في حالة عدم وجود عبارة إطار، يكون الإطار RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW: أي أنه ينتهي عند آخر صف يتعادل مع الصف الحالي في أعمدة ORDER BY، وليس عند الصف الحالي.

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

تعيد قيمة التعبير بعد تقييمه على الصف الأول في إطار النافذة.


أمثلة​

العثور على الإصدار الأول لتوفير السياق​

-- Find first and latest release for context
SELECT
tag_name,
name,
published_at,
FIRST_VALUE(tag_name) OVER (
ORDER BY published_at
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
) as first_release,
LAST_VALUE(tag_name) OVER (
ORDER BY published_at
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
) as latest_release
FROM github.repos.releases
WHERE owner = 'stackql'
AND repo = 'stackql';
تلميح

افتراضيًا، يمتد إطار النافذة من بداية القسم إلى آخر صف يتعادل مع الصف الحالي في أعمدة ORDER BY. تقرأ الدالة FIRST_VALUE الصف الأول من الإطار، لذا فإنها تعيد القيمة نفسها مع الإطار الافتراضي ومع ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING؛ أما الإطار الصريح فله أهمية في حالة الدالتين LAST_VALUE وNTH_VALUE، اللتين تقرآن ما هو أبعد داخل الإطار.

لمزيد من المعلومات، راجع https://sqlite.org/windowfunctions.html#built-in_window_functions.