مشاركة عبر


array_insert دالة

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

إرجاع موسع array حيث elem يتم إدراج في index الموضع.

بناء الجملة

array_insert(array, index, elem)

الوسيطات

  • array:صفيف.
  • index: تعبير INTEGER غير صفري يحدد مكان إدراج elem. إذا كان الفهرس سالبا elem ، يتم إدراج نسبة إلى نهاية الصفيف.
  • elem: تعبير من نفس نوع عناصر array.

المرتجعات

صفيف من نفس نوع array.

ملاحظات

يتم نقل جميع العناصر التي تبدأ بموضع index واحد لتوفير مساحة ل elem في index. إذا كان index خارج العلاقة الأساسية للصفيف array يتم إضافة مع NULLs.

الأمثلة

> SELECT array_insert(array('a', 'b', 'c'), 1, 'z');
 ["z","a","b","c"]

> SELECT array_insert(array('a', 'b', 'c'), 0, 'z');
 Error

> SELECT array_insert(array('a', 'b', 'c'), -1, 'z');
 ["a","b","c","z"]

> SELECT array_insert(array('a', 'b', 'c'), 5, 'z');
 ["a","b","c",NULL,"z"]

> SELECT array_insert(array('a', 'b', 'c'), -5, 'z');
 ["z",NULL,"a","b","c"]

> SELECT array_insert(array('a', 'b', 'c'), 2, cast(NULL AS STRING));
 ["a",NULL,"b","c"]