Golang轻量级NoSQL数据库解决方案：tiedot使用指南

tiedot是一个用纯Go编写的轻量级NoSQL数据库，它提供了类似MongoDB的文档存储功能，但更加轻量且易于集成到Go应用程序中。

tiedot主要特点

• 纯Go实现，无外部依赖
• 支持文档存储和查询
• 提供简单的JSON API
• 支持索引加速查询
• 嵌入式设计，无需单独服务

安装tiedot

go get github.com/HouzuoGuo/tiedot

基本使用示例

1. 创建/打开数据库

package main

import (
	"fmt"
	"github.com/HouzuoGuo/tiedot/db"
)

func main() {
	// 打开或创建数据库
	myDB, err := db.OpenDB("mydatabase")
	if err != nil {
		panic(err)
	}
	defer myDB.Close()

	// 检查数据库是否已存在某个集合
	if !myDB.ColExists("users") {
		// 创建集合(相当于表)
		if err := myDB.Create("users"); err != nil {
			panic(err)
		}
		fmt.Println("集合'users'创建成功")
	}

	// 获取集合引用
	users := myDB.Use("users")
	
	// 其他操作...
}

2. 插入文档

// 插入单个文档
docID, err := users.Insert(map[string]interface{}{
	"name":    "John Doe",
	"age":     30,
	"email":   "john@example.com",
	"active":  true,
	"hobbies": []string{"reading", "swimming"},
})
if err != nil {
	panic(err)
}
fmt.Printf("插入文档ID: %d\n", docID)

// 批量插入
docs := []map[string]interface{}{
	{"name": "Alice", "age": 25, "email": "alice@example.com"},
	{"name": "Bob", "age": 35, "email": "bob@example.com"},
}

for _, doc := range docs {
	if _, err := users.Insert(doc); err != nil {
		panic(err)
	}
}

3. 查询文档

// 查询所有文档
users.ForEach(func(id int, docContent []byte) bool {
	var doc map[string]interface{}
	if err := json.Unmarshal(docContent, &doc); err != nil {
		fmt.Println("解析文档错误:", err)
		return true // 继续迭代
	}
	fmt.Printf("ID: %d, 内容: %+v\n", id, doc)
	return true // 返回false停止迭代
})

// 按ID查询
doc, err := users.Read(docID)
if err != nil {
	panic(err)
}
fmt.Printf("按ID查询结果: %+v\n", doc)

4. 创建索引加速查询

// 为name字段创建索引
if err := users.Index([]string{"name"}); err != nil {
	panic(err)
}

// 为嵌套字段创建索引
if err := users.Index([]string{"address", "city"}); err != nil {
	panic(err)
}

5. 使用索引查询

query := map[string]interface{}{
	"eq":    "John Doe",
	"in":    []string{"name"},
}

var result []int
// 执行查询，结果存储在result中
if err := db.EvalQuery(query, users, &result); err != nil {
	panic(err)
}

fmt.Println("查询结果IDs:", result)
for _, id := range result {
	doc, _ := users.Read(id)
	fmt.Printf("ID %d: %+v\n", id, doc)
}

6. 更新和删除文档

// 更新文档
updateData := map[string]interface{}{
	"age":    31,
	"active": false,
}
if err := users.Update(docID, updateData); err != nil {
	panic(err)
}

// 删除文档
if err := users.Delete(docID); err != nil {
	panic(err)
}

高级查询示例

tiedot支持多种查询操作符：

// 范围查询
query := map[string]interface{}{
	"gt": 25,
	"lt": 40,
	"in": []string{"age"},
}

// 正则表达式查询
query := map[string]interface{}{
	"regex": "Joh.*",
	"in":    []string{"name"},
}

// 多条件AND查询
query := map[string]interface{}{
	"and": []map[string]interface{}{
		{"eq": true, "in": []string{"active"}},
		{"gt": 25, "in": []string{"age"}},
	},
}

// 多条件OR查询
query := map[string]interface{}{
	"or": []map[string]interface{}{
		{"eq": "Alice", "in": []string{"name"}},
		{"eq": "Bob", "in": []string{"name"}},
	},
}

性能优化建议

1. 为常用查询字段创建索引
2. 避免在大型集合上使用无索引查询
3. 定期压缩数据库文件(使用db.Compress)

限制和注意事项

• tiedot不适合超大规模数据(超过GB级别)
• 不支持分布式或复制功能
• 事务支持有限
• 查询功能不如专业NoSQL数据库丰富

tiedot非常适合小型到中型的Go应用程序，需要嵌入式NoSQL解决方案的场景。对于更复杂的需求，可能需要考虑MongoDB等专业数据库。