cockroachutil

Documentation

Index

• func CreateRandomTestingSchemaName(n int) string
• func Open(name string) (driver.Conn, error)
• func OpenUnique(ctx context.Context, connStr string, schemaPrefix string) (db *dbutil.TempDatabase, err error)
• type Connector
  • func (conn *Connector) Driver() driver.Driver
• type Driver
  • func (cd *Driver) Open(name string) (driver.Conn, error)
  • func (cd *Driver) OpenConnector(name string) (driver.Connector, error)

Functions

func CreateRandomTestingSchemaName

func CreateRandomTestingSchemaName(n int) string

CreateRandomTestingSchemaName creates a random schema name string.

func Open

func Open(name string) (driver.Conn, error)

Open opens a new cockroachDB connection.

func OpenUnique

func OpenUnique(ctx context.Context, connStr string, schemaPrefix string) (db *dbutil.TempDatabase, err error)

OpenUnique opens a temporary unique CockroachDB database that will be cleaned up when closed. It is expected that this should normally be used by way of "storj.io/storj/private/dbutil/tempdb".OpenUnique() instead of calling it directly.

Types

type Connector

type Connector struct {
	driver.Connector
}

Connector is a thin wrapper around a pq-based connector. This allows Driver to satisfy driver.DriverContext, and avoids weird breakage if and when we upgrade from pq 1.0 to pq 1.2 or higher.

func (*Connector) Driver

func (conn *Connector) Driver() driver.Driver

Driver returns the driver being used for this connector.

type Driver

type Driver struct {
	pq.Driver
}

Driver is the type for the "cockroach" sql/database driver. It uses github.com/lib/pq under the covers because of Cockroach's PostgreSQL compatibility, but allows differentiation between pg and crdb connections.

func (*Driver) Open

func (cd *Driver) Open(name string) (driver.Conn, error)

Open opens a new cockroachDB connection.

func (*Driver) OpenConnector

func (cd *Driver) OpenConnector(name string) (driver.Connector, error)

OpenConnector obtains a new db Connector, which sql.DB can use to obtain each needed connection at the appropriate time.