SQL Jobber 项目教程

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

SQL Jobber 项目的目录结构如下：

sql-jobber/
├── cmd/
│   ├── server/
│   │   └── main.go
│   └── worker/
│       └── main.go
├── config/
│   └── config.yaml
├── internal/
│   ├── broker/
│   ├── job/
│   ├── queue/
│   └── result/
├── tasks/
│   └── example_task.sql
├── README.md
└── go.mod

目录结构介绍

• cmd/: 包含项目的启动文件，分为 server 和 worker 两个子目录，分别对应服务端和 worker 端的启动文件。
• config/: 包含项目的配置文件 config.yaml，用于配置数据库连接、队列设置等。
• internal/: 包含项目的内部逻辑实现，如 broker、job、queue 和 result 等模块。
• tasks/: 包含项目的 SQL 任务文件，如 example_task.sql，定义了需要执行的 SQL 查询。
• README.md: 项目的说明文档，包含项目的基本介绍、安装和使用说明。
• go.mod: Go 模块文件，定义了项目的依赖关系。

2. 项目的启动文件介绍

服务端启动文件

位于 cmd/server/main.go，主要功能是启动 HTTP 服务，接收并处理客户端的请求，将任务分发到队列中。

package main

import (
    "log"
    "net/http"
    "github.com/knadh/sql-jobber/internal/server"
)

func main() {
    s := server.NewServer()
    log.Fatal(http.ListenAndServe(":6060", s))
}

Worker 端启动文件

位于 cmd/worker/main.go，主要功能是启动 worker 进程，从队列中获取任务并执行。

package main

import (
    "log"
    "github.com/knadh/sql-jobber/internal/worker"
)

func main() {
    w := worker.NewWorker()
    log.Fatal(w.Run())
}

3. 项目的配置文件介绍

配置文件位于 config/config.yaml，包含了项目运行所需的各种配置项。

database:
  driver: "postgres"
  dsn: "user=postgres password=postgres dbname=mydb sslmode=disable"

queue:
  broker: "redis"
  dsn: "redis://localhost:6379/0"

server:
  port: 6060

worker:
  concurrency: 10

配置项介绍

• database: 数据库配置，包括数据库驱动类型 (driver) 和连接字符串 (dsn)。
• queue: 队列配置，包括队列的 broker 类型 (broker) 和连接字符串 (dsn)。
• server: 服务端配置，包括服务端监听的端口 (port)。
• worker: worker 配置，包括 worker 的并发数 (concurrency)。

通过以上配置，可以灵活地调整 SQL Jobber 项目的运行参数，以适应不同的环境和需求。