variant_explode_outer دالة ذات قيمة جدولية

ينطبق على: Databricks SQL Databricks Runtime 15.3 والإحدث

إرجاع مجموعة من الصفوف عن طريق إلغاء التداخل variantExpr باستخدام الدلالات الخارجية.

بناء الجملة

variant_explode_outer ( variantExpr )

الوسيطات

• variantExprVARIANT: تعبير، يمثل كائنا VARIANT أو VARIANT ARRAY.

المرتجعات

مجموعة من الصفوف تتكون من عناصر VARIANT ARRAYأو مفاتيح وقيم VARIANT العنصر. الأعمدة التي ينتجها variant_explode هي:

• pos INT
• key STRING
• value VARIANT.

عند انفجار كائن VARIANT ، يمثل الإخراج key والأعمدة value مفاتيح الكائن وقيمه. عند انفجار VARIANT صفيف، يكون الإخراج key دائما فارغا، ويمثل عمود الإخراج value عناصر الصفيف.

إذا كان variantExpr ، NULLأو ليس بعنصر VARIANT ARRAY واحد على الأقل أو OBJECT مع حقل واحد على الأقل، يتم إنتاج صف واحد من NULLs. لإرجاع أية صفوف في هذه الحالة، استخدم الدالة variant_explode .

الأمثلة

-- Simple example
> SELECT *
   FROM variant_explode_outer(parse_json('[1, "a", {"b": "hello"}]'));
  pos  key  value
  ---  ---- -------------
    0  NULL 1
    1  NULL "a"
    2  NULL {"b":"hello"}

> SELECT *
    FROM variant_explode_outer(parse_json('{"foo":1,"bar":"hello"}'));
  pos  key  value
  ---  ---- -------------
    0  bar  "hello"
    1  foo  1

 -- null input
> SELECT value FROM variant_explode_outer(null) AS t(pos, key, value);
  null

-- Not an array or object input
> SELECT value FROM variant_explode_outer(parse_json('123')) AS t(pos, key, value);
  null

-- Using lateral correlation
> SELECT t.value AS outer, u.value AS inner
    FROM variant_explode_outer(parse_json('[[1, 2], [3, 4]]')) AS t,
    LATERAL variant_explode(t.value) AS u;
  outer inner
  ----- -----
  [1,2]     1
  [1,2]     2
  [3,4]     3
  [3,4]     4

الدالات ذات الصلة

• variant_explode دالة ذات قيمة جدول