SQLToy 项目教程

2025-04-17 16:52:36作者：曹令琨Iris

1. 项目介绍

SQLToy 是一个用 JavaScript 编写的内存中的 SQL 数据库。它只有不到 500 行代码，没有任何外部依赖。SQLToy 支持以下 SQL 操作：

SELECT
FROM
CROSS JOIN
INNER JOIN
LEFT JOIN
RIGHT JOIN
WHERE
GROUP BY
聚合函数：ARRAY_AGG, MAX, MIN, COUNT
DISTINCT
ORDER BY
OFFSET
LIMIT
CREATE TABLE
INSERT INTO
UPDATE

SQLToy 的目的是为了学习 SQL。它不是从外部开始学习查询语言，而是通过实现最常见 SQL 操作的内部机制来学习。这样不仅可以了解操作做什么，还能学习它是如何实现的，这可以提供更深层次的理解。

2. 项目快速启动

首先，确保你的环境中安装了 Node.js。然后，可以通过以下步骤启动 SQLToy 项目：

# 克隆项目
git clone https://github.com/weinberg/SQLToy.git

# 进入项目目录
cd SQLToy

# 安装项目依赖（尽管 SQLToy 没有外部依赖，这一步是为了演示过程）
npm install

# 运行示例代码（假设示例代码已经存在于项目中）
node example.js

上述步骤假设项目中有名为 example.js 的示例脚本，你可以根据实际的项目结构进行相应的调整。

3. 应用案例和最佳实践

下面是一个使用 SQLToy 的简单案例，演示了如何进行数据的插入、查询和展示：

// 创建表
const createTable = `
CREATE TABLE employee (
  id INT,
  name VARCHAR(100),
  salary INT,
  status VARCHAR(20)
);
`;

// 插入数据
const insertData = `
INSERT INTO employee (id, name, salary, status) VALUES
(1, 'Alice', 90000, 'active'),
(2, 'Bob', 70000, 'inactive'),
(3, 'Charlie', 120000, 'active');
`;

// 查询数据
const queryData = `
SELECT name, salary, status FROM employee WHERE salary > 80000;
`;

// 假设以下函数是 SQLToy 提供的 API
executeQuery(createTable);
executeQuery(insertData);
const result = executeQuery(queryData);

// 展示数据
console.log(result);