pgx库中命名的prepared语句，它是如何工作的？

Question

在Go标准sql库中，*Stmt类型的方法定义如下：

func (s *Stmt) Exec(args ...interface{}) (Result, error)
func (s *Stmt) Query(args ...interface{}) (*Rows, error)

新的（未命名的）语句由以下人员编写：

func (db *DB) Prepare(query string) (*Stmt, error)

1. 连接池是抽象的，不能直接访问
2. 在单个连接上准备事务
3. 如果在Station执行时连接不可用，将在新连接上重新准备连接

PreparedStatement类型未定义任何方法。新命名的prepared语句由以下人员编写：

func (p *ConnPool) Prepare(name, sql string) (*PreparedStatement, error)

1. 操作直接在连接池上
2. 在池的所有连接上准备事务
3. 没有明确的方法如何执行准备好的语句

在Github的评论中，作者更好地解释了pgx和数据库/sql之间的架构差异。留档上的准备也指出（强调我的）：

Prepare是幂等的；i、 使用相同的名称和sql参数多次调用Prepare是安全的。这允许代码路径准备和查询/Exec/PrepareEx，而无需考虑语句是否已经准备好。

package main

import (
    "github.com/jackc/pgx"
)

func main() {
    conf := pgx.ConnPoolConfig{
        ConnConfig: pgx.ConnConfig{
            Host:     "/run/postgresql",
            User:     "postgres",
            Database: "test",
        },
        MaxConnections: 5,
    }
    db, err := pgx.NewConnPool(conf)
    if err != nil {
        panic(err)
    }
    _, err = db.Prepare("my-query", "select $1")
    if err != nil {
        panic(err)
    }
    // What to do with the prepared statement?
}

1. name参数给我的印象是，它可以通过name调用来执行，但是如何执行呢？

这是我自己走得多远：

1. 没有按名称引用查询的方法（假设）

ps, ok := c.preparedStatements[sql]
            if !ok {
                var err error
                ps, err = c.prepareEx("", sql, nil)
                if err != nil {
                    return "", err
                }
            }

Answer 1

@mkopriva指出，sql文本误导了我。它在这里有双重功能。如果sql变量与c.preparedStatements[sql]映射中的键不匹配，则准备sql中包含的查询，并为ps指定一个新的*PreparedStatement结构。如果它确实匹配一个键，ps变量将指向映射的一个条目。

所以你可以有效地做一些事情，比如：

package main

import (
    "fmt"

    "github.com/jackc/pgx"
)

func main() {
    conf := pgx.ConnPoolConfig{
        ConnConfig: pgx.ConnConfig{
            Host:     "/run/postgresql",
            User:     "postgres",
            Database: "test",
        },
        MaxConnections: 5,
    }
    db, err := pgx.NewConnPool(conf)
    if err != nil {
        panic(err)
    }
    if _, err := db.Prepare("my-query", "select $1::int"); err != nil {
        panic(err)
    }
    row := db.QueryRow("my-query", 10)
    var i int
    if err := row.Scan(&i); err != nil {
        panic(err)
    }
    fmt.Println(i)
}