共用方式為

variant_explode_outer table-valued 函式

  • 發行項

適用於：核取記號為「是」 Databricks SQL 核取記號為「是」 Databricks Runtime 15.3 和更新版本

使用外部語意取消巢狀 variantExpr，傳回數據列的 set。

語法

variant_explode_outer ( variantExpr )

引數

  • variantExpr VARIANT：表達式，表示 VARIANT 物件或 VARIANT ARRAY。

傳回

由 VARIANT ARRAY的元素或 VARIANT 物件的索引鍵和 values 組成的數據列 set。 columns 由 variant_explode 所產生如下：

  • pos INT
  • key STRING
  • value VARIANT.

當對 VARIANT 物件進行爆炸操作時，輸出結果 key 和 valuecolumns 分別代表物件的鍵值和 values。 當分解 VARIANT 陣列時，輸出 key 一律為 null，而輸出 valuecolumn 代表陣列的元素。

如果 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