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

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

NTH_VALUE

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

تحسب دالة النافذة المدمجة هذه إطار النافذة لكل صف على النحو نفسه الذي تحسبه به دالة نافذة تجميعية. وتعيد قيمة التعبير بعد تقييمه على الصف N من إطار النافذة. يبدأ ترقيم الصفوف داخل إطار النافذة من 1 بالترتيب الذي تحدده عبارة ORDER BY إن وجدت، أو بترتيب اعتباطي في غير ذلك. إذا لم يوجد صف رقم N في القسم، فإن الدالة تعيد NULL.

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


بناء الجملة​

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

الوسيطات​

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

N عدد صحيح موجب يحدد رقم الصف المراد استرداده (يبدأ الترقيم من 1).

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

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

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

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

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


أمثلة​

الحصول على أفضل ثلاثة مساهمين​

-- Get the top 3 contributors by number of contributions
SELECT
login,
contributions,
NTH_VALUE(login, 1) OVER (ORDER BY contributions DESC
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as top_contributor,
NTH_VALUE(login, 2) OVER (ORDER BY contributions DESC
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as second_contributor,
NTH_VALUE(login, 3) OVER (ORDER BY contributions DESC
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as third_contributor
FROM github.repos.contributors
WHERE owner = 'stackql'
AND repo = 'stackql';

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