مشاركة عبر

[ ] عامل التشغيل (علامة قوس)

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

إرجاع عنصر صفيف أو قيمة خريطة معينة إلى فهرس أو مفتاح.

بناء الجملة

expr [ keyExpr ]

لاحظ أن استخدام الأقواس هنا هو كنص حرفي ولا يشير إلى بناء جملة اختياري.

الوسيطات

  • expr: صفيف أو تعبير MAP.
  • keyExpr: إذا كان expr صفيف عبارة عن رقم لا يتجزأ. وإلا فإن تعبيرا يطابق نوع مفتاح MAP.

المرتجعات

نوع النتيجة هو نوع عنصر ARRAY أو نوع قيمة MAP.

العنصر الأول من ARRAY هو في الفهرس 0.

keyExpr إذا لم يكن مفتاح صالحا ل MAP expr Azure Databricks، فترجع قيمة خالية.

keyExpr إذا كان خارج نطاق صفيف expr Azure Databricks يثير خطأ INVALID_ARRAY_INDEX.

إشعار

في Databricks Runtime، إذا كان spark.sql.ansi.enabled هو false، يرجع NULL عامل التشغيل بدلا من خطأ خارج الحدود.

الأمثلة

> SELECT a[2] FROM VALUES(array(10, 20, 30)) AS T(a);
  30

> SELECT m[1] FROM VALUES(map(1, 'Hello', 2, 'World')) AS T(m);
  Hello