Documentation
¶
Overview ¶
Package postgres provides functions to open PostgreSQL databases with OpenCensus instrumentation.
Index ¶
Examples ¶
Constants ¶
const Scheme = "postgres"
Scheme is the URL scheme this package registers its URLOpener under on DefaultMux.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type PostgresURLOpener ¶
type PostgresURLOpener interface { // OpenPostgresURL opens a Postgres connection based on the URL. OpenPostgresURL(ctx context.Context, u *url.URL) (*sql.DB, error) }
PostgresURLOpener can open Postgres connections based on a URL. The opener must not modify the URL argument. OpenPostgresURL must be safe to call from multiple goroutines.
This interface is generally implemented by types in driver packages.
type URLMux ¶
type URLMux struct {
// contains filtered or unexported fields
}
URLMux is a URL opener multiplexer. It matches the scheme of the URLs against a set of registered schemes and calls the opener that matches the URL's scheme.
The zero value is a multiplexer with no registered schemes.
func DefaultURLMux ¶
func DefaultURLMux() *URLMux
DefaultURLMux returns the URLMux used by OpenPostgres.
Driver packages can use this to register their PostgresURLOpener on the mux.
func (*URLMux) OpenPostgres ¶
OpenPostgres calls OpenPostgresURL with the URL parsed from urlstr. OpenPostgres is safe to call from multiple goroutines.
func (*URLMux) OpenPostgresURL ¶
OpenPostgresURL dispatches the URL to the opener that is registered with the URL's scheme. OpenPostgresURL is safe to call from multiple goroutines.
func (*URLMux) RegisterPostgres ¶
func (mux *URLMux) RegisterPostgres(scheme string, opener PostgresURLOpener)
RegisterPostgres registers the opener with the given scheme. If an opener already exists for the scheme, RegisterPostgres panics.
type URLOpener ¶
type URLOpener struct{}
URLOpener opens URLs like "postgres://" by using the underlying PostgreSQL driver. See https://godoc.org/github.com/lib/pq#hdr-Connection_String_Parameters for details.
Directories
¶
Path | Synopsis |
---|---|
Package awspostgres provides connections to AWS RDS PostgreSQL instances.
|
Package awspostgres provides connections to AWS RDS PostgreSQL instances. |
Package gcppostgres provides connections to managed PostgreSQL Cloud SQL instances.
|
Package gcppostgres provides connections to managed PostgreSQL Cloud SQL instances. |