dbquery

Nov 4, 2026

Changes in this version

+ type Role struct

+ Name string

+ Writes []string

+ func InspectRole(ctx context.Context, db Beginner) (Role, error)

+ func (r Role) Writable() bool

Oct 30, 2026

Changes in this version

+ const DefaultIdleTimeout

+ const DefaultLockTimeout

+ const MaxLockTimeout

+ const MaxParams

+ func ParamRefs(sql string) (max int, err error)

type Event

+ Args []any

type Options

+ Args []any

+ IdleTimeout time.Duration

+ LockTimeout time.Duration

+ MaxBytes int

Oct 29, 2026

Changes in this version

+ const DefaultMaxRows

+ const DefaultTimeout

+ const MaxCellBytes

+ const MaxResponseBytes

+ const MaxRowsLimit

+ const MaxSQLBytes

+ const MaxTimeout

+ func Check(sql string) (leader string, err error)

+ type AuditFunc func(ctx context.Context, e Event) error

+ func (f AuditFunc) Audit(ctx context.Context, e Event) error

+ type Auditor interface

+ Audit func(ctx context.Context, e Event) error

+ type Beginner interface

+ BeginTx func(ctx context.Context, txOptions pgx.TxOptions) (pgx.Tx, error)

+ type Column struct

+ Name string

+ PGType string

+ type Error struct

+ Err error

+ Kind Kind

+ Message string

+ Reason string

+ func (e *Error) Error() string

+ func (e *Error) Unwrap() error

+ type Event struct

+ Bytes int

+ Duration time.Duration

+ Err error

+ Leader string

+ MaxRows int

+ Outcome string

+ RowCount int

+ SQL string

+ SQLSHA256 string

+ StartedAt time.Time

+ TimeoutSec float64

+ Truncated bool

+ type Kind string

+ const KindAudit

+ const KindCanceled

+ const KindPermission

+ const KindReadOnly

+ const KindRefused

+ const KindSQL

+ const KindTimeout

+ const KindUnavailable

+ func KindOf(err error) Kind

+ type Options struct

+ Auditor Auditor

+ MaxRows int

+ Timeout time.Duration

+ type Result struct

+ Bytes int

+ CellsTruncated int

+ Columns []Column

+ DurationMS int64

+ RowCount int

+ Rows [][]any

+ Truncated bool

+ TruncatedBy string

+ func Run(ctx context.Context, db Beginner, sql string, opts Options) (*Result, error)