History

soup 1e5424c844 Add vendor directory and update vendorHash to null		2026-01-17 22:29:54 -05:00
..
ctxwatch	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
internal/bgreader	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
auth_scram.go	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
config.go	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
defaults.go	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
defaults_windows.go	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
doc.go	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
errors.go	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
krb5.go	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
pgconn.go	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00
README.md	Add vendor directory and update vendorHash to null	2026-01-17 22:29:54 -05:00

README.md

pgconn

Package pgconn is a low-level PostgreSQL database driver. It operates at nearly the same level as the C library libpq. It is primarily intended to serve as the foundation for higher level libraries such as https://github.com/jackc/pgx. Applications should handle normal queries with a higher level library and only use pgconn directly when required for low-level access to PostgreSQL functionality.

Example Usage

pgConn, err := pgconn.Connect(context.Background(), os.Getenv("DATABASE_URL"))
if err != nil {
	log.Fatalln("pgconn failed to connect:", err)
}
defer pgConn.Close(context.Background())

result := pgConn.ExecParams(context.Background(), "SELECT email FROM users WHERE id=$1", [][]byte{[]byte("123")}, nil, nil, nil)
for result.NextRow() {
	fmt.Println("User 123 has email:", string(result.Values()[0]))
}
_, err = result.Close()
if err != nil {
	log.Fatalln("failed reading result:", err)
}

Testing

See CONTRIBUTING.md for setup instructions.