Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

SQLite

View as MarkdownEdit this pageReport an issueSet up docs MCP

支持连接到 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 列中解析：

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 │
└───────┴──────┘
Navigation