nth_value دالة النافذة التحليلية

ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime

إرجاع القيمة في معين offset في النافذة.

بناء الجملة

nth_value(expr, offset) [ IGNORE NULLS | RESPECT NULLS ] OVER clause

الوسيطات

  • expr: تعبير من أي نوع.
  • offset: قيمة INTEGER حرفية أكبر من 0.
  • IGNORE NULLS أو RESPECT NULLS: عند IGNORE NULLS استخدام، يتم تجاهل أي expr قيمة فارغة في العدد. الافتراضي هو RESPECT NULLS.
  • عبارة OVER: العبارة التي تصف النوافذ. راجع: دوال النافذة.

المرتجعات

يتطابق نوع النتيجة مع expr النوع.

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

إذا لم يكن هناك مثل هذا offsetالصف، فسترجع NULL.

يجب استخدام عبارة ORDER BY مع هذه الدالة. إذا كان الطلب غير فريد، تكون النتيجة غير محددة.

الأمثلة

> SELECT a, b, nth_value(b, 2) OVER (PARTITION BY a ORDER BY b)
    FROM VALUES ('A1', 2), ('A1', 1), ('A2', 3), ('A1', 1) tab(a, b);
 A1 1   1
 A1 1   1
 A1 2   1
 A2 3   NULL