Golang兼容Redis客户端的嵌入式分布式内存数据库插件EchoVault的使用

什么是SugarDB?

SugarDB是一个高度可配置的、分布式的、内存数据存储和缓存，用Go语言实现。它可以作为Go库导入或作为独立服务运行。

SugarDB旨在提供丰富的数据结构和函数来操作内存中的数据。这些数据结构包括但不限于：列表、集合、有序集合、哈希等。

SugarDB提供持久化层以提高可靠性。可以使用仅追加文件和快照来将数据持久化到磁盘，以便在意外关闭时恢复。

主要特性

SugarDB提供以下特性：

1. 支持TLS和mTLS，可用于多个服务器和客户端RootCA
2. 使用RAFT算法支持复制集群
3. ACL层用于用户认证和授权
4. 分布式Pub/Sub功能
5. 集合、有序集合、哈希、列表等多种数据结构
6. 快照和仅追加文件的持久化层
7. 键淘汰策略
8. 通过共享对象文件扩展命令
9. 通过嵌入式API扩展命令
10. 通过Lua模块扩展命令
11. 通过JavaScript模块扩展命令
12. 多数据库支持，用于键命名空间

嵌入式使用示例

安装SugarDB: go get github.com/echovault/sugardb/sugardb

以下是在Go项目中使用SugarDB作为嵌入式库的示例：

package main

import (
	"fmt"
	"log"
	
	"github.com/echovault/sugardb/sugardb"
)

func main() {
	// 创建新的SugarDB实例
	server, err := sugardb.NewSugarDB()
	if err != nil {
		log.Fatal(err)
	}

	// 设置键值对
	_, _, _ = server.Set("key", "Hello, SugarDB!", sugardb.SETOptions{})

	// 获取键值
	v, _ := server.Get("key")
	fmt.Println(v) // 输出: Hello, SugarDB!

	// (可选): 在此SugarDB实例上监听TCP连接
	server.Start()
}

嵌入式SugarDB实例仍然可以是集群的一部分，通过API触发的更改将在整个集群中保持一致。

客户端-服务器模式使用

SugarDB也可以作为独立服务运行，支持多种安装方式：

Homebrew安装

1. brew tap echovault/sugardb
2. brew install echovault/echovault/sugardb

安装后，可以使用以下命令运行服务器： sugardb --bind-addr=localhost --data-dir="path/to/persistence/directory"

Docker安装

docker pull echovault/sugardb

容器注册表

docker pull ghcr.io/echovault/sugardb

二进制文件

可以从发布页面下载适合您系统的二进制文件。

客户端兼容性

SugarDB使用RESP协议，使其与现有的Redis客户端兼容。您可以使用任何标准的Redis客户端库来连接SugarDB服务器。

完整示例

以下是一个更完整的示例，展示了如何使用SugarDB的各种功能：

package main

import (
	"fmt"
	"log"
	"time"

	"github.com/echovault/sugardb/sugardb"
)

func main() {
	// 1. 创建SugarDB实例
	db, err := sugardb.NewSugarDB()
	if err != nil {
		log.Fatal(err)
	}

	// 2. 基本键值操作
	db.Set("username", "john_doe", sugardb.SETOptions{})
	val, _ := db.Get("username")
	fmt.Println("Username:", val)

	// 3. 设置过期时间
	db.Set("temp_key", "expires_soon", sugardb.SETOptions{ExpireAt: time.Now().Add(1 * time.Minute)})
	ttl, _ := db.TTL("temp_key")
	fmt.Println("TTL:", ttl)

	// 4. 哈希操作
	db.HSet("user:1000", map[string]string{
		"name":  "John Doe",
		"email": "john@example.com",
	}, sugardb.HSETOptions{})
	user, _ := db.HGetAll("user:1000")
	fmt.Println("User:", user)

	// 5. 列表操作
	db.LPush("messages", []string{"msg1", "msg2", "msg3"}, sugardb.LPUSHOptions{})
	messages, _ := db.LRange("messages", 0, -1)
	fmt.Println("Messages:", messages)

	// 6. 集合操作
	db.SAdd("tags", []string{"golang", "database", "redis"}, sugardb.SADDOptions{})
	tags, _ := db.SMembers("tags")
	fmt.Println("Tags:", tags)

	// 7. 启动服务器(可选)
	// db.Start()
}

这个示例展示了SugarDB的主要功能，包括基本键值存储、哈希、列表和集合操作。您可以根据需要扩展这个示例来使用更多高级功能。