إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على: 
Databricks SQL Databricks Runtime
إرجاع القيمة expr الأولى لمجموعة من الصفوف. هذه الدالة هي مرادف للدالة التجميعية الأولى.
بناء الجملة
first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]
يمكن أيضا استدعاء هذه الدالة كدالة نافذة باستخدام العبارة OVER .
الوسيطات
expr: تعبير من أي نوع.ignoreNull: قيمة حرفية اختياريةBOOLEANيتم تعيينها افتراضيا إلى false.cond: تعبير منطقي اختياري يقوم بتصفية الصفوف المستخدمة للتجميع.IGNORE NULLSأوRESPECT NULLS: عندIGNORE NULLSاستخدام أوignoreNullيتمtrueتجاهل أيexprقيمة NULL. الافتراضي هوRESPECT NULLS.
المرتجعات
النتيجة لها نفس نوع expr.
هذه الدالة غير محددة.
الأمثلة
> SELECT first_value(col) FROM VALUES (10), (5), (20) AS tab(col);
10
> SELECT first_value(col) FROM VALUES (NULL), (5), (20) AS tab(col);
NULL
> SELECT first_value(col, true) FROM VALUES (NULL), (5), (20) AS tab(col);
5
> SELECT first_value(col) IGNORE NULLS FROM VALUES (10), (5), (NULL) AS tab(col);
5
> SELECT first_value(col) FILTER (WHERE col > 5) FROM VALUES (5), (20) AS tab(col);
20