que-go 项目教程

que-go 项目教程

que-goUNMAINTAINED: An interoperable Golang port of the Ruby Que queuing library for PostgreSQL. Use River instead.项目地址:https://gitcode.com/gh_mirrors/qu/que-go

1、项目介绍

que-go 是一个完全兼容的 Golang 端口，基于 Chris Hanks 的 Ruby Que 队列库，用于 PostgreSQL。Que 使用 PostgreSQL 的咨询锁来实现速度和可靠性。由于 que-go 是 Que 的兼容端口，你可以在 Ruby 中（例如从 Rails 应用）排队作业，并使用 Go 编写你的工作者。或者，如果你有一组有限的作业想要用 Go 编写，你可以保留大部分 Ruby 工作者，只在不同的队列名称上添加一些 Go 工作者。或者你可以完全用 Go 编写所有内容。

2、项目快速启动

安装

首先，确保你已经安装了 Go 和 PostgreSQL。然后，使用以下命令安装 que-go：

go get github.com/bgentry/que-go

初始化数据库

在你的 PostgreSQL 数据库中运行以下 SQL 脚本以初始化 Que 所需的表：

CREATE TABLE que_jobs
(
  priority    smallint    NOT NULL DEFAULT 100,
  run_at      timestamptz NOT NULL DEFAULT now(),
  job_id      bigserial   NOT NULL,
  job_class   text        NOT NULL,
  args        json        NOT NULL DEFAULT '[]'::json,
  error_count integer     NOT NULL DEFAULT 0,
  CONSTRAINT que_jobs_pkey PRIMARY KEY (priority, run_at, job_id)
);

编写你的第一个作业

创建一个 Go 文件，例如 main.go，并添加以下代码：

package main

import (
  "log"
  "github.com/bgentry/que-go"
  "github.com/jackc/pgx/v4"
)

func main() {
  // 连接到 PostgreSQL 数据库
  pgxConn, err := pgx.Connect(context.Background(), "postgres://username:password@localhost:5432/dbname")
  if err != nil {
    log.Fatalf("Unable to connect to database: %v\n", err)
  }
  defer pgxConn.Close(context.Background())

  // 创建 Que 客户端
  qc := que.NewClient(pgxConn)

  // 创建一个作业
  job := &que.Job{
    Type: "ExampleJob",
    Args: []byte(`{"message": "Hello, World!"}`),
  }

  // 将作业加入队列
  err = qc.Enqueue(job)
  if err != nil {
    log.Fatalf("Unable to enqueue job: %v\n", err)
  }

  log.Println("Job enqueued successfully!")
}

运行你的应用

使用以下命令运行你的应用：

go run main.go

3、应用案例和最佳实践

应用案例

• 混合语言环境：在一个 Rails 应用中排队作业，并使用 Go 工作者处理这些作业。
• 性能优化：在需要高性能的场景中，使用 Go 工作者替换部分 Ruby 工作者。

最佳实践

• 错误处理：确保在工作者中正确处理错误，以避免作业失败后无限重试。
• 优先级设置：根据作业的紧急程度设置不同的优先级。
• 并发控制：合理设置工作者的并发数，以平衡性能和资源消耗。

4、典型生态项目

• pgx：que-go 使用的 PostgreSQL 驱动，提供更好的性能和功能。
• Go 生态系统：结合其他 Go 库和工具，如 Gin、GORM 等，构建完整的应用。

通过以上步骤，你可以快速启动并使用 que-go 项目，结合实际应用案例和最佳实践，构建高效可靠的作业队列系统。

que-goUNMAINTAINED: An interoperable Golang port of the Ruby Que queuing library for PostgreSQL. Use River instead.项目地址:https://gitcode.com/gh_mirrors/qu/que-go