Stoolap 项目启动与配置教程

Stoolap 项目启动与配置教程

stoolap Stoolap is a high-performance, SQL database written in pure Go with zero dependencies. 项目地址: https://gitcode.com/gh_mirrors/st/stoolap

1. 项目的目录结构及介绍

Stoolap 是一个用纯 Go 语言编写的高性能 SQL 数据库，它没有任何外部依赖。以下是项目的目录结构及其简单介绍：

• cmd/stoolap: 包含项目的入口文件，用于启动数据库服务或 CLI。
• docs: 存放项目文档。
• examples: 包含使用 Stoolap 的示例代码。
• internal: 内部使用的包和工具，不对外暴露。
• pkg: 项目的主要逻辑代码，包括数据库的实现。
• .github/workflows: 包含 GitHub Actions 工作流文件，用于自动化测试和构建等。
• CONTRIBUTING.md: 指导贡献者如何向项目贡献代码。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文件，包含项目介绍和基本用法。
• go.mod: Go 项目的依赖管理文件。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/stoolap/main.go。以下是启动文件的基本内容和功能介绍：

package main

import (
    "database/sql"
    "fmt"
    "log"
    _ "github.com/stoolap/stoolap/pkg/driver"
)

func main() {
    // 连接到内存数据库
    db, err := sql.Open("stoolap", "memory://")
    if err != nil {
        log.Fatal(err)
    }
    defer db.Close()

    // 创建表
    _, err = db.Exec(`CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL, email TEXT, created_at TIMESTAMP)`)
    if err != nil {
        log.Fatal(err)
    }

    // 插入数据
    _, err = db.Exec(`INSERT INTO users (id, name, email, created_at) VALUES (1, 'John Doe', 'john@example.com', NOW())`)
    if err != nil {
        log.Fatal(err)
    }

    // 查询数据
    rows, err := db.Query("SELECT id, name, email FROM users")
    if err != nil {
        log.Fatal(err)
    }
    defer rows.Close()

    // 处理结果
    for rows.Next() {
        var id int
        var name, email string
        if err := rows.Scan(&id, &name, &email); err != nil {
            log.Fatal(err)
        }
        fmt.Printf("User: %d, %s, %s\n", id, name, email)
    }
}

这段代码演示了如何使用 Stoolap 连接到一个内存数据库，创建一个表，插入数据，并查询数据。

3. 项目的配置文件介绍

Stoolap 项目目前没有专门的配置文件。所有的配置都是通过命令行参数来指定的。例如，启动 CLI 时可以使用 -db 参数来指定数据库的存储方式：

./stoolap -db memory://  # 使用内存数据库
./stoolap -db file:///path/to/data  # 使用文件存储数据库

在实际应用中，如果需要更复杂的配置，可以通过修改源代码中的相应部分来实现自定义配置。

stoolap Stoolap is a high-performance, SQL database written in pure Go with zero dependencies. 项目地址: https://gitcode.com/gh_mirrors/st/stoolap