LATERAL¶

LATERAL 사용 시점¶

LATERAL은 다음 사용 사례에 유용한 도구입니다.

• 중첩 데이터에 대한 테이블 함수 연결하기: 배열 내에서 배열을 평면화하거나 여러 수준의 중첩된 JSON을 탐색해야 하는 경우, 각 후속 테이블 함수 호출은 이전 함수 호출의 출력을 참조해야 합니다. 측면 조인은 이를 가능하게 합니다.

• 행별 인자로 테이블 함수 호출하기: 테이블 함수(예: UDTF)는 왼쪽 테이블에서 각 행에 대해 다른 입력 값을 수신해야 합니다.

단일 수준 배열 평면화와 같이 간단한 작업의 경우 측면 조인이 없는 :code:`TABLE(FLATTEN(…))`을 사용하여 동일한 결과를 생성합니다. 측면 조인은 인라인 뷰가 FROM 절의 이전 식에서만 사용할 수 있는 열을 참조해야 하는 경우에만 필요합니다.

구문¶

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

매개 변수¶

left_hand_table_expression

이는 다음과 같은 행 소스입니다.

• 테이블.

• 뷰.

• 하위 쿼리.

• 테이블 함수.

• 이전 조인의 결과입니다.

inline_view

inline_view 는 다음과 같을 수 있습니다:

• 인라인 뷰: 문 내에서 정의되고 문의 기간 동안에만 유효한 뷰.

• 하위 쿼리.

• 테이블 함수: FLATTEN 과 같은 기본 제공 테이블 함수 또는 사용자 정의 테이블 함수(UDTF).

:samp:`{inline_view}`는 일반 테이블 참조가 될 수 없습니다. WHERE 절 또는 테이블 함수 호출이 있는 하위 쿼리와 같이 왼쪽 테이블 식의 값을 기반으로 행을 처리하거나 필터링할 수 있는 식이어야 합니다.

사용법 노트¶

• LATERAL 키워드 뒤의 인라인 뷰는 인라인 뷰 자체에서만, 그리고 FROM 절의 인라인 뷰 왼쪽에 있는 테이블에서만 열을 참조할 수 있습니다.

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

  Copy

• 인라인 뷰는 일반적으로 :samp:`{left_hand_table_expression}`에서 하나 이상의 열을 참조하지만, 반드시 그렇게 할 필요는 없습니다.

• INNER JOIN 구문이 쉼표나 INNER JOIN이라는 키워드를 사용할 수 있는 것처럼 래터럴 조인도 쉼표나 INNER JOIN이라는 키워드를 사용할 수 있습니다. 예:

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

  Copy

• 다음에서 ON, USING 또는 NATURAL JOIN 절을 지정할 수 없습니다.

  • 측면 테이블 함수(SQL UDTF 제외)

  • 테이블 함수에 대한 외부 측면 조인(SQL UDTF 제외)

  자세한 내용은 :ref:`JOIN 항목의 사용법 노트 <label-join_usage_notes>`를 참조하세요.

예¶

참고 항목: 예: FLATTEN 테이블 함수와 함께 래터럴 조인 사용 및 FLATTEN을 사용하여 WHERE 절에서 결과 필터링하기.

다음 예제에서는 이러한 테이블을 사용합니다.

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을 사용해야 하는 경우가 요약되어 있습니다.