次の方法で共有

variant_explode_outer テーブル値関数

  • [アーティクル]

適用対象: check marked yes Databricks SQL 「はい」のチェック マーク Databricks Runtime 15.3 以降

外部セマンティクスを使用して入れ子を解除した variantExpr により、行のセットを返します。

構文

variant_explode_outer ( variantExpr )

引数

  • variantExpr: VARIANT オブジェクトまたは VARIANT ARRAY を表す VARIANT 式。

返品

VARIANT ARRAY の要素、または VARIANT オブジェクトのキーと値で構成される行のセット。 variant_explode によって生成される列は次のとおりです。

  • pos INT
  • key STRING
  • value VARIANT=

VARIANT オブジェクトを分解すると、出力の key および value 列はオブジェクトのキーと値を表します。 VARIANT 配列を分解すると、出力の key は常に null 値で、出力の value 列は配列の要素を表します。

variantExpr が NULL である場合、または少なくとも 1 つの要素を含む VARIANT ARRAY または少なくとも 1 つのフィールドを含む OBJECT のいずれでもない場合、NULL の 1 行が生成されます。 この場合に行を返さないようにするには、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