본문으로 바로가기
본문으로 바로가기

Join 테이블 엔진

JOIN 연산에서 사용할 수 있도록 미리 준비해 두는 선택적 데이터 구조입니다.

참고

ClickHouse Cloud에서 서비스가 25.4 이전 버전으로 생성된 경우, SET compatibility=25.4를 사용하여 호환성을 최소 25.4로 설정해야 합니다.

테이블 생성​

CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
(
    name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1] [TTL expr1],
    name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2] [TTL expr2],
) ENGINE = Join(join_strictness, join_type, k1[, k2, ...])

CREATE TABLE 쿼리에 대한 자세한 설명은 해당 문서를 참조하십시오.

엔진 매개변수​

join_strictness​

join_strictness – JOIN 엄격도.

join_type​

join_type – JOIN 유형.

키 컬럼​

k1[, k2, ...] – JOIN 연산이 수행되는 USING 절의 키 컬럼입니다.

join_strictness 및 join_type 파라미터는 따옴표 없이 입력해야 합니다. 예를 들어 Join(ANY, LEFT, col1)과 같이 사용합니다. 이 값들은 테이블이 사용될 JOIN 연산과 일치해야 합니다. 파라미터가 일치하지 않더라도 ClickHouse는 예외를 발생시키지 않으며, 잘못된 데이터를 반환할 수 있습니다.

세부 사항 및 권장 사항​

데이터 저장​

Join 테이블 데이터는 항상 RAM에 상주합니다. 테이블에 행을 삽입하면 ClickHouse는 서버가 다시 시작될 때 복원할 수 있도록 디스크의 디렉터리에 데이터 블록을 기록합니다.

서버가 비정상적으로 재시작되면 디스크의 데이터 블록이 손실되거나 손상될 수 있습니다. 이 경우 손상된 데이터가 있는 파일을 수동으로 삭제해야 할 수 있습니다.

데이터 조회 및 삽입​

INSERT 쿼리를 사용하여 Join-엔진 테이블에 데이터를 추가할 수 있습니다. 테이블이 ANY 엄격 모드로 생성된 경우 중복 키에 대한 데이터는 무시됩니다. ALL 엄격 모드에서는 모든 행이 추가됩니다.

Join-엔진 테이블의 주요 사용 사례는 다음과 같습니다.

  • 테이블을 JOIN 절의 오른쪽(우변)에 두어 사용합니다.
  • 딕셔너리에서와 동일한 방식으로 테이블에서 데이터를 추출할 수 있게 해주는 joinGet 함수를 호출합니다.

데이터 삭제​

Join-엔진 테이블에 대한 ALTER DELETE 쿼리는 뮤테이션으로 구현됩니다. DELETE 뮤테이션은 필터링된 데이터를 읽고 메모리와 디스크의 데이터를 덮어씁니다.

제한 사항 및 설정​

테이블을 생성할 때 다음 설정이 적용됩니다.

join_use_nulls​

join_use_nulls

max_rows_in_join​

max_rows_in_join

max_bytes_in_join​

max_bytes_in_join

join_overflow_mode​

join_overflow_mode

join_any_take_last_row​

join_any_take_last_row

join_use_nulls​

Persistent​

Join 및 Set 테이블 엔진에 대해 영속성을 비활성화합니다.

I/O(입출력) 오버헤드를 줄입니다. 성능을 중시하고 영속성이 필요하지 않은 시나리오에 적합합니다.

설정 가능한 값은 다음과 같습니다.

  • 1 — 활성화.
  • 0 — 비활성화.

기본값: 1.

Join-엔진 테이블은 GLOBAL JOIN 연산에서 사용할 수 없습니다.

Join-엔진은 CREATE TABLE SQL 문에서 join_use_nulls 설정을 지정할 수 있습니다. SELECT 쿼리는 동일한 join_use_nulls 값을 가져야 합니다.

사용 예시​

왼쪽 테이블을 생성합니다:

CREATE TABLE id_val(`id` UInt32, `val` UInt32) ENGINE = TinyLog;

INSERT INTO id_val VALUES (1,11)(2,12)(3,13);

오른쪽 Join 테이블 만들기:

CREATE TABLE id_val_join(`id` UInt32, `val` UInt8) ENGINE = Join(ANY, LEFT, id);

INSERT INTO id_val_join VALUES (1,21)(1,22)(3,23);

테이블 조인하기:

SELECT * FROM id_val ANY LEFT JOIN id_val_join USING (id);

┌─id─┬─val─┬─id_val_join.val─┐
│  1 │  11 │              21 │
│  2 │  12 │               0 │
│  3 │  13 │              23 │
└────┴─────┴─────────────────┘

또 다른 방법으로, 조인 키 값을 지정하여 Join 테이블에서 데이터를 조회할 수 있습니다.

SELECT joinGet('id_val_join', 'val', toUInt32(1));

┌─joinGet('id_val_join', 'val', toUInt32(1))─┐
│                                         21 │
└────────────────────────────────────────────┘

Join 테이블에서 행을 삭제하기:

ALTER TABLE id_val_join DELETE WHERE id = 3;

┌─id─┬─val─┐
│  1 │  21 │
└────┴─────┘