通过

variant_explode_outer 表值函数

适用于： Databricks SQL 已勾选 Databricks Runtime 15.3 及更高版本check marked yes

使用 outer 语义通过取消嵌套 variantExpr 返回行集。

语法

variant_explode_outer ( variantExpr )

参数

  • variantExpr：VARIANT 表达式，表示 VARIANT 对象或 VARIANT ARRAY。

返回

由 VARIANT ARRAY 的元素或者 VARIANT 对象的键和值组成的行集。 由 variant_explode 生成的列包括：

  • pos INT
  • key STRING
  • value VARIANT。

当分解 VARIANT 对象时，输出 key 和 value 列表示对象的键和值。 当分解 VARIANT 数组时，输出 key 始终为 null，输出 value 列表示数组的元素。

如果 variantExpr 是 NULL，或者既不是具有至少一个元素的 VARIANT ARRAY，也不是具有至少一个字段的 OBJECT，则会生成一行 NULL。 若要在此示例中不返回任何行，请使用 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