1 // Package pgconn is a low-level PostgreSQL database driver. 2 /* 3 pgconn provides lower level access to a PostgreSQL connection than a database/sql or pgx connection. It operates at 4 nearly the same level is the C library libpq. 5 6 Establishing a Connection 7 8 Use Connect to establish a connection. It accepts a connection string in URL or DSN and will read the environment for 9 libpq style environment variables. 10 11 Executing a Query 12 13 ExecParams and ExecPrepared execute a single query. They return readers that iterate over each row. The Read method 14 reads all rows into memory. 15 16 Executing Multiple Queries in a Single Round Trip 17 18 Exec and ExecBatch can execute multiple queries in a single round trip. They return readers that iterate over each query 19 result. The ReadAll method reads all query results into memory. 20 21 Pipeline Mode 22 23 Pipeline mode allows sending queries without having read the results of previously sent queries. It allows 24 control of exactly how many and when network round trips occur. 25 26 Context Support 27 28 All potentially blocking operations take a context.Context. If a context is canceled while the method is in progress the 29 method immediately returns. In most circumstances, this will close the underlying connection. 30 31 The CancelRequest method may be used to request the PostgreSQL server cancel an in-progress query without forcing the 32 client to abort. 33 */ 34 package pgconn 35