GOMODULES
/
pgx
mirror of https://github.com/jackc/pgx.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Punctuation and word fixes.

pull/608/head
David Archibald 2019-09-18 10:52:08 -07:00
parent 28ad4873d3
commit 0fc6545486
No known key found for this signature in database
GPG Key ID: D1FC3059ACCA1BC9
1 changed files with 21 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
README.md
View File

@ -58,32 +58,32 @@ encode and decode values for PostgreSQL.
pgx supports many additional features beyond what is available through database/sql. pgx supports many additional features beyond what is available through database/sql.
* Support for approximately 60 different PostgreSQL types * Support for approximately 60 different PostgreSQL types.
* Automatic statement preparation and caching * Automatic statement preparation and caching.
* Batch queries * Batch queries.
* Single-round trip query mode * Single-round trip query mode.
* Full TLS connection control * Full TLS connection control.
* Binary format support for custom types (can be much faster) * Binary format support for custom types (can be much faster).
* Copy protocol support for faster bulk data loads * Copy protocol support for faster bulk data loads.
* Extendable logging support including built-in support for log15, logrus, zap, and zerolog * Extendable logging support including built-in support for log15, logrus, zap, and zerolog.
* Connection pool with after connect hook to do arbitrary connection setup * Connection pool with after connect hook to do arbitrary connection setup.
* Listen / notify * Listen / notify.
* PostgreSQL array to Go slice mapping for integers, floats, and strings * PostgreSQL array to Go slice mapping for integers, floats, and strings.
* Hstore support * Hstore support.
* JSON and JSONB support * JSON and JSONB support.
* Maps inet and cidr PostgreSQL types to net.IPNet and net.IP * Maps inet and cidr PostgreSQL types to net.IPNet and net.IP.
* Large object support * Large object support.
* NULL mapping to Null* struct or pointer to pointer. * NULL mapping to Null* struct or pointer to pointer.
* Supports database/sql.Scanner and database/sql/driver.Valuer interfaces for custom types * Supports database/sql.Scanner and database/sql/driver.Valuer interfaces for custom types.
* Notice response handling (this is different than listen / notify) * Notice response handling (this is different than listen / notify).
* Simulated nested transactions with savepoints * Simulated nested transactions with savepoints.
## Performance ## Performance
There are three areas in particular where pgx can provide a significant performance advantage over the standard There are three areas in particular where pgx can provide a significant performance advantage over the standard
`database/sql` interface and/or other drivers. `database/sql` interface and/or other drivers.
1. PostgreSQL specific types - Types such as arrays can be parsed much quicker because pgx uses the binary format 1. PostgreSQL specific types - Types such as arrays can be parsed much quicker because pgx uses the binary format.
2. Automatic statement preparation and caching - pgx will prepare and cache statements by default. This can provide an 2. Automatic statement preparation and caching - pgx will prepare and cache statements by default. This can provide an
significant free improvement to code that does not explicitly use prepared statements. Under certain workloads it significant free improvement to code that does not explicitly use prepared statements. Under certain workloads it
performs nearly 3x the queries per second. performs nearly 3x the queries per second.
@ -96,11 +96,11 @@ from pgx for lower-level control.
## github.com/jackc/pgconn ## github.com/jackc/pgconn
pgconn is a lower-level PostgreSQL database driver that operates at nearly the same level is the C library libpq. pgconn is a lower-level PostgreSQL database driver that operates at nearly the same level as the C library libpq.
## github.com/jackc/pgx/v4/pgxpool ## github.com/jackc/pgx/v4/pgxpool
pgxpool is a connection pool for pgx. pgx is entirely decoupled from its default pool implementation. This means pgx can be used with a different pool without any pool at all. pgxpool is a connection pool for pgx. pgx is entirely decoupled from its default pool implementation. This means pgx can be used with a different pool or without any pool at all.
## github.com/jackc/pgx/v4/stdlib ## github.com/jackc/pgx/v4/stdlib