- 安装
- 文档
- 入门
- 连接
- 数据导入
- 客户端 API
- 概览
- ADBC
- C
- C++
- CLI
- Dart
- Go
- Java (JDBC)
- Julia
- Node.js (已弃用)
- Node.js (Neo)
- ODBC
- PHP
- Python
- R
- Rust
- Swift
- Wasm
- SQL
- 介绍
- 语句
- 概览
- ANALYZE
- ALTER TABLE
- ALTER VIEW
- ATTACH 和 DETACH
- CALL
- CHECKPOINT
- COMMENT ON
- COPY
- CREATE INDEX
- CREATE MACRO
- CREATE SCHEMA
- CREATE SECRET
- CREATE SEQUENCE
- CREATE TABLE
- CREATE VIEW
- CREATE TYPE
- DELETE
- DESCRIBE
- DROP
- EXPORT 和 IMPORT DATABASE
- INSERT
- LOAD / INSTALL
- PIVOT
- 性能分析
- SELECT
- SET / RESET
- SET VARIABLE
- SUMMARIZE
- 事务管理
- UNPIVOT
- UPDATE
- USE
- VACUUM
- 查询语法
- SELECT
- FROM 和 JOIN
- WHERE
- GROUP BY
- GROUPING SETS
- HAVING
- ORDER BY
- LIMIT 和 OFFSET
- SAMPLE
- 展开嵌套
- WITH
- WINDOW
- QUALIFY
- VALUES
- FILTER
- 集合操作
- 预处理语句
- 数据类型
- 表达式
- 函数
- 概览
- 聚合函数
- 数组函数
- 位字符串函数
- Blob 函数
- 日期格式化函数
- 日期函数
- 日期部分函数
- 枚举函数
- 间隔函数
- Lambda 函数
- 列表函数
- 映射函数
- 嵌套函数
- 数值函数
- 模式匹配
- 正则表达式
- 结构体函数
- 文本函数
- 时间函数
- 时间戳函数
- 带时区时间戳函数
- 联合函数
- 实用函数
- 窗口函数
- 约束
- 索引
- 元查询
- DuckDB 的 SQL 方言
- 示例
- 配置
- 扩展
- 核心扩展
- 概览
- 自动补全
- Avro
- AWS
- Azure
- Delta
- DuckLake
- 编码
- Excel
- 全文搜索
- httpfs (HTTP 和 S3)
- Iceberg
- ICU
- inet
- jemalloc
- MySQL
- PostgreSQL
- 空间
- SQLite
- TPC-DS
- TPC-H
- UI
- VSS
- 指南
- 概览
- 数据查看器
- 数据库集成
- 文件格式
- 概览
- CSV 导入
- CSV 导出
- 直接读取文件
- Excel 导入
- Excel 导出
- JSON 导入
- JSON 导出
- Parquet 导入
- Parquet 导出
- 查询 Parquet 文件
- 使用 file: 协议访问文件
- 网络和云存储
- 概览
- HTTP Parquet 导入
- S3 Parquet 导入
- S3 Parquet 导出
- S3 Iceberg 导入
- S3 Express One
- GCS 导入
- Cloudflare R2 导入
- 通过 HTTPS / S3 使用 DuckDB
- Fastly 对象存储导入
- 元查询
- ODBC
- 性能
- Python
- 安装
- 执行 SQL
- Jupyter Notebooks
- marimo Notebooks
- Pandas 上的 SQL
- 从 Pandas 导入
- 导出到 Pandas
- 从 Numpy 导入
- 导出到 Numpy
- Arrow 上的 SQL
- 从 Arrow 导入
- 导出到 Arrow
- Pandas 上的关系型 API
- 多个 Python 线程
- 与 Ibis 集成
- 与 Polars 集成
- 使用 fsspec 文件系统
- SQL 编辑器
- SQL 功能
- 代码片段
- 故障排除
- 术语表
- 离线浏览
- 操作手册
- 开发
- 内部结构
- 为什么选择 DuckDB
- 行为准则
- 发布日历
- 路线图
- 站点地图
- 在线演示
测试的目的是找出系统何时出现故障。不可避免地,对系统所做的更改将导致其中一个测试失败,届时该测试需要进行调试。
首先,始终建议在调试模式下运行。这可以通过使用命令make debug
编译系统来完成。其次,建议只运行出现故障的测试。这可以通过将故障测试的文件名作为命令行参数传递给测试套件来完成(例如,build/debug/test/unittest test/sql/projection/test_simple_projection.test
)。有关运行部分测试的更多选项,请参阅触发哪些测试运行部分。
之后,可以将调试器附加到程序上并对测试进行调试。在sqllogictests中,通常很难在特定查询处设置断点,但是,我们已经扩展了测试套件,使得每次运行查询时,都会调用一个名为query_break
的函数,并以行号line
作为参数。这允许您在特定查询上设置条件断点。例如,如果我们要中断测试文件中的第43行,我们可以创建以下断点
gdb: break query_break if line==43
lldb: break s -n query_break -c line==43
您还可以通过在文件中放置mode skip
,后跟可选的mode unskip
来跳过某些查询的执行。这两个语句之间的任何查询都不会被执行。
触发哪些测试运行
运行unittest程序时,默认会运行所有快速测试。可以通过将测试名称作为参数来运行特定测试。对于sqllogictests,这是测试文件的相对路径。要只运行一个测试
build/debug/test/unittest test/sql/projection/test_simple_projection.test
通过将目录作为带方括号的参数提供,可以执行给定目录中的所有测试。要在“projection”目录中运行所有测试
build/debug/test/unittest "[projection]"
所有测试,包括慢速测试,都可以通过使用星号运行测试来执行。要运行所有测试,包括慢速测试
build/debug/test/unittest "*"
我们可以使用--start-offset
和--end-offset
参数运行部分测试。要运行测试200..250
build/debug/test/unittest --start-offset=200 --end-offset=250
这些也以百分比形式可用。要运行10% - 20%的测试
build/debug/test/unittest --start-offset-percentage=10 --end-offset-percentage=20
要运行的测试集也可以从包含每行一个测试名称的文件中加载,并使用-f
命令加载。
cat test.list
test/sql/join/full_outer/test_full_outer_join_issue_4252.test
test/sql/join/full_outer/full_outer_join_cache.test
test/sql/join/full_outer/test_full_outer_join.test
要只运行文件中标记的测试
build/debug/test/unittest -f test.list