Skip to main content
SQLite 데이터베이스에 저장된 데이터를 쿼리할 수 있습니다.

구문

인수

  • db_path — SQLite 데이터베이스가 있는 파일의 경로입니다. String.
  • table_name — SQLite 데이터베이스의 테이블 이름 또는 SQLite에 그대로 전달할 쿼리입니다(테이블 이름 대신 쿼리 전달 참조). String.

반환 값

  • 원본 SQLite 테이블과 동일한 컬럼을 갖는 테이블 객체입니다.

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

테이블 이름 대신 두 번째 인수로 SQLite에 그대로 전달되는 SELECT 쿼리를 사용할 수 있습니다. 결과로 생성되는 테이블의 구조는 쿼리 결과로부터 추론됩니다. 쿼리는 서브쿼리로 작성하거나 query 함수로 감싸 작성할 수 있습니다:
이러한 테이블은 읽기 전용이므로 여기에 INSERT할 수 없습니다. 동일한 구문이 SQLite 테이블 엔진에서도 지원됩니다.
서브쿼리(subquery) 형식인 (SELECT ...)는 ClickHouse에서 파싱된 후 다시 직렬화되어 SQLite로 전송됩니다. 따라서 유효한 ClickHouse SQL이어야 합니다. ClickHouse가 파싱하지 않는 SQLite 전용 구문을 전달하려면 query('...') 형식을 사용하십시오. 이 형식의 텍스트는 그대로 SQLite로 전송됩니다.전달된 쿼리로는 바깥쪽 WHERE, LIMIT, 집계 등 주변 ClickHouse 쿼리의 요소가 푸시다운되지 않습니다. 대신 전체 쿼리 결과를 가져온 후 ClickHouse에서 적용됩니다. SQLite에서 읽는 데이터를 제한하려면 필터를 전달된 쿼리 내부에 넣으십시오. external_table_strict_query = 1을 사용하면 푸시다운할 수 없는 바깥쪽 필터는 로컬에서 적용되지 않고 예외와 함께 거부됩니다.

예시

Query
Response
마지막 수정일 2026년 7월 23일