sqlite - ClickHouse Documentation

可对存储在 SQLite 数据库中的数据进行查询。

语法

sqlite('db_path', 'table_name')

参数

db_path — SQLite 数据库文件的路径。String。
table_name — SQLite 数据库中的表名，或按原样传递给 SQLite 的查询 (参见传递查询而不是表名) 。String。

返回值

一个表对象，其列与原始 SQLite 表的列相同。

传递查询而非表名

第二个参数不一定非得是表名，也可以是一个原样传递给 SQLite 的 SELECT 查询。结果表的结构会根据查询结果自动推断。该查询既可以写成子查询，也可以封装在 query 函数中：

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 表引擎也支持相同的语法。

子查询形式 (SELECT ...) 会由 ClickHouse 解析，并在发送到 SQLite 之前重新序列化。因此，它必须是有效的 ClickHouse SQL。若要传递 ClickHouse 无法解析的 SQLite 特有语法，请使用 query('...') 形式，其文本会原样发送给 SQLite。外层 ClickHouse 查询中的任何 WHERE、LIMIT、聚合等，都不会下推到传入的查询中——而是在拉取完整查询结果后由 ClickHouse 再应用。要限制从 SQLite 读取的数据，请将过滤器放在传入的查询内部。启用 external_table_strict_query = 1 时，无法下推的外层过滤器会直接以异常拒绝，而不是在本地应用。

示例

Query

SELECT * FROM sqlite('sqlite.db', 'table1') ORDER BY col2;

Response

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

SQLite 表引擎
SQLite 数据库引擎 — 数据类型支持部分

最后修改于 2026年7月23日

timeSeriesDatatimeSeriesData 返回表引擎为 TimeSeries 的表 `db_name.time_series_table` 所使用的[数据](/reference/engines/table-engines/integrations/time-series#samples-table)表。

​语法

​参数

​返回值

​传递查询而非表名

​示例

​相关

语法

参数

返回值

传递查询而非表名

示例

相关