次の方法で共有

inline_outer テーブル値ジェネレーター関数

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

構造体の配列を、OUTER セマンティクスを含むテーブルに分解します。

Databricks Runtime 16.1 以降では、この関数は名前付きパラメーター呼び出し をサポートしています。

構文

inline_outer(input)

引数

  • input: ARRAY < STRUCT > 式。

配列 input の構造体要素内のフィールドで構成される行のセット。 inline によって生成される列は、フィールドの名前です。

input が NULL である場合、各列に NULL が入った単一の行が生成されます。

  • 適用対象:「はい」のチェック マーク Databricks Runtime 12.1 以前:

    inline_outer は式のルートとして、または SELECT に続く場合にのみ、 リストに配置できます。 関数を SELECT リストに配置する場合、同じ SELECT リストに他のジェネレーター関数が存在してはいけません。存在する場合は、UNSUPPORTED_GENERATOR.MULTI_GENERATOR が発生します。

  • 適用対象:check marked yes Databricks SQL 「はい」のチェック マーク Databricks Runtime 12.2 LTS 以上:

    LATERAL VIEW 句または SELECT リストからの呼び出しは非推奨です。 代わりに、inline_outer として を呼び出します。

例

適用対象:「はい」のチェック マーク Databricks Runtime 12.1 以前:

> SELECT inline_outer(array(struct(1, 'a'), struct(2, 'b'))), 'Spark SQL';
 1  a Spark SQL
 2  b Spark SQL

> SELECT inline_outer(array(struct(1, 'a'), struct(1, 'b'))),
         inline_outer(array(struct('c', 1.0), struct('d', 2.0))),
         'Spark SQL';
 1  a Spark SQL
 2  b Spark SQL
Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR

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

> SELECT i.*, 'Spark SQL'
    FROM inline_outer(array(struct(1, 'a'), struct(2, 'b'))) AS i;
 1  a Spark SQL
 2  b Spark SQL

> SELECT i1.*, i2.*, 'Spark SQL'
   FROM  inline_outer(array(struct(1, 'a'), struct(1, 'b'))) AS i1,
         inline_outer(array(struct('c', 1.0), struct('d', 2.0))) AS i2;
 1      a       c       1.0     Spark SQL
 1      b       c       1.0     Spark SQL
 1      a       d       2.0     Spark SQL
 1      b       d       2.0     Spark SQL