imicola PostgreSQL最小持久化
PostgreSQL最小持久化

PostgreSQL最小持久化

474 字 · 约 1 分钟

对于一个后端程序,需要链接数据库,而CRUD也有在数据库层面上进行的内容,本文的目标就是,不仅仅将 HTTP 的CRUD局限在内存与 go 语言操作中,而是去操作PostgreSQL

核心接口

实际上,完成对 PostgreSQL 的操作,我们需要使用 pgx 和 database/sql

主要使用的接口是

query := `SELECT id, name, address
		  FROM targets
		WHERE id = $1`
row := store.db.QueryRowContext(ctx, query, id)
err := row.Scan(&target.Id, &target.Name, &target.Addr)
	if errors.Is(err, sql.ErrNoRows) {
		return Target{}, ErrTargetNotFound
	}
go

其中 query 就是我们的SQL语句,需要注意的是SQL语句这里需要写返回值和使用 $1,$2来代表传入的参数

下面的 QueryRowContext 则表示进行一次SQL操作,ctx是一个中断 context , query 表示要查询的 SQL 语句,同时后面接需要传入的参数

这个函数会返回一个 sql.Row ,即这个row,我们需要使用用它的方法 Scan 来将 SQL 中返回的数据存入内存中,注意,如果SQL没有找到对应的行,这会返回一个 sql.ErrNoRows,我们需要接住它并且返回一个对外的显式错误ErrTargetNotFound

测试

测试这里首先需要注意的是,我们需要在测试这里单独打开和数据库的链接,注册store

func registerStore(t *testing.T) *PostgresStore {
	t.Helper()
	if os.Getenv("RUN_POSTGRES_TESTS") != "1" {
		t.Skip("set RUN_POSTGRES_TESTS=1 to run PostgreSQL integration tests")
	}
	dsn := os.Getenv("DATABASE_URL")
	if dsn == "" {
		t.Fatal("DATABASE_URL is required when PostgreSQL tests are enabled")
	}
	db, err := sql.Open("pgx", dsn)
	if err != nil {
		t.Fatalf("Open Error: %v", err)
	}
	t.Cleanup(func() {
		if err := db.Close(); err != nil {
			t.Errorf("close database: %v", err)
		}
	})
	store := NewPostgresStore(db)
	ctxWithTime, cancel := context.WithTimeout(context.Background(), 3*time.Second)
	defer cancel()
	if err := store.db.PingContext(ctxWithTime); err != nil {
		t.Fatalf("Connect Error : %v", err)
	}
	return store
}
go

这里需要我们注意的一点就是,我们为什么需要用 pingContext 来完成测试?实际原因是,sql.open 没问题相当与说明和数据库的初始化链接这个 “门” 没有问题,我们需要实际去 ping 一次才能知道究竟能否正常操作SQL

同时,通过 t.clean() 注册清理也是我们需要注意的,clean会按照先来后执行的方式,在测试退出的时候依次执行,所以我们需要在 open() 后立刻注册关闭数据库的清理,在调用 create 后立刻注册对数据库中测试数据的清理