cockroachutil

Documentation

Index

• func CreateRandomTestingSchemaName(n int) string
• func NeedsRetry(err error) bool
• func OpenUnique(ctx context.Context, connStr string, schemaPrefix string) (db *dbutil.TempDatabase, err error)
• 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 NeedsRetry

func NeedsRetry(err error) bool

NeedsRetry checks if the error code means a retry is needed, borrowed from code in crdb.

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/shared/dbutil/tempdb".OpenUnique() instead of calling it directly.

Types

type Driver

type Driver struct {
	// contains filtered or unexported fields
}

Driver is the type for the "cockroach" sql/database driver. It uses github.com/jackc/pgx/v5/stdlib 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.