Documentation
¶
Index ¶
- func AfterCommit(ctx context.Context, callback func(context.Context) error)
- func ClockNow(ctx context.Context, db bun.IDB) (time.Time, error)
- func DiscardConn(conn bun.Conn)
- func HoldSessionLock(ctx context.Context, conn bun.Conn, namespace LockNamespace, keys []string, ...) error
- func LockKey(parts ...string) string
- func Now(ctx context.Context, db bun.IDB) (time.Time, error)
- func PutOutbox(ctx context.Context, kind string, payload any) (string, error)
- func RunInTx(ctx context.Context, db bun.IDB, fn func(context.Context, bun.Tx) error) error
- func SessionLock(ctx context.Context, conn bun.Conn, namespace LockNamespace, keys ...string) error
- func SessionUnlock(ctx context.Context, conn bun.Conn, namespace LockNamespace, keys ...string) error
- func Transaction(ctx context.Context) bun.Tx
- func TrySessionLock(ctx context.Context, conn bun.Conn, namespace LockNamespace, key string) (bool, error)
- func TryWithSessionLock(ctx context.Context, db *bun.DB, namespace LockNamespace, key string, ...) (bool, error)
- func WithSessionLock(ctx context.Context, db *bun.DB, namespace LockNamespace, keys []string, ...) error
- func XactLock(ctx context.Context, tx bun.IDB, namespace LockNamespace, keys ...string) error
- type LockNamespace
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AfterCommit ¶
AfterCommit 在当前 RunInTx 事务内登记提交后回调;调用方必须处于 RunInTx 内。临时信号经它在提交后发布,进程在提交后、回调前退出时回调不执行。
func DiscardConn ¶
DiscardConn 把连接标记为失效,连接关闭时从连接池丢弃,连接上的会话状态与会话级咨询锁随之释放。
func HoldSessionLock ¶
func HoldSessionLock(ctx context.Context, conn bun.Conn, namespace LockNamespace, keys []string, fn func() error) error
HoldSessionLock 在已有连接上取得命名空间下各键的会话级咨询锁后执行 fn,结束后释放。
func RunInTx ¶
RunInTx 执行写事务并在提交成功后按登记顺序执行事务内经 AfterCommit 登记的回调,回滚或提交失败时丢弃回调。 db 为 *bun.DB 或 bun.Conn 时开启独立的顶层事务并使用新的登记表,与上下文中外层事务的登记表互不影响; db 为 bun.Tx 时以保存点执行:外层事务由 RunInTx 开启时加入其登记表,回调在外层事务提交后执行,保存点回滚时丢弃保存点内登记的回调;外层事务未经 RunInTx 开启时保存点内不可登记回调。 回调执行时事务结果已确定,回调返回错误或 panic 时记录 Error 日志后继续执行其余回调,RunInTx 仍返回 nil。
func SessionLock ¶
SessionLock 在连接上按升序取得命名空间下各键的会话级咨询锁;中途失败时释放已取得的锁后返回错误。
func SessionUnlock ¶
func SessionUnlock(ctx context.Context, conn bun.Conn, namespace LockNamespace, keys ...string) error
SessionUnlock 按降序释放连接上命名空间下各键的会话级咨询锁,释放失败时丢弃底层连接并返回错误,PostgreSQL 随连接断开释放其余锁。
func TrySessionLock ¶
func TrySessionLock(ctx context.Context, conn bun.Conn, namespace LockNamespace, key string) (bool, error)
TrySessionLock 在连接上尝试取得命名空间下单个键的会话级咨询锁,空键取以命名空间命名的一把锁,锁被占用时立即返回 false。
func TryWithSessionLock ¶
func TryWithSessionLock(ctx context.Context, db *bun.DB, namespace LockNamespace, key string, fn func(conn bun.Conn) error) (bool, error)
TryWithSessionLock 在新的专用连接上尝试取得单个会话级咨询锁,取得时执行 fn 后释放并返回 true,锁被占用时返回 false。
Types ¶
type LockNamespace ¶
type LockNamespace string
LockNamespace 是咨询锁的业务命名空间,锁键由命名空间与业务键拼接后经 hashtextextended 映射为 64 位编号;不同命名空间的锁键互不同名,哈希碰撞仍可能让两个锁键互相等待。
const ( // LockMessagePartitions 串行创建消息分区。 LockMessagePartitions LockNamespace = "message-partitions" // LockPlatformStats 串行执行运营数据汇总与重建。 LockPlatformStats LockNamespace = "platform-stats" // LockVectorIndexes 串行执行知识库专属向量索引对账。 LockVectorIndexes LockNamespace = "vector-indexes" // LockDeploymentAdmission 串行执行服务端进程加入部署。 LockDeploymentAdmission LockNamespace = "deployment-admission" // LockDeploymentCertificate 串行签发部署地址证书。 LockDeploymentCertificate LockNamespace = "deployment-certificate" // LockServerInstance 是服务端进程运行期间持有的实例锁,键为实例编号。 LockServerInstance LockNamespace = "server-instance" // LockPushDevice 串行登记同一推送设备,键为应用、平台与设备编号。 LockPushDevice LockNamespace = "push-device" // LockPlatformContact 串行处理同一平台账号下同一外部编号的首次入站,键为工作区、平台账号与外部编号。 LockPlatformContact LockNamespace = "platform-contact" // LockWeComBot 串行连接同一企业微信机器人,键为机器人编号。 LockWeComBot LockNamespace = "wecom-bot" // LockTelegramChannel 串行执行单个 Telegram 渠道的配置生命周期,键为渠道编号。 LockTelegramChannel LockNamespace = "telegram-channel" // LockTelegramBot 串行执行工作区内同一 Telegram Bot 的 Webhook 生命周期,键为工作区与 Bot 编号。 LockTelegramBot LockNamespace = "telegram-bot" )