Apache Quickstep 技术文档

1. 安装指南

1.1 克隆代码

首先，从 Apache 的代码库中克隆 Quickstep 代码：

git clone https://git-wip-us.apache.org/repos/asf/incubator-quickstep.git quickstep

1.2 初始化依赖

进入代码目录，并初始化子模块依赖：

cd quickstep
git submodule init

1.3 检出依赖

检出所有依赖项并应用必要的补丁：

git submodule update
cd third_party && ./download_and_patch_prerequisites.sh && cd ..

1.4 编译

进入构建目录，创建 Makefile 并编译：

cd build
cmake -D CMAKE_BUILD_TYPE=Release ..
make -j4

注：-j4 参数可根据你的 CPU 核心数进行调整。

2. 使用说明

启动 Quickstep CLI Shell 并初始化数据库：

./quickstep_cli_shell --initialize_db=true

此时，你可以开始执行 SQL 查询。要退出 Quickstep，可以输入：

quit;

初始化后，数据库文件将存储在 qsstor 目录下。下次启动时，可以省略 --initialize_db 参数，直接使用：

./quickstep_cli_shell

3. 项目API使用文档

Quickstep 目前支持的 SQL 表面较小，但会随着时间的推移而增长。目前支持的包括基本的 CREATE TABLE 和 SELECT 语句。支持的数据类型包括：INTEGER、FLOAT、DOUBLE、VARCHAR、CHAR、DATE 和 DATETIME。Quickstep 尚不支持 NULL 值或键。

以下是一些示例 SQL 语句：

3.1 创建表

CREATE TABLE Weather (cid INTEGER, recordDate DATE, highTemperature FLOAT, lowTemperature FLOAT);
CREATE TABLE City (cid INTEGER, name VARCHAR(80), state CHAR(2));

3.2 插入数据

INSERT INTO City VALUES (1, 'Madison', 'WI');
INSERT INTO City VALUES (2, 'Palo Alto', 'CA');
INSERT INTO Weather VALUES (1, '2015-11-1', 50, 30);
INSERT INTO Weather VALUES (1, '2015-11-2', 51, 32);
INSERT INTO Weather VALUES (2, '2015-11-1', 60, 50);

3.3 查询

3.3.1 查询所有加州的天气记录

SELECT * FROM Weather W, City C WHERE C.cid = W.cid AND C.state = 'CA';

3.3.2 查询每个城市的最高和最低温度

SELECT cid, MIN(lowTemperature), MAX(highTemperature) FROM Weather GROUP BY cid;

3.3.3 使用嵌套查询查询每个城市的最高和最低温度，并打印城市名称

SELECT * FROM City C, (SELECT cid, MIN(lowTemperature), MAX(highTemperature) FROM Weather GROUP BY cid) AS T WHERE C.cid = T.cid;

3.4 数据导入

Quickstep 还支持 COPY TABLE 命令。以下是一个示例：

首先，在一个单独的 shell 文件中创建数据文件：

echo "3|2015-11-3|49|29" > /tmp/tmp.tbl
echo "3|2015-11-4|48|28" >> /tmp/tmp.tbl
echo "3|2015-11-5|47|27" >> /tmp/tmp.tbl

然后，在 Quickstep shell 中加载数据：

COPY Weather FROM '/tmp/tmp.tbl' WITH (DELIMITER '|');

现在，Weather 表中已加载更多数据，可以再次执行上述 SQL 查询。

4. 安装方式

请参考以下文档以获取更多关于构建和开发的信息：

• 构建指南
• 代码组织指南

Quickstep 使用 Apache License, Version 2.0 许可。有关完整许可文本，请见 LICENSE。