共用方式為

variant_explode table-valued 函式

  • 發行項

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

將 input解嵌以返回 set 行。

在 Databricks Runtime 16.1 和更新版本中，此函式支援 具名參數呼叫。

語法

variant_explode ( input )

引數

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

傳回

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

  • pos INT
  • key STRING
  • value VARIANT.

當 VARIANT 物件爆炸時，輸出的 key 和 valuecolumns 代表了物件的索引鍵和 values。 當展開 VARIANT 陣列時，輸出 key 一律是 NULL，而輸出 valuecolumn 表示陣列的元素。

如果 input 是 NULL，或不是 VARIANT ARRAY 或 VARIANT 物件，則不會產生任何數據列。 若要在此案例中產生單一列 NULLvalues，請使用 variant_explode_outer 函式。

範例

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

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

-- Using lateral correlation
> SELECT t.value AS outer, u.value AS inner
    FROM variant_explode(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