مشاركة عبر


try_element_at دالة

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

إرجاع عنصر arrayExpr في index، أو NULL إذا كان index خارج الحدود.

إرجاع قيمة mapExpr ل key، أو معرف key NULL غير موجود.

بناء الجملة

try_element_at(arrayExpr, index)
try_element_at(mapExpr, key)

الوسيطات

  • arrayExpr: تعبير صفيف.
  • index: تعبير عدد صحيح.
  • mapExpr: تعبير MAP.
  • key: تعبير يطابق نوع مفاتيح mapExpr

المرتجعات

إذا كانت الوسيطة الأولى عبارة عن ARRAY:

  • تكون النتيجة من نوع عناصر expr.
  • يجب ألا يكون abs (الفهرس) 0.
  • إذا كانت index سالبة، تصل الدالة إلى العناصر من الأخير إلى الأول.
  • ترجع NULL الدالة إذا abs(index) تجاوزت طول الصفيف، أو إذا key لم تكن موجودة في الخريطة.

الأمثلة

> SELECT try_element_at(array(1, 2, 3), 2);
 2

> SELECT try_element_at(array(1, 2, 3), 5);
 NULL

> SELECT element_at(array(1, 2, 3), 5);
 Error: INVALID_ARRAY_INDEX_IN_ELEMENT_AT

> SELECT try_element_at(map(1, 'a', 2, 'b'), 2);
 b

> SELECT element_at(map(1, 'a', 2, 'b'), 3);
 NULL

> SELECT try_element_at(map(1, 'a', 2, 'b'), 3);
 NULL