Skip to main content
이 엔진은 SQLite로 데이터를 가져오고 내보낼 수 있으며, ClickHouse에서 SQLite 테이블에 직접 쿼리할 수도 있습니다.

테이블 생성

엔진 매개변수
  • db_path — 데이터베이스가 저장된 SQLite 파일의 경로입니다.
  • table — SQLite 데이터베이스 내 테이블 이름이거나, SQLite에 그대로 전달되는 쿼리입니다(테이블 이름 대신 쿌리 전달 참조).

테이블 이름 대신 쿼리 전달하기

테이블 이름 대신 table 인수에 SQLite로 그대로 전달되는 SELECT 쿼리를 지정할 수 있습니다. 테이블의 구조는 쿌리 결과를 바탕으로 자동 추론됩니다. 쿼리는 하위 쿼리로 작성하거나 query 함수로 감쌀 수 있습니다.
이러한 테이블은 읽기 전용이므로 INSERT로 데이터를 삽입할 수 없습니다. 동일한 구문은 sqlite 테이블 함수에서도 지원됩니다.
하위 쿼리 형식인 (SELECT ...)는 ClickHouse에서 파싱된 뒤 다시 직렬화되어 SQLite로 전송됩니다. 따라서 유효한 ClickHouse SQL이어야 합니다. ClickHouse가 파싱하지 못하는 SQLite 전용 구문을 전달하려면 query('...') 형식을 사용하십시오. 이 형식의 텍스트는 그대로 SQLite로 전송됩니다.상위 ClickHouse 쿼리의 WHERE, LIMIT, 집계 등은 전달된 쿼리로 푸시다운되지 않으며, 전체 쿼리 결과를 가져온 후 ClickHouse에서 적용됩니다. SQLite에서 읽을 데이터를 제한하려면 전달된 쿼리 안에 filter를 넣으십시오. external_table_strict_query = 1을 사용하면 푸시다운할 수 없는 상위 filter는 로컬에서 적용되는 대신 예외와 함께 거부됩니다.

데이터 타입 지원

테이블 정의에서 ClickHouse 컬럼 타입을 명시적으로 지정하면, SQLite TEXT 컬럼에서 다음 ClickHouse 타입으로 파싱할 수 있습니다: 기본 타입 매핑은 SQLite 데이터베이스 엔진 문서를 참조하십시오.

사용 예시

다음은 SQLite 테이블을 생성하는 쿼리입니다:
테이블에서 데이터를 반환합니다:
관련 항목
마지막 수정일 2026년 7월 24일