语法
参数
db_path— SQLite 数据库文件的路径。String。table_name— SQLite 数据库中的表名，或按原样传递给 SQLite 的查询 (参见传递查询而不是表名) 。String。
返回值
- 一个表对象，其列与原始
SQLite表的列相同。
传递查询而非表名
第二个参数可以不是表名，而是一个SELECT 查询，该查询会原样传递给 SQLite。结果表的结构根据查询结果推断。SQLite 仅在结果列直接对应某个表的列时才报告其声明类型；对于表达式、字面量或聚合，则不报告任何类型。映射为 String 的声明类型 (参见类型映射) 将原样使用。没有声明类型的列根据查询结果第一行中该列值的存储类来确定类型：INTEGER 值对应 Int64，REAL 值对应 Float64，其他任何值 (TEXT、BLOB、NULL) 以及空结果均对应 String。数值型声明类型同样要根据第一行进行校验，这是因为 SQLite 也会为复合 SELECT 报告声明类型，而该类型取自其中某一个分支，行数据却来自所有分支。当该值的存储类与声明类型相符时 (整数类型对应 INTEGER，浮点类型对应 INTEGER 或 REAL) ，保留该声明类型；当该值为 NULL 或结果为空时，同样予以保留，因为二者都不携带任何可能与之矛盾的类型信息；否则，该列将与未声明类型的列一样，根据存储类确定类型。因此，推断出的类型只会放宽，绝不会收窄。推断此类列时，会在 SQLite 中启动该查询。第一行并不能代表其余各行：SQLite 可以在每一行返回不同的存储类 (例如 CASE WHEN id = 1 THEN 1 ELSE 1.5 END) ，因此对于以数值类型读取的每一列，基于查询的读取都采用失败即关闭 (fail-closed) 策略——而不仅限于没有声明类型的列。如果某个值的存储类与该类型不匹配，或无法用该类型精确表示 (例如 UInt8 列中值为 300 的 INTEGER 单元，或 Float32 列中值为 16777217 的 REAL 单元) ，读取将直接失败，而不会进行静默强制转换。若要读取存储类混杂的列，请将其声明为 String，或在 SQLite 查询中将其转换为文本。所有推断出的列均为 Nullable。查询既可以写成子查询，也可以包装在 query 函数中：
SELECT ... FROM (<query>)，再发送给 SQLite，因此查询不能以分号结尾。
此类表为只读表，不允许对其执行 INSERT。SQLite 表引擎也支持相同的语法。
子查询形式
(SELECT ...) 会由 ClickHouse 解析，并在发送到 SQLite 之前重新序列化。因此，它必须是有效的 ClickHouse SQL。若要传递 ClickHouse 无法解析的 SQLite 特有语法，请使用 query('...') 形式，其文本会原样发送给 SQLite。外层 ClickHouse 查询中的任何 WHERE、LIMIT、聚合等，都不会下推到传入的查询中——而是在拉取完整查询结果后由 ClickHouse 再应用。要限制从 SQLite 读取的数据，请将过滤器放在传入的查询内部。启用 external_table_strict_query = 1 时，无法下推的外层过滤器会直接以异常拒绝，而不是在本地应用。该设置会拒绝表函数列上的外层过滤器，因为此类过滤器无法下推到传入的查询中。检查范围包括顶层 WHERE 谓词及顶层 AND 的每个合取项。对此表列使用 PREWHERE 不属于该设置的适用情形：此表引擎不支持 PREWHERE，无论该设置为何值，此类查询都会因 ILLEGAL_PREWHERE 被拒绝。仅在过滤器可能下推的场景下才会执行检查：此表是查询中唯一的表、位于 INNER JOIN 的任一侧，或位于外连接的保留侧 (LEFT JOIN 的左侧、RIGHT JOIN 的右侧) 。在 LEFT/RIGHT JOIN 的非保留侧及 FULL JOIN 的任一侧，既不会下推任何内容，也不会执行检查。因此，即使在严格模式下，此表列上的过滤器也会在连接后于本地应用。在执行检查的场景中，引用周围查询内其他已连接表的谓词不会被下推，也不纳入检查；无论该谓词仅引用连接侧，还是在单个非 AND 表达式中同时引用连接侧和此表 (例如 OR) 。此类谓词会保留其通常的 ClickHouse 求值位置 (连接后的 WHERE、连接前的 PREWHERE) ，不会被拒绝。示例
Query
Response
相关
- SQLite 表引擎
- SQLite 数据库引擎 — 数据类型支持部分