> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

# sqlite

[SQLite](/docs/ko/reference/engines/database-engines/sqlite) 데이터베이스에 저장된 데이터를 쿼리할 수 있습니다.

<div id="syntax">
  ## 구문
</div>

```sql theme={null}
sqlite('db_path', 'table_name')
```

<div id="arguments">
  ## 인수
</div>

* `db_path` — SQLite 데이터베이스가 있는 파일의 경로입니다. [String](/docs/ko/reference/data-types/string).
* `table_name` — SQLite 데이터베이스의 테이블 이름 또는 SQLite에 그대로 전달할 쿼리입니다([테이블 이름 대신 쿼리 전달](#passing-a-query) 참조). [String](/docs/ko/reference/data-types/string).

<div id="returned_value">
  ## 반환 값
</div>

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

<div id="passing-a-query">
  ## 테이블 이름 대신 쿼리 전달하기
</div>

테이블 이름 대신 두 번째 인수로 SQLite에 그대로 전달되는 `SELECT` 쿼리를 사용할 수 있습니다. 결과로 생성되는 테이블의 구조는 쿼리 결과로부터 추론됩니다. 쿼리는 서브쿼리로 작성하거나 `query` 함수로 감싸 작성할 수 있습니다:

```sql theme={null}
SELECT * FROM sqlite('sqlite.db', (SELECT col1, col2 FROM table1 WHERE col2 > 1));
SELECT * FROM sqlite('sqlite.db', query('SELECT col1, col2 FROM table1 WHERE col2 > 1'));
```

이러한 테이블은 읽기 전용이므로 여기에 `INSERT`할 수 없습니다. 동일한 구문이 [`SQLite`](/docs/ko/reference/engines/table-engines/integrations/sqlite) 테이블 엔진에서도 지원됩니다.

<Note>
  서브쿼리(subquery) 형식인 `(SELECT ...)`는 ClickHouse에서 파싱된 후 다시 직렬화되어 SQLite로 전송됩니다. 따라서 유효한 ClickHouse SQL이어야 합니다. ClickHouse가 파싱하지 않는 SQLite 전용 구문을 전달하려면 `query('...')` 형식을 사용하십시오. 이 형식의 텍스트는 그대로 SQLite로 전송됩니다.

  전달된 쿼리로는 바깥쪽 `WHERE`, `LIMIT`, 집계 등 주변 ClickHouse 쿼리의 요소가 **푸시다운되지 않습니다**. 대신 전체 쿼리 결과를 가져온 후 ClickHouse에서 적용됩니다. SQLite에서 읽는 데이터를 제한하려면 필터를 전달된 쿼리 내부에 넣으십시오. [`external_table_strict_query = 1`](/docs/ko/reference/settings/session-settings#external_table_strict_query)을 사용하면 푸시다운할 수 없는 바깥쪽 필터는 로컬에서 적용되지 않고 예외와 함께 거부됩니다.
</Note>

<div id="example">
  ## 예시
</div>

```sql title="Query" theme={null}
SELECT * FROM sqlite('sqlite.db', 'table1') ORDER BY col2;
```

```text title="Response" theme={null}
┌─col1──┬─col2─┐
│ line1 │    1 │
│ line2 │    2 │
│ line3 │    3 │
└───────┴──────┘
```

<div id="related">
  ## 관련
</div>

* [SQLite](/docs/ko/reference/engines/table-engines/integrations/sqlite) 테이블 엔진
* [SQLite 데이터베이스 엔진](/docs/ko/reference/engines/database-engines/sqlite) — 데이터 타입 지원 섹션