LATERAL¶

LATERAL を使用するタイミング¶

LATERALは、以下のようなユースケースに役立つツールです。

• ネストされたデータのテーブル関数のチェーン ：配列内の配列をフラット化する必要がある場合や、ネストされたJSONの複数のレベルをナビゲートする必要がある場合、後続の各テーブル関数呼び出しは、前の呼び出しの出力を参照する必要があります。ラテラル結合はこれを可能にします。

• 行固有の引数を使用してテーブル関数を呼び出す ：テーブル関数（UDTFなど）は、左側のテーブルから行ごとに異なる入力値を受け取る必要があります。

単一レベルの配列をフラット化するなどの単純なケースでは、ラテラル結合なしで TABLE(FLATTEN(...)) を使用すると同じ結果が生成されます。ラテラル結合は、インラインビューがFROM句の前の式からのみ取得できる列を参照する必要がある場合にのみ必要です。

構文¶

SELECT ...
  FROM <left_hand_table_expression>, LATERAL ( <inline_view> )
...

パラメーター¶

left_hand_table_expression

これは、次のような行のソースです。

• テーブル。

• ビュー。

• サブクエリ。

• テーブル関数。

• 以前の結合の結果。

inline_view

inline_view は次のいずれかです。

• インラインビュー: ステートメント内で定義され、ステートメントの期間のみ有効なビュー。

• サブクエリ。

• テーブル関数: FLATTEN などの組み込みテーブル関数またはユーザー定義のテーブル関数（UDTF）のいずれか。

inline_view はプレーンテーブル参照にはできません。WHERE句またはテーブル関数呼び出しを使用するサブクエリなど、左側のテーブル式の値に基づいて行を処理またはフィルターできる式でなければなりません。

使用上の注意¶

• キーワード LATERAL の後のインラインビューは、インラインビュー自体および FROM 句のインラインビューの左側のテーブルからのみ列を参照できます。

  CopyExpand

  SELECT *
    FROM table_reference_me, LATERAL (...), table_do_not_reference_me ...
  

  Show lessSee more

  Scroll to top

• 通常、インラインビューは left_hand_table_expression の1つ以上の列を参照しますが、その必要はありません。

• INNER JOIN 構文がコンマまたはキーワード「INNER JOIN」を使用できるように、ラテラル結合でもコンマまたはキーワード INNER JOIN を使用できます。例:

  CopyExpand

  FROM departments AS d INNER JOIN LATERAL (...)
  

  Show lessSee more

  Scroll to top

• ON、USING、またはNATURAL JOIN句は、以下で指定できません。

  • ラテラルテーブル関数（SQL UDTF以外）

  • テーブル関数への外部ラテラル結合（SQL UDTF以外）

  詳細については、JOINトピックの使用上の注意 をご参照ください。

• left_hand_table_expression`はUNPIVOTの結果セットにすることはできません。LATERAL結合でUNPIVOTエイリアスを参照しようとすると、エラーが発生します。回避策として、まずUNPIVOTの結果を仮テーブルに実体化し、その後、そのテーブルを左辺の式として使用します。詳細については、 :doc:/sql-reference/constructs/unpivot` をご参照ください。

例¶

（例: FLATTEN テーブル関数でのラテラル結合の使用 および WHERE 句での FLATTEN を使用した結果のフィルター処理 もご参照ください）

次の例では、これらのテーブルを使用します。

CREATE TABLE departments (department_id INTEGER, name VARCHAR);
CREATE TABLE employees (employee_ID INTEGER, last_name VARCHAR,
  department_ID INTEGER, project_names ARRAY);

INSERT INTO departments (department_ID, name) VALUES
  (1, 'Engineering'),
  (2, 'Support');
INSERT INTO employees (employee_ID, last_name, department_ID) VALUES
  (101, 'Richards', 1),
  (102, 'Paulson',  1),
  (103, 'Johnson',  2);

次のクエリは、サブクエリを持つラテラル結合です。

SELECT *
  FROM departments AS d,
    LATERAL (SELECT * FROM employees AS e WHERE e.department_ID = d.department_ID) AS iv2
  ORDER BY employee_ID;

+---------------+-------------+-------------+-----------+---------------+---------------+
| DEPARTMENT_ID | NAME        | EMPLOYEE_ID | LAST_NAME | DEPARTMENT_ID | PROJECT_NAMES |
|---------------+-------------+-------------+-----------+---------------+---------------|
|             1 | Engineering |         101 | Richards  |             1 | NULL          |
|             1 | Engineering |         102 | Paulson   |             1 | NULL          |
|             2 | Support     |         103 | Johnson   |             2 | NULL          |
+---------------+-------------+-------------+-----------+---------------+---------------+

次の SQL ステートメントは同等で、同じ出力を生成します。FROM 句のコンマの代わりに INNER JOIN というキーワードが使われています。

SELECT *
  FROM departments AS d INNER JOIN
    LATERAL (SELECT * FROM employees AS e WHERE e.department_ID = d.department_ID) AS iv2
  ORDER BY employee_ID;

CREATE OR REPLACE TABLE persons AS
  SELECT column1 AS id, PARSE_JSON(column2) AS c
    FROM VALUES
      (12712555,
       '{ "name": { "first": "John", "last": "Smith" },
          "contact": [{ "business": [
            { "type": "phone", "content": "555-1234" },
            { "type": "email", "content": "j.smith@example.com" }
          ]}]}'),
      (98127771,
       '{ "name": { "first": "Jane", "last": "Doe" },
          "contact": [{ "business": [
            { "type": "phone", "content": "555-1236" },
            { "type": "email", "content": "j.doe@example.com" }
          ]}]}');

SELECT id,
    f1.value:type::STRING AS contact_type,
    f1.value:content::STRING AS contact_details
  FROM persons p,
    LATERAL FLATTEN(INPUT => p.c, PATH => 'contact') f,
    LATERAL FLATTEN(INPUT => f.value:business) f1;

+----------+--------------+---------------------+
|       ID | CONTACT_TYPE | CONTACT_DETAILS     |
|----------+--------------+---------------------|
| 12712555 | phone        | 555-1234            |
| 12712555 | email        | j.smith@example.com |
| 98127771 | phone        | 555-1236            |
| 98127771 | email        | j.doe@example.com   |
+----------+--------------+---------------------+

LATERALと他のアプローチとの比較¶

次のテーブルは、他のアプローチと比較してLATERALを使用するタイミングをまとめたものです。