> ## 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 导出数据，并支持直接从 ClickHouse 查询 SQLite 表。
# SQLite 表引擎
export const CloudNotSupportedBadge = () => {
return ;
};
该引擎支持将数据导入到 SQLite 和从 SQLite 导出数据，也支持直接从 ClickHouse 查询 SQLite 表。
## 创建表
```sql theme={null}
CREATE TABLE [IF NOT EXISTS] [db.]table_name
(
name1 [type1],
name2 [type2], ...
) ENGINE = SQLite('db_path', 'table')
```
**引擎参数**
* `db_path` — SQLite 数据库文件的路径。
* `table` — SQLite 数据库中的表名，或原样传递给 SQLite 的查询 (请参见[传递查询而非表名](#passing-a-query)) 。
## 传入查询而非表名
`table` 参数不一定非得是表名，也可以是一个原样传递给 SQLite 的 `SELECT` 查询。表的结构将根据查询结果自动推断。该查询既可以写成子查询，也可以封装在 `query` 函数中：
```sql theme={null}
CREATE TABLE sqlite_table ENGINE = SQLite('sqlite.db', (SELECT col1, col2 FROM table1 WHERE col2 > 1));
CREATE TABLE sqlite_table ENGINE = SQLite('sqlite.db', query('SELECT col1, col2 FROM table1 WHERE col2 > 1'));
```
这样的表是只读的：不允许向其中执行 `INSERT`。[`sqlite`](/docs/zh/reference/functions/table-functions/sqlite) 表函数也支持相同的语法。
子查询形式 `(SELECT ...)` 会先由 ClickHouse 解析并重新序列化，再发送给 SQLite。因此，它必须是有效的 ClickHouse SQL。若要传递 ClickHouse 无法解析的 SQLite 特有语法，请使用 `query('...')` 形式，其文本会原样发送给 SQLite。
周围 ClickHouse 查询中的任何外层 `WHERE`、`LIMIT`、聚合等**都不会**下推到传入的查询中——而是会在拉取完整查询结果后由 ClickHouse 应用。若要限制从 SQLite 读取的数据，请将过滤条件放在传入的查询内部。启用 [`external_table_strict_query = 1`](/docs/zh/reference/settings/session-settings#external_table_strict_query) 时，无法下推的外层过滤条件会直接报错拒绝，而不是在本地应用。
## 数据类型支持
当在表定义中显式指定 ClickHouse 列类型时，可从 SQLite 的 TEXT 列中解析出以下 ClickHouse 类型：
* [Date](/docs/zh/reference/data-types/date), [Date32](/docs/zh/reference/data-types/date32)
* [DateTime](/docs/zh/reference/data-types/datetime), [DateTime64](/docs/zh/reference/data-types/datetime64)
* [UUID](/docs/zh/reference/data-types/uuid)
* [Enum8, Enum16](/docs/zh/reference/data-types/enum)
* [Decimal32, Decimal64, Decimal128, Decimal256](/docs/zh/reference/data-types/decimal)
* [FixedString](/docs/zh/reference/data-types/fixedstring)
* 所有整数类型 ([UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64](/docs/zh/reference/data-types/int-uint))
* [Float32, Float64](/docs/zh/reference/data-types/float)
有关默认类型映射，请参见 [SQLite database engine](/docs/zh/reference/engines/database-engines/sqlite#data_types-support)。
## 使用示例
显示创建 SQLite 表的查询：
```sql theme={null}
SHOW CREATE TABLE sqlite_db.table2;
```
```text theme={null}
CREATE TABLE SQLite.table2
(
`col1` Nullable(Int32),
`col2` Nullable(String)
)
ENGINE = SQLite('sqlite.db','table2');
```
返回该表中的数据：
```sql theme={null}
SELECT * FROM sqlite_db.table2 ORDER BY col1;
```
```text theme={null}
┌─col1─┬─col2──┐
│ 1 │ text1 │
│ 2 │ text2 │
│ 3 │ text3 │
└──────┴───────┘
```
**另请参见**
* [SQLite](/docs/zh/reference/engines/database-engines/sqlite) 引擎
* [sqlite](/docs/zh/reference/functions/table-functions/sqlite) 表函数