カテゴリ：: クエリ構文

UNPIVOT¶

列を行に変換することにより、テーブルを回転します。UNPIVOT は、列のリストとともに（テーブルまたはサブクエリから）2つの列を受け入れ、リストで指定された各列の行を生成する関係演算子です。クエリでは、テーブル名またはサブクエリの後の FROM 句で指定されます。

PIVOTによる集計を取り消すことはできないため、UNPIVOTはPIVOTの正確な逆関数ではありません。

この演算子を使用して、幅の広いテーブル（例： empid、 jan_sales、 feb_sales、 mar_sales など）を幅の狭いテーブル（例： empid、 month、 sales）に変換できます。

こちらもご参照ください。: PIVOT

構文¶

SELECT ...
FROM ...
    UNPIVOT [ { INCLUDE | EXCLUDE } NULLS ]
      ( <value_column>
        FOR <name_column> IN (
          <col> [ [ AS ] <col_alias> ],
          ...
        )
      )

[ ... ]

パラメーター¶

{ INCLUDE | EXCLUDE } NULLS

name_column に NULLs のある行を含めるか除外するかを指定します。

INCLUDE NULLS の場合は、 NULLs のある行が含まれます。
EXCLUDE NULLS の場合は、 NULLs のある行が除外されます。

デフォルト: EXCLUDE NULLS

value_column

生成列に割り当てる名前。列リスト内の列の値が入力されます。

name_column

生成列に割り当てる名前。列リスト内の列の名前が入力されます。

column_list

単一のピボット列に転置されるソーステーブルまたはサブクエリの列の名前。列名には name_column が入力され、列値には value_column が入力されます。

column_list にはリテラル列名のみを含めることができ、サブクエリを含めることはできません。

column_list の列は、以下の例外を除き、まったく同じデータ型にする必要があります。

文字列のデータ型は、異なる長さにすることができます。
列が文字列を含む場合は、列ごとに異なるデータ型をテキストに使用することができます。たとえば、リストには VARCHAR 列と CHAR 列を含めることができます。

[ AS ] col_alias

UNPIVOT 操作の結果で、元の列名の代わりに使用する列エイリアスを指定します。同じ列名に異なるエイリアスを使用することはできません。ただし、複数の列名に同じエイリアスを使うことはできません。キーワード AS はオプションです。

使用上の注意¶

:doc:`LATERAL結合</sql-reference/constructs/join-lateral>`を使用して、UNPIVOT操作の結果セットを直接参照することはできません。これを実行しようとすると、エラーが返されます。回避策として、最初にUNPIVOTの結果を仮テーブルに実体化し、次にLATERAL結合でそのテーブルを参照します。この例で選択されている``monthly_sales``テーブルを作成してロードする方法については、:ref:`例のセクション<label-unpivot-examples>`を参照してください。

LATERALはUNPIVOT結果セットを直接参照できないため、次のクエリは機能しません。
```
SELECT *
  FROM monthly_sales
    UNPIVOT (sales FOR month IN (jan, feb, mar, apr)) unpvt
    JOIN LATERAL (SELECT unpvt.sales AS sales_value) jl;
```
次のCREATETEMPORARYTABLEステートメントは、UNPIVOTの結果を実体化するための仮テーブルを作成します。そのステートメントに続くクエリは、LATERAL結合で仮テーブルを参照します。
```
CREATE OR REPLACE TEMPORARY TABLE unpivot_result AS
  SELECT *
    FROM monthly_sales
      UNPIVOT (sales FOR month IN (jan, feb, mar, apr));

SELECT *
  FROM unpivot_result
    JOIN LATERAL (SELECT unpivot_result.sales AS sales_value) jl;
```

例¶

以下の構造とデータを持つテーブル、 monthly_sales を作成します。

CREATE OR REPLACE TABLE monthly_sales(
  empid INT,
  dept TEXT,
  jan INT,
  feb INT,
  mar INT,
  apr INT);

INSERT INTO monthly_sales VALUES
  (1, 'electronics', 100, 200, 300, 100),
  (2, 'clothes', 100, 300, 150, 200),
  (3, 'cars', 200, 400, 100, 50),
  (4, 'appliances', 100, NULL, 100, 50);

SELECT * FROM monthly_sales;

+-------+-------------+-----+------+------+-----+
| EMPID | DEPT        | JAN | FEB  | MAR  | APR |
|-------+-------------+-----+------+------+-----|
|     1 | electronics | 100 | 200  | 300  | 100 |
|     2 | clothes     | 100 | 300  | 150  | 200 |
|     3 | cars        | 200 | 400  | 100  |  50 |
|     4 | appliances  | 100 | NULL | 100  |  50 |
+-------+-------------+-----+------+------+-----+

個々の月列のピボットを解除し、各従業員に対して month ごとに単一の sales 値を返します。

SELECT *
  FROM monthly_sales
    UNPIVOT (sales FOR month IN (jan, feb, mar, apr))
  ORDER BY empid;

+-------+-------------+-------+-------+
| EMPID | DEPT        | MONTH | SALES |
|-------+-------------+-------+-------|
|     1 | electronics | JAN   |   100 |
|     1 | electronics | FEB   |   200 |
|     1 | electronics | MAR   |   300 |
|     1 | electronics | APR   |   100 |
|     2 | clothes     | JAN   |   100 |
|     2 | clothes     | FEB   |   300 |
|     2 | clothes     | MAR   |   150 |
|     2 | clothes     | APR   |   200 |
|     3 | cars        | JAN   |   200 |
|     3 | cars        | FEB   |   400 |
|     3 | cars        | MAR   |   100 |
|     3 | cars        | APR   |    50 |
|     4 | appliances  | JAN   |   100 |
|     4 | appliances  | MAR   |   100 |
|     4 | appliances  | APR   |    50 |
+-------+-------------+-------+-------+

次の例は前の例と同じですが、列名にエイリアスを使用しています。

SELECT *
  FROM monthly_sales
    UNPIVOT (sales FOR month IN (
      jan AS january,
      feb AS february,
      mar AS march,
      apr AS april)
    )
  ORDER BY empid;

+-------+-------------+----------+-------+
| EMPID | DEPT        | MONTH    | SALES |
|-------+-------------+----------+-------|
|     1 | electronics | JANUARY  |   100 |
|     1 | electronics | FEBRUARY |   200 |
|     1 | electronics | MARCH    |   300 |
|     1 | electronics | APRIL    |   100 |
|     2 | clothes     | JANUARY  |   100 |
|     2 | clothes     | FEBRUARY |   300 |
|     2 | clothes     | MARCH    |   150 |
|     2 | clothes     | APRIL    |   200 |
|     3 | cars        | JANUARY  |   200 |
|     3 | cars        | FEBRUARY |   400 |
|     3 | cars        | MARCH    |   100 |
|     3 | cars        | APRIL    |    50 |
|     4 | appliances  | JANUARY  |   100 |
|     4 | appliances  | MARCH    |   100 |
|     4 | appliances  | APRIL    |    50 |
+-------+-------------+----------+-------+

前の SELECT ステートメントは、デフォルトで NULLs を除外します。そのため、2月の家電製品の行は結果に含まれていません。結果に NULLs を含めるには、以下の SQL ステートメントを実行します。

SELECT *
  FROM monthly_sales
    UNPIVOT INCLUDE NULLS (sales FOR month IN (jan, feb, mar, apr))
  ORDER BY empid;

+-------+-------------+-------+-------+
| EMPID | DEPT        | MONTH | SALES |
|-------+-------------+-------+-------|
|     1 | electronics | JAN   |   100 |
|     1 | electronics | FEB   |   200 |
|     1 | electronics | MAR   |   300 |
|     1 | electronics | APR   |   100 |
|     2 | clothes     | JAN   |   100 |
|     2 | clothes     | FEB   |   300 |
|     2 | clothes     | MAR   |   150 |
|     2 | clothes     | APR   |   200 |
|     3 | cars        | JAN   |   200 |
|     3 | cars        | FEB   |   400 |
|     3 | cars        | MAR   |   100 |
|     3 | cars        | APR   |    50 |
|     4 | appliances  | JAN   |   100 |
|     4 | appliances  | FEB   |  NULL |
|     4 | appliances  | MAR   |   100 |
|     4 | appliances  | APR   |    50 |
+-------+-------------+-------+-------+

この出力には、2月の家電製品の行が含まれています。

すべての列を * で選択するのではなく、特定の列を SELECT リストに含めて、 UNPIVOT value_column と name_column を参照することができます。次の例は前の例と似ていますが、 SELECT リストで value_column sales と name_column month を指定しています。このクエリは empid 列を除外しています。

SELECT dept, month, sales
  FROM monthly_sales
    UNPIVOT INCLUDE NULLS (sales FOR month IN (jan, feb, mar, apr))
  ORDER BY dept;

+-------------+-------+-------+
| DEPT        | MONTH | SALES |
|-------------+-------+-------|
| appliances  | JAN   |   100 |
| appliances  | FEB   |  NULL |
| appliances  | MAR   |   100 |
| appliances  | APR   |    50 |
| cars        | JAN   |   200 |
| cars        | FEB   |   400 |
| cars        | MAR   |   100 |
| cars        | APR   |    50 |
| clothes     | JAN   |   100 |
| clothes     | FEB   |   300 |
| clothes     | MAR   |   150 |
| clothes     | APR   |   200 |
| electronics | JAN   |   100 |
| electronics | FEB   |   200 |
| electronics | MAR   |   300 |
| electronics | APR   |   100 |
+-------------+-------+-------+