Files
knowledge-governance/internal/releaseadapter/v071/library_target_probe.go
T
姚章浩 a7d643635a
build / build (push) Successful in 1m27s
fix(library): 守卫按行取作业身份、同作业多代次、原作业续作与执行域准入
R1 维护/发布守卫硬编码 j.id=$1:维护类入口的 $1 是 scope/instance,作业号在 $2,
导致 update/release/ingress 六个入口正常路径全部匹配不到作业。改为按被更新行自己的
owner_job_id 生成条件,并同时要求该代次在 library_attempts 里仍活跃。

R2 认领只改 jobs.attempt_epoch 不改 attempts.epoch,第二次接管即错位;唯一索引
(job_id) 与"每次接管新 attempt 且历史不可变"矛盾。改为同作业多代次:锁作业行与
operation 行、同 owner 幂等续租、活跃未过期者让路、过期/本作业旧代次标 abandoned、
新代次 epoch=max+1,并清同 operation 其它作业行租约。迟到 write/renew/finish 一律
ErrLibraryEpochStale(finish 补了"只能在活跃态进来一次")。

R3 续作不再新建 -resume 作业:PrepareLibraryJobResume 让原业务作业回 pending 并显式
结束上一代,维护窗口/journal/预备份/写集合仍按原作业 id 归属,代次由 worker 起手递增。

R4 执行域准入改为注册 handler 前读事实:目标实况(KB/租户/schema/索引)、旧 release
路由绑定的 KB、未释放维护窗口持有者;未知或重叠即拒绝执行(不做维护动作、不停既有服务)。

同时自纠 5 项设计偏离:current 次序键取意图创建时间(旧意图迟到事实被拒)、首次锚点
改事务 FOR UPDATE + 回读且 NULL≠0、版本事件冲突只做加法且 xmax=0 才算新事实、
恢复作为新 kind=recover 意图推进 current、隔离测试加测试库护栏并清理残留 schema。

测试:真实 PG(kg-pgtest-writeset,一用例一 schema)新增 8 条集成用例覆盖上述正负例;
go test ./... 全绿(50 包)、go vet/build rc=0、web tsc + vitest 485 通过、make verify 16 项通过。
2026-10-30 17:20:40 +08:00

44 lines
1.6 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package v071
import (
"context"
"errors"
"fmt"
"time"
"github.com/jackc/pgx/v5/pgxpool"
)
// ProbeTargetIdentity 只读地探测"这个 DSN + 知识库"此刻在目标里是什么。
//
// 用途是执行域准入(R4):worker 注册整库发布 handler 之前必须拿到**目标实况**,
// 而不是回声自己的配置。这里复用与发布路径同一份 SQL(liveTargetContractSQL),
// 避免"准入读一份、发布读另一份"的分叉。探测连接短命、只读、失败即返回错误。
func ProbeTargetIdentity(ctx context.Context, dsn string, tenantID uint64, knowledgeBaseID string) (LiveTargetContract, error) {
if dsn == "" || tenantID == 0 || knowledgeBaseID == "" {
return LiveTargetContract{}, errors.New("probe requires dsn, tenant and knowledge base")
}
pool, err := pgxpool.New(ctx, dsn)
if err != nil {
return LiveTargetContract{}, fmt.Errorf("connect target for probe: %w", err)
}
defer pool.Close()
probeCtx, cancel := context.WithTimeout(ctx, 10*time.Second)
defer cancel()
var (
contract LiveTargetContract
declared string
indexName string
)
if err := pool.QueryRow(probeCtx, liveTargetContractSQL, knowledgeBaseID, tenantID).Scan(
&contract.SchemaVersion, &contract.Dirty, &contract.EmbeddingModel, &contract.EmbeddingDimension,
&contract.ModelBound, &declared, &contract.EngineType, &indexName); err != nil {
return LiveTargetContract{}, fmt.Errorf("read target identity: %w", err)
}
if !contract.ModelBound && declared != "" {
contract.EmbeddingModel = declared
}
contract.IndexName = indexName
return contract, nil
}