SQLite

支持连接到 SQLite 数据库，并执行 INSERT 和 SELECT 查询，以在 ClickHouse 与 SQLite 之间交换数据。

支持连接到 SQLite 数据库，并执行 INSERT 和 SELECT 查询，以在 ClickHouse 与 SQLite 之间交换数据。

​

创建数据库

    CREATE DATABASE sqlite_database
    ENGINE = SQLite('db_path')

引擎参数

• db_path — SQLite 数据库文件路径。

​

数据类型支持

下表展示了 ClickHouse 从 SQLite 自动推断 schema 时的默认类型映射：

SQLite	ClickHouse
INTEGER	Int32
REAL	Float32
TEXT	String
TEXT	UUID
BLOB	String

当你使用 SQLite 表引擎 显式定义采用特定 ClickHouse 类型的表时，以下 ClickHouse 类型可从 SQLite 的 TEXT 列中解析：

• Date, Date32
• DateTime, DateTime64
• UUID
• Enum8, Enum16
• Decimal32, Decimal64, Decimal128, Decimal256
• FixedString
• 所有整数类型 (UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64)
• Float32, Float64

SQLite 采用动态类型，其类型访问函数会自动执行类型强制转换。例如，将 TEXT 列按整数读取时，如果文本无法解析为数字，则会返回 0。这意味着，如果 ClickHouse 表定义的类型与底层 SQLite 列的类型不同，值可能会被静默强制转换，而不会报错。

​

具体细节与建议

SQLite 将整个数据库 (定义、表、索引以及数据本身) 存储为主机上的单个跨平台文件。写入时，SQLite 会锁定整个数据库文件，因此写操作只能顺序执行；读操作则可以并行进行。 SQLite 不需要服务管理 (如启动脚本) ，也不需要基于 GRANT 和密码的访问控制。访问控制是通过赋予数据库文件本身相应的文件系统权限来实现的。

​

使用示例

ClickHouse 中连接到 SQLite 的数据库：

CREATE DATABASE sqlite_db ENGINE = SQLite('sqlite.db');
SHOW TABLES FROM sqlite_db;

┌──name───┐
│ table1  │
│ table2  │
└─────────┘

显示以下表：

SELECT * FROM sqlite_db.table1;

┌─col1──┬─col2─┐
│ line1 │    1 │
│ line2 │    2 │
│ line3 │    3 │
└───────┴──────┘

将 ClickHouse 表中的数据插入 SQLite 表：

CREATE TABLE clickhouse_table(`col1` String,`col2` Int16) ENGINE = MergeTree() ORDER BY col2;
INSERT INTO clickhouse_table VALUES ('text',10);
INSERT INTO sqlite_db.table1 SELECT * FROM clickhouse_table;
SELECT * FROM sqlite_db.table1;

┌─col1──┬─col2─┐
│ line1 │    1 │
│ line2 │    2 │
│ line3 │    3 │
│ text  │   10 │
└───────┴──────┘