crdb

Documentation

Index

• func NewCRDBDatastore(url string, options ...Option) (datastore.Datastore, error)
• type Option
  • func ConnMaxIdleTime(idle time.Duration) Option
  • func ConnMaxLifetime(lifetime time.Duration) Option
  • func GCWindow(window time.Duration) Option
  • func MaxOpenConns(conns int) Option
  • func MaxRetries(maxRetries int) Option
  • func MaxRevisionStalenessPercent(stalenessPercent float64) Option
  • func MinOpenConns(conns int) Option
  • func OverlapKey(key string) Option
  • func OverlapStrategy(strategy string) Option
  • func RevisionQuantization(bucketSize time.Duration) Option
  • func SplitAtEstimatedQuerySize(splitAtEstimatedQuerySize units.Base2Bytes) Option
  • func WatchBufferLength(watchBufferLength uint16) Option

Functions

func NewCRDBDatastore

func NewCRDBDatastore(url string, options ...Option) (datastore.Datastore, error)

NewCRDBDatastore initializes a SpiceDB datastore that uses a CockroachDB database while leveraging its AOST functionality.

Types

type Option

type Option func(*crdbOptions)

Option provides the facility to configure how clients within the CRDB datastore interact with the running CockroachDB database.

func ConnMaxIdleTime

func ConnMaxIdleTime(idle time.Duration) Option

ConnMaxIdleTime is the duration after which an idle connection will be automatically closed by the health check.

This value defaults to having no maximum.

func ConnMaxLifetime

func ConnMaxLifetime(lifetime time.Duration) Option

ConnMaxLifetime is the duration since creation after which a connection will be automatically closed.

This value defaults to having no maximum.

func GCWindow

func GCWindow(window time.Duration) Option

GCWindow is the maximum age of a passed revision that will be considered valid.

This value defaults to 24 hours.

func MaxOpenConns

func MaxOpenConns(conns int) Option

MaxOpenConns is the maximum size of the connection pool.

This value defaults to having no maximum.

func MaxRetries

func MaxRetries(maxRetries int) Option

MaxRetries is the maximum number of times a retriable transaction will be client-side retried. Default: 50

func MaxRevisionStalenessPercent

func MaxRevisionStalenessPercent(stalenessPercent float64) Option

MaxRevisionStalenessPercent is the amount of time, expressed as a percentage of the revision quantization window, that a previously computed rounded revision can still be advertised after the next rounded revision would otherwise be ready.

This value defaults to 0.1 (10%).

func MinOpenConns

func MinOpenConns(conns int) Option

MinOpenConns is the minimum size of the connection pool. The health check will increase the number of connections to this amount if it had dropped below.

This value defaults to zero.

func OverlapKey

func OverlapKey(key string) Option

OverlapKey is a key touched on every write if OverlapStrategy is "static" Default: 'key'

func OverlapStrategy

func OverlapStrategy(strategy string) Option

OverlapStrategy is the strategy used to generate overlap keys on write. Default: 'static'

func RevisionQuantization

func RevisionQuantization(bucketSize time.Duration) Option

RevisionQuantization is the time bucket size to which advertised revisions will be rounded.

This value defaults to 5 seconds.

func SplitAtEstimatedQuerySize

func SplitAtEstimatedQuerySize(splitAtEstimatedQuerySize units.Base2Bytes) Option

SplitAtEstimatedQuerySize is the query size at which it is split into two (or more) queries.

This value defaults to `common.DefaultSplitAtEstimatedQuerySize`.

func WatchBufferLength

func WatchBufferLength(watchBufferLength uint16) Option

WatchBufferLength is the number of entries that can be stored in the watch buffer while awaiting read by the client.

This value defaults to 128.