collect_list الدالة التجميعية

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

إرجاع صفيف يتكون من كافة القيم داخل expr المجموعة. هذه الدالة هي مرادف للدالة التجميعية array_agg.

بناء الجملة

collect_list ( [ALL | DISTINCT] expr ) [FILTER ( WHERE cond ) ]

يمكن أيضا استدعاء هذه الدالة كدالة نافذة باستخدام العبارة OVER .

الوسيطات

  • expr: تعبير من أي نوع.
  • cond: تعبير منطقي اختياري يقوم بتصفية الصفوف المستخدمة للتجميع.

المرتجعات

صفيف من نوع الوسيطة.

ترتيب العناصر في الصفيف غير محدد. NULL يتم استبعاد القيم.

إذا DISTINCT تم تحديدها، تجمع الدالة قيما فريدة فقط وهي مرادف collect_set دالة تجميعية.

الأمثلة

> SELECT collect_list(col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2,1]

> SELECT collect_list(DISTINCT col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2]