05.6.4.1 架构、Schema 与模块化部署
所属:全栈开发面试题库 / 05 数据库与存储 / 05.6 向量数据库与语义检索 / 05.6.4 Weaviate
覆盖范围
- Weaviate 定位、节点角色与双接口(REST / gRPC)部署形态
- Collection、Object、Property 三层数据模型与 dataType 建模
- 模块化向量化:text2vec / multi2vec 模块家族、自提供向量、命名向量
- 分片、副本、多租户配置与租户生命周期
- 倒排与过滤字段设计、跨引用建模
- 鉴权(API key / OIDC / 匿名)、RBAC 角色、备份模块与环境隔离
- Schema 变更代价、集群元数据共识、资源规划与升级兼容性
架构主线
客户端 SDK / REST / gRPC
↓
Weaviate 节点(无状态接入 + 本地分片数据)
↓ 模块层
vectorizer(text2vec / multi2vec / none) reranker generative backup
↓
分片(shard) → 副本(replica) → 持久化目录 / 对象存储
高频题速览
| 编号 | 题目 | 难度 | 频率 |
|---|---|---|---|
| 05.6.4.1-001 | Weaviate 的定位与核心特点 | 基础 | ★★★★★ |
| 05.6.4.1-004 | Class / Object / Property 三层模型 | 基础 | ★★★★★ |
| 05.6.4.1-006 | 模块化向量化的基本思路 | 基础 | ★★★★★ |
| 05.6.4.1-016 | 副本机制与副本同步 | 进阶 | ★★★★★ |
| 05.6.4.1-022 | 命名向量解决什么问题 | 进阶 | ★★★★★ |
| 05.6.4.1-032 | Schema 变更代价与不可变配置 | 进阶 | ★★★★★ |
| 05.6.4.1-036 | 内存构成与容量估算 | 进阶 | ★★★★★ |
| 05.6.4.1-042 | 自提供向量维度不一致排查 | 高级 | ★★★★☆ |
| 05.6.4.1-046 | 升级前兼容性检查 | 高级 | ★★★★☆ |
| 05.6.4.1-048 | RAG 场景的架构与 Schema 设计 | 高级 | ★★★★★ |
05.6.4.1-001 Weaviate 的定位是什么,核心特点有哪些?
频率 ★★★★★ | 难度 基础
一句话结论
Weaviate 是带显式 Schema、模块化向量化与原生 BM25 + 向量混合检索的开源向量数据库。
概念解释
- 定位:存向量、做 ANN 检索、标量过滤与混合排序,不替代业务主库。
- 特点:Schema 显式建模;向量化模块可插拔;原生支持 hybrid。
原理流程
判断:是否需要关键词 + 语义混合、模型是否可插拔、规模与运维能力
需要混合召回与模块化向量化 → Weaviate;纯向量且规模极小 → 轻量方案
代码 / 命令
# 表达模板:定位一句 → 三个特点 → 与同类库差异 → 适用与不适用场景
常见误区
- 误区:Weaviate 只存向量。正解:同时持有标量属性、倒排索引与检索编排。
- 误区:任何场景都选混合检索库。正解:纯结构化业务或极小数据量时不划算。
追问
- 问:与 Milvus 的主要差异?答:Weaviate 重 Schema、模块向量化与原生 hybrid;Milvus 偏大规模分布式向量引擎。
- 问:自提供向量场景多吗?答:已有 Embedding 管线、固定模型或合规不外发文本时常见。
05.6.4.1-002 Weaviate 集群由哪些节点角色组成?
频率 ★★★★☆ | 难度 基础
一句话结论
集群由多个对等节点组成,各承载部分分片及副本;任一节点作为协调者路由到持有数据的副本,无主从数据库角色。
概念解释
- 对等设计:节点间无主从,副本为无主复制模型。
- 协调者:收到请求的节点负责路由、聚合与一致性确认。
原理流程
客户端 → 任一节点(协调者)→ 定位目标分片副本 → 转发读写 → 归并结果返回
代码 / 命令
# 观察:节点列表、分片与副本分布、心跳状态;排障先确认节点在线
常见误区
- 误区:集群有主节点负责写、其他只读。正解:无主复制,写入可经任一节点发起并复制到副本。
- 误区:节点数等于副本数。正解:节点是物理机器,副本是分片拷贝,二者不同维度。
追问
- 问:新增节点后数据自动搬过去吗?答:由集群分片再均衡,需观察迁移后的分布与内存。
- 问:节点宕机会丢数据吗?答:副本多数存活且一致性级别允许时,可由其他副本继续服务。
05.6.4.1-003 REST 与 gRPC 两个端口分别承担什么职责?
频率 ★★★★☆ | 难度 基础
一句话结论
REST 端口 8080 提供对象、schema、备份等 HTTP 接口;gRPC 端口 50051 承载高性能读写与检索,多数客户端同时依赖两条通道。
概念解释
- REST:
/v1端点,适合调试、脚本、管理与模块元数据查询。 - gRPC:二进制序列化,延迟低、批量与检索吞吐好,是客户端主力通道。
原理流程
客户端初始化 → REST 做元数据/就绪检查 → 读写检索走 gRPC
反向代理需分别转发两条流量,gRPC 通常用独立子域或端口
代码 / 命令
# 默认值(自建):REST 8080,gRPC 50051;云托管可能统一走 443
# 待确认:端口默认值与环境变量名,验证方式为官方部署配置文档
常见误区
- 误区:只开 8080 客户端就能跑。正解:gRPC 不通会导致检索或批量失败。
- 误区:gRPC 只是可选优化。正解:客户端底层依赖 gRPC,端口与网络策略必须放行。
追问
- 问:浏览器场景用什么客户端?答:浏览器与边缘运行时用 gRPC-Web 形态的 web 客户端。
- 问:端口冲突怎么排查?答:先确认宿主机占用,再核对容器映射与反向代理规则。
05.6.4.1-004 Collection、Object、Property 三层数据模型如何对应?
频率 ★★★★★ | 难度 基础
一句话结论
Collection(旧称 Class)是同名向量空间内的一类对象集合,Property 是声明字段,Object 是带 UUID 主键、属性值与向量的记录。
概念解释
- Collection:schema 一级单元,绑定向量器、索引、副本、多租户配置。
- Property:字段名与 dataType,可配是否参与向量化、是否建过滤索引。
- Object:单条数据,含主键、属性集合与向量(单向量或命名向量)。
原理流程
创建 Collection → 声明 Properties 与向量配置 → 写入 Object(属性 + 向量)
检索在指定 Collection 内做近邻匹配与过滤
代码 / 命令
# 类比:Collection 近似表,Property 近似列,Object 近似行;每行额外持有向量
常见误区
- 误区:不同 Collection 可共用一个向量跨类检索。正解:向量空间与模型需一致,跨类比较应放同一集合。
- 误区:属性写入时可随意新增。正解:字段需先在 schema 声明,未声明字段按校验规则处理。
追问
- 问:主键是什么类型?答:对象主键为 UUID;写入时可指定,也可由服务端生成。
- 问:类名命名有什么约束?答:需符合 schema 命名规则,避免特殊字符与大小写混用歧义。
05.6.4.1-005 常见 dataType 有哪些,建模时怎么选?
频率 ★★★★☆ | 难度 基础
一句话结论
常用类型含 text、string、int、number、boolean、date、geoCoordinates、phoneNumber、blob、uuid、object、crossReference;按检索语义与过滤方式选类型。
概念解释
- 文本类:text 参与分词与 BM25;string 偏精确值。
- 数值布尔:int、number、boolean 用于范围与等值过滤。
- 结构化:date 时间过滤,geoCoordinates 地理距离,object 嵌套,crossReference 指向其他类。
原理流程
梳理字段用途 → 精确过滤/全文检索/范围比较/地理距离 → 选 dataType
复杂对象拆 object 嵌套或独立类 + crossReference
代码 / 命令
# 待确认:当前版本完整 dataType 列表与索引行为,验证方式:官方 schema 文档
常见误区
- 误区:所有文本都用 string。正解:需关键词全文匹配的字段用 text,否则 BM25 召回不到。
- 误区:嵌套 JSON 塞一个字符串字段。正解:结构化嵌套应建模为 object 或拆类。
追问
- 问:枚举状态值用什么?答:string 或 int 存精确值配合过滤,不要写成自由文本。
- 问:跨引用怎么表达?答:crossReference 属性指向目标类名,对象间通过 UUID 或 beacon 关联。
05.6.4.1-006 模块化向量化的基本思路是什么?
频率 ★★★★★ | 难度 基础
一句话结论
向量化由可插拔模块完成:集合绑定 vectorizer 后,导入时模块编码内容为向量,查询时同一模块编码查询文本;换模块即换向量空间。
概念解释
- 模块位置:vectorizer 是集合级配置,决定对象与查询向量的生成方式。
- 编码一致性:导入与查询必须走同一模型/模块,否则向量不可比。
- 可插拔:换模块等价于换 Embedding 模型,历史向量需全量重建。
原理流程
集合绑定模块 → 写入:模块编码属性文本存向量;查询:模块编码查询文本
在同一向量空间近邻检索
代码 / 命令
# 模块经 ENABLE_MODULES 启用,集合配置引用模块名与参数;凭据走环境变量或请求头
常见误区
- 误区:导入用 A 模型、查询临时换 B 模型也能匹配。正解:不同模型空间不同,结果无意义。
- 误区:模块是查询时才加载的可选插件。正解:导入期就参与编码,集合创建时即确定。
追问
- 问:模块服务不可用会怎样?答:依赖该模块的编码写入与 nearText 查询失败,需超时重试与降级预案。
- 问:同一集合能配两个向量器吗?答:可通过命名向量为不同模型/字段组配置独立向量。
05.6.4.1-007 什么情况下使用自提供向量(vectorizer: none)?
频率 ★★★★☆ | 难度 基础
一句话结论
业务侧已有自有 Embedding 管线、或使用 Weaviate 不内置的模型时,vectorizer 设为 none,写入直接携带向量,服务端不再调用向量化模块。
概念解释
- 适用:已有 Embedding 服务、多模型组合、合规要求文本不出内网、模型迭代频繁。
- 职责边界:维度、归一化、模型版本由业务侧保证,Weaviate 只存储与检索。
- 查询方式:通常用 nearVector 传入查询向量,不依赖 nearText 模块编码。
原理流程
业务侧生成向量 → 写入随属性提交 vector → 服务端落库建索引
查询侧先在业务侧编码 → nearVector 提交向量
代码 / 命令
# 集合配置 vectorizer 置 none(字段名以当前版本 schema 文档为准)
# 写入载荷向量维度须与集合一致,维度不符会被校验拒绝
常见误区
- 误区:none 模式服务端会补算向量。正解:不会,缺失向量或维度错误直接报错。
- 误区:自提供向量不用管模型一致性。正解:查询向量必须与入库向量同模型同版本。
追问
- 问:none 模式还能用 hybrid 吗?答:向量侧由 nearVector/hybrid 的 vector 入参提供;BM25 仍可用。
- 问:维度由谁声明?答:以实际入库向量为准;混入其他维度会导致检索异常。
05.6.4.1-008 常见 text2vec 向量化模块有哪些,怎么取舍?
频率 ★★★★☆ | 难度 基础
一句话结论
常见模块含 text2vec-openai、text2vec-cohere、text2vec-huggingface、text2vec-transformers、text2vec-ollama;取舍看效果、私有化、网络可达、成本与维度一致性。
概念解释
- 托管 API 类:openai、cohere、huggingface 走外部接口,需凭据与出口网络。
- 自托管类:transformers 对接自有推理容器,ollama 对接本地 Ollama 服务。
- 版本边界:各模块可用模型与部署形态不同,清单以官方模块文档为准。
原理流程
确定私有化要求 → 选托管 API 或本地模型 → 选模块 → 配端点/凭据 → 验证维度与召回
代码 / 命令
# ENABLE_MODULES 加入模块名,集合 vectorizer 引用同名模块
# 待确认:模块名与端点配置项,以官方模块文档为准
常见误区
- 误区:换模块只改集合配置就行。正解:换模型需全量重建向量,旧向量不可混用。
- 误区:本地模型模块能在云托管实例随便用。正解:部分自托管模块不提供于托管环境。
追问
- 问:text2vec-ollama 适合什么场景?答:内网或本地硬件跑 Embedding、不希望文本外发;版本限制以官方文档为准。
- 问:模块凭据放哪里?答:优先环境变量或实例配置,请求头只在必要时附加,避免硬编码进仓库。
05.6.4.1-009 multi2vec 多模态模块解决什么问题?
频率 ★★☆☆☆ | 难度 基础
一句话结论
multi2vec 把不同模态内容(如文本与图像)编码到同一共享向量空间,使文本可检索图像、图像可检索文本,典型如 multi2vec-clip。
概念解释
- 共享空间:多模态模型输出同维度向量,跨模态可比。
- 集合建模:属性区分文本与图像字段,模块配置各自编码来源。
- 边界:模型能力决定跨模态质量;纯文本场景用 text2vec 即可。
原理流程
上传文本/图像字段 → 多模态模块编码到共享空间 → 同空间近邻检索
查询侧用对应模态输入编码后匹配
代码 / 命令
# 模块名与字段配置待确认,验证方式:官方多模态模块文档与示例集合定义
常见误区
- 误区:text2vec 也能跨图文检索。正解:单文本模型空间不含图像向量,需多模态模块。
- 误区:图像存 blob 就能被语义检索。正解:需经多模态模型编码,blob 本身不是向量。
追问
- 问:多模态向量维度与纯文本一致吗?答:取决于模型,建集合前以模型输出维度为准。
- 问:跨模态召回差怎么排查?答:先核对模型与训练域是否匹配,再检查字段是否纳入编码。
05.6.4.1-010 单机 Docker 部署需要暴露和持久化什么?
频率 ★★★☆☆ | 难度 基础
一句话结论
单机容器需映射 REST 与 gRPC 端口,挂载持久化目录防重建丢数据,并按所需模块配置环境变量与外部模型端点。
概念解释
- 端口:8080(REST)与 50051(gRPC)映射到宿主机。
- 持久化:数据目录挂卷,容器删除重建后对象与索引仍在。
- 模块凭据:ENABLE_MODULES、模型端点与 API key 经环境变量注入。
原理流程
拉取镜像 → 配端口/卷/环境变量 → 启动 → 就绪检查 → 建集合 → 写入检索闭环验证
代码 / 命令
# 持久化目录由部署环境变量指定(如 PERSISTENCE_DATA_PATH)
# 待确认:环境变量名与默认路径,验证方式:官方 Docker 安装文档
常见误区
- 误区:容器不挂卷也能长期跑。正解:容器删除即丢全部数据,生产必须挂持久卷。
- 误区:端口只配 8080。正解:gRPC 未映射会导致客户端调用失败。
追问
- 问:开发环境要开匿名访问吗?答:仅限本地评估;可被网络访问的实例都应关闭匿名并配置凭据。
- 问:模块容器怎么配合?答:transformers 类需额外启动推理容器并配置端点,主实例通过网络访问。
05.6.4.1-011 集群部署与单机部署的本质差别是什么?
频率 ★★★★☆ | 难度 基础
一句话结论
单机由单节点承载全部分片;集群把分片与副本分布到多个对等节点,换取水平容量、容错与并发,同时引入节点发现、再均衡与一致性协调成本。
概念解释
- 容量:集群按分片分散数据,突破单机内存与磁盘上限。
- 容错:分片多副本分布不同节点,单点故障由副本接替。
- 代价:节点通信、副本同步、元数据协调与跨节点归并开销。
原理流程
估算规模与可用性 → 单机可承载则单机 → 需要容错/扩容则集群
集群:节点加入 → 分片分配 → 副本分布 → 路由与归并
代码 / 命令
# 判断依据:向量总量、QPS、可用性、是否需滚动升级与独立扩缩容
常见误区
- 误区:上集群就一定比单机快。正解:数据量小、并发低时协调开销反而更高。
- 误区:集群副本就是多存几份备份。正解:副本是在线可服务拷贝,用于读写容错与并发。
追问
- 问:单机数据怎么迁到集群?答:备份导出再在集群恢复,或全量重新导入,不能直接拷贝本地目录。
- 问:集群最少几个节点?答:按副本容错目标定,单节点无副本容错能力。
05.6.4.1-012 Weaviate 有哪几种认证方式?
频率 ★★★★☆ | 难度 基础
一句话结论
认证支持 API key、OIDC 与匿名访问;API key 最简单,OIDC 对接外部身份提供商,匿名仅限开发评估,生产应关闭。
概念解释
- API key:为用户分配密钥,请求头携带,适合服务端到服务端调用。
- OIDC:外部 IdP 签发令牌,Weaviate 校验,适合已有统一身份体系的组织。
- 匿名:不做身份校验,风险高,不能用于可公开访问的生产实例。
原理流程
部署配置启用认证 → 客户端获取凭据/令牌 → 请求头携带 Bearer 凭据 → 服务端校验放行或拒绝
代码 / 命令
# 请求头:Authorization: Bearer <API_KEY 或 access token>
# 待确认:启用开关环境变量名,以官方认证文档为准
常见误区
- 误区:生产开匿名加网络白名单就够。正解:网络隔离是第一道防线,身份认证仍应开启。
- 误区:API key 可随意共享。正解:密钥按用户/服务拆分,便于轮换与撤销。
追问
- 问:OIDC 令牌过期怎么办?答:客户端携带刷新令牌自动续期,配置传入 access/refresh 令牌与过期时间。
- 问:认证与授权是一回事吗?答:认证解决“你是谁”,授权解决“你能做什么”,后者由 RBAC 控制。
05.6.4.1-013 多租户默认是否开启,怎么开启?
频率 ★★★★☆ | 难度 基础
一句话结论
多租户默认关闭;在集合定义中启用 multiTenancyConfig 后,租户作为独立隔离单元存在,写入与查询都需显式指定租户。
概念解释
- 默认行为:不启用时集合内所有对象共享同一隔离层。
- 启用后:每个租户拥有独立分片数据,租户间隔离,查询必须限定具体租户。
- 显式管理:默认不存在的租户写入报错,需先创建租户(或开启自动建租户)。
原理流程
集合配置 multiTenancyConfig.enabled = true → 创建租户 → 按租户写入/查询
未指定租户条件的跨租户行为受服务端规则约束,不能默认混查
代码 / 命令
# 配置字段与租户管理接口待确认,验证方式:官方多租户文档与 schema 示例
# 关键检查:查询强制带租户条件,避免跨租户泄露
常见误区
- 误区:加一个 tenant_id 字段就是多租户。正解:字段过滤是逻辑隔离;多租户是集合级租户分片隔离,强度不同。
- 误区:开启后对象自动按字段分桶。正解:必须显式指定租户名,未建租户写入被拒绝。
追问
- 问:自动建租户是什么?答:autoTenantCreation 开启后写入不存在租户时自动创建;可用版本以官方文档为准。
- 问:大租户能占满整个节点吗?答:可能,大租户需单独评估分片、副本与隔离策略。
05.6.4.1-014 开发、预发、生产环境怎么做隔离?
频率 ★★☆☆☆ | 难度 基础
一句话结论
按环境隔离实例与凭据,配置用模板渲染,数据不跨环境复制(除脱敏样本),监控与配额各自独立,避免测试流量污染生产指标。
概念解释
- 隔离层级:实例/集合、凭据、外部模型端点、网络访问策略。
- 配置管理:环境变量模板 + 差异化覆盖,禁止手改生产配置。
- 数据:预发用脱敏小样本,压测分布要贴近真实。
原理流程
模板配置 → 各环境渲染 → 独立实例与凭据 → 独立监控看板 → 变更按环境灰度推进
代码 / 命令
# 检查:生产凭据不出现在测试配置;测试集合命名带前缀;客户端启动校验环境标识
常见误区
- 误区:共用一套实例只靠集合名区分。正解:误操作与资源争抢风险高,应实例级隔离。
- 误区:压测用随机向量即可。正解:维度、文本分布与过滤基数要贴近真实,否则结论无效。
追问
- 问:预发环境要多大?答:能按缩比承载压测、复现瓶颈即可,不必与生产等配。
- 问:如何防止误连生产?答:网络隔离 + 凭据分离 + 客户端环境校验 + 集合命名规范。
05.6.4.1-015 分片(sharding)是如何切分集合数据的?
频率 ★★★★☆ | 难度 进阶
一句话结论
集合数据按分片配置切分为多个 shard,分布到集群节点以突破单机容量上限;分片数量与虚拟分片配置在建类时确定,后续调整需评估再均衡代价。
概念解释
- 分片单元:每个 shard 持有部分对象及其向量、倒排与索引。
- 分布:分片按拓扑分配到节点,副本在不同节点重复拷贝。
- 配置:分片计数、虚拟分片等属 schema 级配置,变更影响面大。
原理流程
创建集合 → 按配置生成 shard → 分配到节点 → 写入按规则落对应 shard
查询跨相关 shard 并行检索后归并
代码 / 命令
# 观察:各 shard 对象数、所在节点、副本分布是否均衡
# 待确认:分片配置字段名与默认值,以官方 schema 与分片配置文档为准
常见误区
- 误区:分片越多查询越快。正解:分片过多增加跨节点归并与元数据开销,需按规模权衡。
- 误区:分片可随时在线无限增加。正解:扩分片涉及数据再分配与加载,需低峰窗口评估执行。
追问
- 问:分片不均怎么表现?答:个别节点对象数与内存偏高,查询热点集中,需再均衡或调策略。
- 问:多租户集合分片怎么算?答:每个租户拥有自己的分片单元,租户规模直接影响分片数量与资源占用。
05.6.4.1-016 副本机制与副本同步是怎样的?
频率 ★★★★★ | 难度 进阶
一句话结论
副本是分片在不同节点上的在线拷贝;写入分发到该分片全部副本,协调者按一致性级别等待对应数量确认,未达确认的差异由读修复与自动修复补齐。
概念解释
- 无主复制:副本间不设主从,任一持有副本的节点都可响应读取。
- 写入扩散:无论级别高低,写入目标是全部副本,差别只在等待多少份确认。
- 差异补齐:临时不一致在读取时修复,自动修复后台同步落后副本。
原理流程
写入到协调节点 → 并行分发全部副本 → 按级别收集确认 → 返回成功/失败
读取 → 从满足级别副本取数 → 发现差异触发读修复
代码 / 命令
# 副本数在 replication 配置声明;待确认:字段名与默认值,以官方复制配置文档为准
# 观察:各副本对象数是否一致、落后副本是否被自动修复追上
常见误区
- 误区:ONE 意味着只写一个副本。正解:数据仍写全部副本,ONE 只等待一份确认即返回。
- 误区:副本数越高吞吐越好。正解:副本放大写入与内存成本,先确认瓶颈在读还是写。
追问
- 问:副本分布在同节点上行不行?答:没有容错意义,应分布到不同节点。
- 问:副本落后怎么发现?答:对比各副本对象数与校验,结合读一致性级别下的返回差异判断。
05.6.4.1-017 副本数与节点数是什么关系?
频率 ★★★☆☆ | 难度 进阶
一句话结论
节点是物理服务器数量,副本是每个分片的拷贝份数;副本数只有分布到不同节点才有容错意义,二者分别决定机器规模与数据冗余度。
概念解释
- 容错:副本数决定可容忍多少副本同时不可用;QUORUM = n/2+1。
- 资源:每增一份副本,内存、索引与写入放大同步增加。
- 规划:先按容量定分片与节点,再按可用性目标定副本数。
原理流程
估容量 → 定分片与节点数 → 按可用性定副本数 → 校验可跨节点分布 → 核算放大成本
代码 / 命令
# 例:3 副本可容忍 1 副本故障(QUORUM 仍可凑齐);具体容错数按一致性级别推导
常见误区
- 误区:节点数自动等于副本数。正解:二者独立配置,常见节点数大于副本数以承载多个分片。
- 误区:单节点也能配多副本获得高可用。正解:同节点多副本不防节点故障。
追问
- 问:副本数改大会怎样?答:触发数据再复制与加载,占带宽与内存,需低峰执行并观察。
- 问:写吞吐随副本数下降多少?答:取决于等待确认策略,ALL 最慢,ONE 对写入延迟影响最小但一致性折中。
05.6.4.1-018 模块是如何通过 ENABLE_MODULES 启用的?
频率 ★★★★☆ | 难度 进阶
一句话结论
实例通过 ENABLE_MODULES 环境变量声明启用的模块清单,只有被启用的模块才能在集合配置中被引用;备份、离卸等能力同样以模块形式挂入。
概念解释
- 启用入口:部署环境变量列出模块名,实例启动时加载。
- 引用方式:集合 schema 的 vectorizer / generative / reranker 配置引用已启用模块。
- 多模块:可同时启用多个提供方模块,按集合各自选用。
原理流程
配置 ENABLE_MODULES 清单 → 启动加载模块 → 集合配置引用模块名 → 校验存在后生效
代码 / 命令
# 环境变量值为模块名列表;分隔与命名以官方部署文档为准
# 待确认:当前版本 ENABLE_MODULES 格式与默认启用集合
常见误区
- 误区:集合配置写了模块名就自动安装。正解:实例未启用该模块时创建或调用会失败。
- 误区:模块启用后所有集合自动使用。正解:启用只是可用,仍需在集合配置中绑定。
追问
- 问:新增模块要重启吗?答:模块随启动加载,增减通常需重启或按部署方式重载。
- 问:模块之间冲突吗?答:不同职责模块可共存;同类向量器在同一集合内用命名向量区分。
05.6.4.1-019 外部模块凭据怎么配置,有哪些方式?
频率 ★★★☆☆ | 难度 进阶
一句话结论
模型提供方凭据优先通过实例环境变量注入,也可在请求期经附加头传递;环境变量适合长期服务端集成,请求头适合多租户或临时密钥场景。
概念解释
- 环境变量:启动时读取,对所有集合生效,便于统一管理与轮换。
- 请求期头:单次调用附带提供方密钥,适合多密钥路由或托管实例场景。
- 边界:凭据不进代码仓库、不写进 schema 与对象属性。
原理流程
获取提供方 key → 注入环境变量或请求附加头 → 模块调用外部模型时携带 → 凭据不进业务数据
代码 / 命令
# 环境变量名按提供方模块而定,待确认以官方模块文档为准
# 要点:密钥管理、轮换、最小暴露面,不要把 key 写死在示例里
常见误区
- 误区:把提供方 key 存进对象属性方便取。正解:属性会被检索与导出,属敏感信息泄露。
- 误区:所有环境共用一把长期 key。正解:按环境/服务拆分,支持单独撤销与轮换。
追问
- 问:多租户用不同模型 key 怎么做?答:请求期附加头按租户路由不同密钥,注意限流与隔离。
- 问:密钥泄露怎么应急?答:先在提供方侧吊销轮换,再排查调用日志与导出记录。
05.6.4.1-020 Property 级的 skip 与 vectorizePropertyName 是什么语义?
频率 ★★★☆☆ | 难度 进阶
一句话结论
属性级模块配置控制字段是否参与向量化:skip 跳过该字段编码,vectorizePropertyName 控制字段名本身是否计入向量,默认行为按模块约定。
概念解释
- skip:该属性内容不进入向量文本,适合只展示或过滤、不影响语义的字段。
- 字段名参与:模块可选择把属性名连同值一起编码,开关控制是否纳入。
- 影响:调整开关会改变向量构成,调整后需重建向量验证召回。
原理流程
模块组装向量化文本 → 按属性级开关决定纳入字段与字段名 → 编码入库
查询侧使用同一组装规则,保证空间一致
代码 / 命令
# 配置位于属性 moduleConfig 下;字段名待确认,以对应模块文档为准
# 调整:改配置 → 全量重建 → 对比召回 → 切流
常见误区
- 误区:过滤字段也必须参与向量化。正解:纯过滤/展示字段可 skip,减少噪声进入语义空间。
- 误区:改属性开关不用重建数据。正解:向量构成变了,历史向量与新向量不一致。
追问
- 问:标题和正文要不要分别编码?答:可按语义权重在字段层面区分纳入方式,必要时用命名向量独立建模。
- 问:怎么判断字段该不该进向量?答:看它是否改变对象语义;定位、分类、展示字段不进。
05.6.4.1-021 跨引用(crossReference)怎么建模?
频率 ★★★☆☆ | 难度 进阶
一句话结论
crossReference 属性在两个类之间建立对象级关联,写入时通过目标对象 UUID 或 beacon 指向,检索结果可沿引用带出关联对象字段。
概念解释
- 建模:源类声明 crossReference 属性,指向一个或多个目标类名。
- 写入:引用值填目标对象标识,关联在对象间维护。
- 检索:查询可请求引用路径下的字段,形成带关联的结果结构。
原理流程
定义源类引用属性指向目标类 → 写入目标对象 → 源对象引用其 UUID/beacon
查询沿引用取目标字段 → 结果按引用结构返回
代码 / 命令
# 待确认:当前版本引用 schema 写法与查询路径语法,以官方 GraphQL/schema 文档为准
# 设计要点:关联基数(一对多/多对多)与是否需要双向引用
常见误区
- 误区:跨引用会把目标对象复制进来。正解:存的是引用标识,不是冗余副本。
- 误区:删源对象自动级联删目标。正解:引用关系不自动级联删除,需业务侧处理。
追问
- 问:引用断了会怎样?答:目标不存在时按查询规则返回空或报错,需在写入与删除时维护一致性。
- 问:复杂关联用引用还是嵌套 object?答:独立可复用、需单独检索的实体用引用;纯附属结构用 object。
05.6.4.1-022 命名向量(named vectors)解决什么问题?
频率 ★★★★★ | 难度 进阶
一句话结论
命名向量允许同一集合为不同模型、字段组或用途维护多个独立向量,各有自己的维度、索引与量化配置,避免一个集合只能绑定一种 Embedding 空间。
概念解释
- 多向量并存:一个对象可带多个命名向量,分别由不同模块或自提供向量生成。
- 独立配置:每个命名向量可有独立距离度量、索引类型与量化压缩。
- 版本边界:命名向量为较新版本能力,具体可用版本以官方文档为准。
原理流程
定义多个命名向量及配置 → 写入分别生成各向量
检索指定目标命名向量做近邻匹配;不同向量间不跨空间比较
代码 / 命令
# 客户端配置入口与字段名待确认,以官方命名向量文档与客户端迁移说明为准
# 设计要点:先列清需要几个语义空间,再定拆分粒度
常见误区
- 误区:命名向量就是一条向量存多个模型结果。正解:是多个独立向量条目,各自独立索引与检索。
- 误区:旧集合可平滑补上命名向量。正解:新增向量需对历史对象回填编码,属数据重建任务。
追问
- 问:命名向量之间能做融合吗?答:检索编排可在业务侧或混合查询中组合结果,向量本身不自动融合。
- 问:每个命名向量都要单独配量化吗?答:是,压缩策略按向量独立启用,互不影响。
05.6.4.1-023 命名向量在配置与压缩上与单向量有什么差异?
频率 ★★★★☆ | 难度 进阶
一句话结论
命名向量的索引与量化按向量逐项配置,某一向量启用压缩不影响其他向量;查询时必须指明使用哪个命名向量,配置隔离度高于单向量集合。
概念解释
- 配置粒度:向量级距离度量、索引类型、量化算法各自独立。
- 写入回填:新增命名向量后,历史对象需重新生成该向量。
- 查询指定:nearText/nearVector 等操作需绑定目标命名向量,避免歧义。
原理流程
定义向量 A/B 及配置 → 写入分别编码 → 检索指定向量 A → 结果按 A 空间排序
切换模型 = 新增命名向量 → 双写对比 → 灰度切到新向量
代码 / 命令
# 待确认:各客户端命名向量配置 API 名称与查询入参,以官方客户端文档为准
# 容量核算:多个命名向量内存按各自大小与压缩分别累加
常见误区
- 误区:一个向量开 PQ,其他自动跟着压缩。正解:压缩按向量独立启用。
- 误区:查询不指定命名向量也能默认命中。正解:多向量集合需显式选择目标向量。
追问
- 问:命名向量越多越好吗?答:每个向量都占内存与构建时间,只保留有检索价值的空间。
- 问:淘汰旧向量怎么做?答:先停止写入与查询引用,确认无流量后从配置移除,再清理历史数据。
05.6.4.1-024 倒排索引支撑哪些检索行为?
频率 ★★★★☆ | 难度 进阶
一句话结论
除向量索引外,Weaviate 维护倒排索引,支撑文本分词后的 BM25 关键词检索与标量字段等值、范围、包含等过滤,是 hybrid 与 where 条件的基础。
概念解释
- 全文部分:text 字段分词建倒排,供 BM25 与关键词匹配。
- 过滤部分:标量字段按值建索引,加速 where 条件定位。
- 双索引协作:向量索引负责近邻,倒排负责关键词与过滤,hybrid 阶段合并两路结果。
原理流程
写入对象 → 文本分词建倒排 → 标量值建过滤索引 → 向量建向量索引
检索:向量走 ANN,关键词/过滤走倒排,结果按策略合并
代码 / 命令
# 观察:集合倒排占用、字段索引数量、过滤条件命中字段是否有索引支撑
# 待确认:各 dataType 索引开关与缓存配置,以官方索引文档为准
常见误区
- 误区:建了向量索引就自动支持标量过滤。正解:过滤依赖倒排/标量索引,未纳入索引会退化为扫描。
- 误区:所有字段都建过滤索引最优。正解:索引占内存与写入成本,只对真实过滤字段建。
追问
- 问:新增过滤字段要重建吗?答:索引可在数据上补齐,但需观察回填阶段内存与构建压力。
- 问:BM25 召回差看哪里?答:先看字段是否为 text、分词是否合理、查询词是否被停用词或大小写影响。
05.6.4.1-025 可过滤字段应该怎么设计?
频率 ★★★★☆ | 难度 进阶
一句话结论
过滤字段应具备明确基数、稳定取值与真实查询场景:高选择性字段适合等值/范围过滤,枚举与时间字段优先建索引,自由文本不应当作过滤条件。
概念解释
- 基数选择:区分度高的字段过滤收益大;低基数字段过滤后仍命中大量对象。
- 类型匹配:状态用 string/int,时间用 date,地理用 geoCoordinates,范围比较用 number/int。
- 稳定优先:频繁变更的过滤值会增加索引更新成本。
原理流程
梳理查询条件 → 按选择性与类型选 dataType → 纳入过滤索引 → 写入校验取值规范
慢查询复盘:确认字段是否被索引、选择率是否足够
代码 / 命令
# 设计检查:租户/时间/状态/权限位是否建模为可过滤字段
# 避免:长文本、拼接 JSON 当过滤条件;一字段承载多种语义
常见误区
- 误区:过滤条件越多检索越快。正解:选择率低的条件叠加后候选仍很大,索引收益有限。
- 误区:手机号、身份证号存 text 便于过滤。正解:精确标识应存可精确匹配类型,避免分词干扰。
追问
- 问:权限过滤怎么做?答:角色/可见范围建模为标量字段或多租户隔离,查询强制带条件。
- 问:时间范围怎么选类型?答:date 类型支持时间比较与排序,避免字符串存时间。
05.6.4.1-026 过滤字段与全文检索字段如何取舍?
频率 ★★★☆☆ | 难度 进阶
一句话结论
需要关键词语义匹配的长文本用 text 走 BM25;需要精确等值、范围、枚举判断的短值用标量字段走过滤;同一信息不要既当全文又当低基数字段反复复制。
概念解释
- 全文字段:标题、正文、摘要,参与分词与相关性打分。
- 过滤字段:分类、标签、状态、时间、租户、地理坐标。
- 冗余控制:派生字段可由业务侧生成,但要避免多份取值不一致。
原理流程
字段用途归类 → 全文匹配用 text;精确/范围用标量类型
建集合分别配置倒排与过滤索引,检索按路径调用
代码 / 命令
# 典型组合:正文 text(BM25/向量)+ 分类 string(过滤)+ 创建时间 date(范围)
常见误区
- 误区:整段长文本存 string 又想用关键词搜。正解:string 偏精确匹配,全文检索用 text。
- 误区:标签拼成逗号串存一个字段。正解:多值标签应按多值字段或引用建模,便于包含类过滤。
追问
- 问:多值标签怎么过滤?答:使用支持多值包含操作符的字段类型,具体操作符以官方过滤文档为准。
- 问:字段命名怎么减少歧义?答:语义单一、命名前缀区分用途,如 status、category、tenant_key。
05.6.4.1-027 autoTenantCreation 与租户生命周期怎么管理?
频率 ★★★★☆ | 难度 进阶
一句话结论
默认写入不存在的租户会报错;开启 autoTenantCreation 后可在写入时自动创建租户,租户生命周期仍需主动管理激活、停用与离卸,避免空租户堆积。
概念解释
- 显式建租户:控制严格,适合租户可预知、需配额审核的场景。
- 自动建租户:降低接入代码复杂度,但需防范误写生成大量空租户。
- 生命周期:创建 → 活跃 → 停用/离卸 → 清理,各状态有不同读写约束。
原理流程
评估是否自动建租户 → 开启或显式管理 → 租户写入/查询 → 定期盘点闲置租户 → 停用或离卸
代码 / 命令
# 配置字段与可用版本待确认,以官方多租户文档为准
# 运维检查:租户数量趋势、空租户比例、离卸租户占比
常见误区
- 误区:自动建租户后无需管理。正解:每个租户占分片资源,必须有清理与配额策略。
- 误区:停用租户仍可正常读写。正解:停用/离卸状态下读写受限,需按状态规则处理。
追问
- 问:批量导入与单条插入的自动建租户行为一致吗?答:两路径可用版本不同,需以官方文档标注为准。
- 问:租户改名怎么处理?答:租户名是隔离键,改名等价于迁移到新租户,需导出重建。
05.6.4.1-028 租户状态 active / inactive / offloaded 与备份有什么关系?
频率 ★★★☆☆ | 难度 高级
一句话结论
租户分活跃、停用与离卸等状态;备份默认只覆盖在磁盘持有数据的活跃/停用租户,离卸到冷存储的租户数据不包含在备份内,需先加载回集群再备份。
概念解释
- active:数据在线,可读写。
- inactive:数据在磁盘,按规则可读,不驻留内存。
- offloaded:整体分片迁到冷存储,未加载回集群前不可读写。
- 备份边界:各版本对 inactive/offloaded 纳入规则有差异,以对应版本文档为准。
原理流程
盘点租户状态 → 需备份的 offloaded 先回载集群 → 执行备份 → 恢复后校验对象数与抽样检索
代码 / 命令
# 待确认:当前版本备份纳入哪些状态租户,以官方备份与多租户离卸文档为准
常见误区
- 误区:备份自动包含离卸租户。正解:离卸数据不在本地磁盘,备份不覆盖,必须先回载。
- 误区:inactive 租户数据会丢失。正解:停用只是不驻留内存,数据仍在磁盘;离卸才迁出本地。
追问
- 问:离卸租户怎么读?答:先加载回集群再查询,加载耗时取决于数据量。
- 问:备份恢复后租户状态保留吗?答:状态随备份信息保留,但数据完整性需抽样核验。
05.6.4.1-029 多租户集合的分片与大租户隔离怎么规划?
频率 ★★★☆☆ | 难度 高级
一句话结论
多租户集合中每个租户占用独立分片单元,租户数量直接决定分片与元数据规模;超大租户应通过独立集合、额外副本或隔离部署避免拖慢同集合其他租户。
概念解释
- 小租户模型:大量小租户共享集合,分片开销随租户数增长。
- 大租户风险:单租户对象/向量过大会挤占节点内存与查询资源。
- 隔离分级:共享集合 + 租户隔离 → 大租户独立集合 → 必要时独立实例。
原理流程
按租户规模分层 → 小租户入多租户集合 → 大租户单独建模 → 配配额与租户级监控
观察租户级 QPS、对象数与内存,发现热点再隔离
代码 / 命令
# 指标维度:按租户统计对象数、向量数、查询延迟、内存占用
# 待确认:租户级配额与资源限制能力,以官方多租户文档为准
常见误区
- 误区:多租户天然防大租户影响小租户。正解:共享节点资源,大租户热点仍会波及邻居。
- 误区:租户越多分片越细越好。正解:海量小租户带来元数据与调度开销,需控制规模。
追问
- 问:大租户什么时候拆出去?答:内存/查询占比显著偏高,或 SLA 要求与普通租户不同步时。
- 问:跨租户统计怎么做?答:业务侧聚合,不能依赖单条查询跨租户扫描。
05.6.4.1-030 备份模块有哪几种后端?
频率 ★★★★☆ | 难度 进阶
一句话结论
备份后端包括 backup-s3、backup-gcs、backup-azure 与 backup-filesystem;前三者支持多节点生产环境,filesystem 仅限单机开发测试,且可同时启用多个后端。
概念解释
- 云对象存储:S3/GCS/Azure 适配生产多节点,凭据按模块配置。
- 本地文件系统:单机使用,不支持多节点场景。
- 多选:实例可同时启用多个备份模块,备份时指定后端。
原理流程
启用对应 backup 模块 → 配后端凭据/桶/路径 → 发起备份到指定后端 → 轮询状态完成
恢复从同后端读回,注意版本兼容
代码 / 命令
# 模块名:backup-s3 / backup-gcs / backup-azure / backup-filesystem
# 待确认:各模块配置项与环境变量名,以官方备份配置文档为准
常见误区
- 误区:filesystem 备份可直接用于集群生产。正解:只支持单机,多节点生产需云对象存储后端。
- 误区:启用模块后自动定期备份。正解:需主动发起备份任务或外部调度,模块只是存储适配。
追问
- 问:不同后端之间能迁移吗?答:支持跨存储提供方做备份恢复迁移,注意版本与数据校验。
- 问:S3 兼容存储怎么接?答:按模块访问密钥与端点配置;凭据解析顺序以官方文档为准。
05.6.4.1-031 备份粒度如何控制,include/exclude classes 怎么用?
频率 ★★★☆☆ | 难度 高级
一句话结论
备份可覆盖整个实例或指定集合,通过 include 与 exclude 列表选择范围;二者互斥使用,配合 backup_id 管理多次备份与恢复定位。
概念解释
- 全量:不指定列表时备份实例内全部集合。
- 子集:include 只备份列出集合;exclude 排除列出集合。
- 标识:backup_id 区分备份版本,命名大小写处理规则以服务端为准。
原理流程
确定备份范围 → 选后端与 backup_id → 写 include 或 exclude → 发起并等待完成 → 校验内容
恢复按 backup_id 与后端定位
代码 / 命令
# 待确认:备份接口字段名,以客户端与 REST 文档为准
# 备份记录:id、后端、包含集合、完成时间、对象数校验值
常见误区
- 误区:include 与 exclude 可同时写。正解:二者互斥,同时指定不被支持。
- 误区:备份集合就等于备份模块凭据与外部模型配置。正解:备份覆盖数据与 schema,外部凭据不在其中。
追问
- 问:部分集合备份能跨实例恢复吗?答:可以,但目标实例需具备对应模块与兼容版本。
- 问:备份失败怎么排查?答:先看后端凭据/桶权限/容量,再看备份状态接口错误阶段。
05.6.4.1-032 哪些 Schema 配置创建后不可变,变更代价是什么?
频率 ★★★★★ | 难度 进阶
一句话结论
距离度量、部分 HNSW 构建参数等属建后不可变配置;需要变更时通常新建集合并迁移数据,而不是原地改参数,工程上要在建模阶段定稳关键配置。
概念解释
- 不可变项:距离度量、建图阶段参数等与索引结构强绑定的配置。
- 可变项:查询期参数、部分索引调优项可在集合上更新。
- 变更代价:新建 schema → 双写/回填 → 比对 → 切流 → 下线旧集合,成本随数据量上升。
原理流程
建模阶段确认不可变配置 → 建集合 → 增量调可变参数
需改不可变项:建新集合 → 数据迁移 → 召回对比 → 切流 → 清理旧集合
代码 / 命令
# 上线前核对:距离度量、向量维度、索引类型、副本/分片、多租户开关
# 待确认:各配置项可变性标记,以官方 schema 配置参考为准
常见误区
- 误区:参数不对可直接在原集合改。正解:不可变项改不了,原地修改不会重建历史索引。
- 误区:schema 变更不影响在线服务。正解:迁移期间双写与比对都占资源,需低峰规划。
追问
- 问:怎么减少重建次数?答:建模阶段用代表性数据集验证模型、度量与索引参数,避免上线返工。
- 问:可变与不可变怎么区分?答:查配置参考表可变性列;拿不准按不可变处理并预留迁移方案。
05.6.4.1-033 距离度量在创建后能否修改?
频率 ★★★☆☆ | 难度 进阶
一句话结论
距离度量与向量空间绑定,集合创建后不可修改;换度量意味着比较方式改变,必须新建集合并迁移全部向量。
概念解释
- 常见度量:余弦、点积、欧氏距离等,适用场景与向量归一化要求不同。
- 绑定关系:索引按度量计算距离,历史向量无法原地换度量重算。
- 选择依据:模型输出特性、业务相似度定义与归一化情况。
原理流程
确认模型与相似度定义 → 选定度量 → 建集合 → 写入检索
需换度量:新集合 + 新向量迁移 → 对比召回 → 切流
代码 / 命令
# 待确认:当前版本支持的距离度量清单与默认值,以官方向量索引配置文档为准
常见误区
- 误区:余弦和欧氏可随便换。正解:两者数值含义与适用前提不同,换度量结果不可比。
- 误区:改度量配置后旧数据自动适配。正解:索引与向量都需重建。
追问
- 问:怎么选度量?答:按 Embedding 模型推荐与业务语义定;不确定时用同查询集对比召回。
- 问:度量选错的早期信号?答:相似度排序与人工判断明显背离、距离值分布异常。
05.6.4.1-034 集群元数据是怎么复制与共识的?
频率 ★★☆☆☆ | 难度 高级
一句话结论
集合 schema、拓扑等集群元数据需跨节点一致;较新版本使用 Raft 共识维护元数据变更,早期版本采用两阶段提交,升级时需了解该架构差异。
概念解释
- 元数据范围:集合定义、分片/副本拓扑、租户与配置信息。
- 共识作用:保证各节点对当前 schema 与拓扑认知一致。
- 版本边界:共识机制随版本演进,具体行为以官方版本说明为准。
原理流程
元数据变更请求 → 共识协议提交 → 多数节点确认 → 各节点生效 → 数据面按新拓扑路由
代码 / 命令
# 待确认:当前版本元数据共识实现与变更可用性约束,以官方复制架构与版本说明为准
常见误区
- 误区:元数据存本地磁盘随便改。正解:元数据变更需跨节点一致,单节点修改不会全局生效。
- 误区:元数据与业务数据同等规模。正解:元数据量小但一致性要求高,是协调层关键状态。
追问
- 问:元数据多数派丢失会怎样?答:schema 与拓扑变更受阻,数据读取可能仍由存活副本服务。
- 问:升级涉及共识机制变化要注意什么?答:按官方升级路径分版本推进,不要跨大版本跳跃。
05.6.4.1-035 自建实例与云托管(WCD)的能力边界怎么判断?
频率 ★★★☆☆ | 难度 进阶
一句话结论
自建换取可控性、模型模块与资源深度调优,但承担运维;云托管免运维、弹性与预置鉴权,但部分自托管模块、配置项与数据自主性受平台限制。
概念解释
- 自建:可接本地模型模块、自定义拓扑、完整日志与配置访问。
- 托管:开箱可用、自动扩缩与备份能力,模块与配额受平台提供范围约束。
- 判断:运维人力、合规与数据属地、成本曲线、峰值弹性、模块可用性。
原理流程
评估运维能力与合规 → 核对所需模块在托管是否可用 → 估算成本与弹性 → 选形态 → 保留导出迁移路径
代码 / 命令
# 成本对比含机器/存储/带宽/人力/故障损失;能力对比含模块、量化、多租户、配置开放度
常见误区
- 误区:托管一定更贵或一定更省心。正解:把人力与故障成本算进来结论会变,能力边界需逐项核对。
- 误区:托管实例可随意挂本地推理容器。正解:自托管模型模块在托管环境可能不可用。
追问
- 问:混合形态可行吗?答:核心数据自建、峰值走托管是折中,但需统一抽象层与导出演练。
- 问:如何避免锁定?答:schema 与向量可导出,保留按备份/批量导入迁回自建的方案。
05.6.4.1-036 如何估算内存与磁盘容量?
频率 ★★★★★ | 难度 进阶
一句话结论
内存按“向量本体 + 向量索引结构 + 倒排/标量索引 + 查询缓存”估算并乘以副本数;磁盘按“原始数据 + 索引文件 + 多版本段 + 日志”估算并预留增长余量,量化可显著降低内存。
概念解释
- 向量本体:对象数 × 维度 × 每维字节(float32 为 4 字节)。
- 索引放大:HNSW 图结构与邻接表额外占用,量化后大幅压缩。
- 副本放大:每个在线副本持有一份可服务数据;磁盘还需容纳历史版本与清理前数据。
原理流程
确定对象数/维度/日增量 → 选索引与量化 → 算单份内存 → × 副本 → 加倒排与缓存
磁盘:原始 + 索引 + 历史版本 + 日志 → 留 30% 以上余量 → 小规模实测回填模型
代码 / 命令
# 估算骨架:内存 ≈ N × D × bytes × (1 + 索引放大) × 副本数 + 倒排与缓存
# 验证:真实分布数据导入后读实际占用,按比例放大,不只凭向量大小估算
常见误区
- 误区:只按向量原始大小买内存。正解:图结构、倒排与副本会让实际占用明显高于向量本体。
- 误区:磁盘按原始数据一比一。正解:多版本段、索引文件与日志都会放大占用。
追问
- 问:内存不够优先做什么?答:先量化与降维,再评估分片与扩节点,并用召回指标验证代价。
- 问:构建期内存峰值和稳态哪个高?答:索引构建与回填阶段峰值往往高于稳态,规划时要单列。
05.6.4.1-037 RBAC 权限模型有哪些内置角色?
频率 ★★★☆☆ | 难度 进阶
一句话结论
授权基于角色控制,内置 root(全权)与 viewer(只读)等角色,也可按集合、租户、操作与名称过滤创建自定义角色;生产应避免全员使用全权密钥。
概念解释
- 内置角色:root 拥有全部操作权限,viewer 只读。
- 自定义角色:按资源范围(集合/租户/备份等)与操作粒度授权。
- 配合认证:先认证身份,再按角色判定集合级与操作级权限。
原理流程
认证通过 → 加载用户角色 → 操作请求匹配角色策略 → 允许/拒绝 → 记录审计
按最小权限拆分服务账号与只读账号
代码 / 命令
# 待确认:当前版本 RBAC 可用范围、角色与权限项清单,以官方授权文档为准
常见误区
- 误区:API key 认证就等于授权完成。正解:认证只确认身份,权限仍需角色策略约束。
- 误区:一个全权密钥给所有内部服务。正解:权限过大且无法按操作审计,应拆分。
追问
- 问:只读角色能做备份吗?答:取决于角色策略定义;备份属独立资源操作,需单独授权。
- 问:权限变更何时生效?答:按服务端策略加载机制生效,缓存与刷新规则以官方文档为准。
05.6.4.1-038 generative 与 rerank 模块在部署链路中的边界是什么?
频率 ★★★☆☆ | 难度 高级
一句话结论
vectorizer 负责入库与查询编码,reranker 在召回后对候选重排,generative 在检索结果之上拼装上下文调用大模型生成答案;三者职责独立,模块需分别启用并配置凭据。
概念解释
- vectorizer:决定入库与查询向量,属召回前置。
- reranker:对召回候选做相关性重排,增加一次推理延迟。
- generative:不改变检索排序,只把命中文档作为上下文交给生成模型。
原理流程
入库:vectorizer 编码 → 存向量
查询:召回(向量/BM25/hybrid)→ rerank 重排 → generative 取上下文生成答案
代码 / 命令
# 模块类别:text2vec/multi2vec 向量器、rerank 重排、generative 生成
# 待确认:当前版本各提供方模块名与配置项,以官方模块参考为准
常见误区
- 误区:generative 模块能提升检索召回。正解:生成只消费检索结果,检索质量差会直接传导到答案。
- 误区:开了 rerank 就可放大召回数量不设限。正解:重排候选越多延迟越高,需控制候选规模。
追问
- 问:rerank 失败要不要阻断主链路?答:可降级为返回原始召回顺序,保证检索可用。
- 问:生成答案引用了不存在的文档怎么办?答:字段选择与上下文边界由调用方控制,返回时保留命中文档溯源。
05.6.4.1-039 写入在集群内的复制与确认流程是怎样的?
频率 ★★★★☆ | 难度 高级
一句话结论
写入经协调节点并行分发到目标分片全部副本,按一致性级别等待指定数量副本确认后返回;未确认副本由后台修复补齐,写入延迟主要受等待副本数与最慢副本影响。
概念解释
- 全量扩散:数据写入目标是所有副本,一致性级别只改变确认门槛。
- 确认收集:协调者汇总副本 ACK,达到级别要求即返回,超时按错误处理。
- 落后修复:未及时确认的副本后续通过自动修复追平。
原理流程
对象校验 → 路由目标分片 → 并行写全部副本 → 按级别收集 ACK → 返回成功/失败
后台:落后副本修复 → 对象数与向量一致
代码 / 命令
# 观察:写入 P99、各副本确认耗时、副本落后数、失败重试比例
# 一致性级别选择见 05.6.4.3 一致性专题
常见误区
- 误区:ONE 级别写入只落一个副本。正解:全副本都写,ONE 仅等待一份确认。
- 误区:写入返回成功就保证所有副本已一致。正解:低级别下其他副本可能短暂落后。
追问
- 问:写入超时怎么判断有没有落库?答:按主键幂等重试,并通过点查与副本对象数核对。
- 问:副本写失败会自动重试吗?答:客户端与服务端各有重试机制,业务侧需保证主键幂等。
05.6.4.1-040 节点上下线与分片再均衡如何工作?
频率 ★★★☆☆ | 难度 高级
一句话结论
新节点注册后参与分片分配,集群把部分分片副本迁到新节点以均衡负载;下线节点前需确认其上分片副本已有存活拷贝,再均衡期间产生加载带宽与内存峰值。
概念解释
- 扩容:新节点加入 → 拓扑更新 → 分片/副本再分配 → 数据加载完成后承接流量。
- 缩容:先迁移或确认副本冗余 → 节点下线 → 校验剩余节点容量。
- 峰值:再均衡会拉取数据到新节点,短期占用网络与内存。
原理流程
新增节点注册 → 协调拓扑 → 分片副本迁移 → 加载完成 → 流量分摊
下线前:核对副本分布 → 迁走或确认冗余 → 优雅停机 → 观察剩余节点
代码 / 命令
# 观察:新节点内存爬升、分片数量分布、查询 P99、再均衡进度
# 操作建议:低峰扩缩容,限速迁移,避免与批量导入叠加
常见误区
- 误区:节点加入后立即可承接全量流量。正解:要等分片加载完成,否则查询命中冷分片延迟飙升。
- 误区:直接关机下线即可。正解:未确认副本冗余就下线会造成分片不可用。
追问
- 问:再均衡不均怎么办?答:检查分片大小与节点资源,必要时人工触发迁移或调整分片配置。
- 问:缩容后空间不足怎么预警?答:按剩余节点内存/水位设阈值,低于阈值禁止继续下线。
05.6.4.1-041 模块版本与实例版本的兼容关系怎么管理?
频率 ★★☆☆☆ | 难度 高级
一句话结论
模块能力、客户端 API 与服务端版本相互绑定,升级前要核对实例版本、模块清单、客户端 SDK 三者兼容矩阵,避免新 SDK 调用旧服务端不存在的接口。
概念解释
- 兼容维度:服务端版本、启用模块版本、客户端 SDK 版本、外部模型接口。
- 风险点:新特性在旧版本不可用,旧模块在新实例可能被移除或行为变更。
- 管理方式:版本清单入库,升级按矩阵逐项确认。
原理流程
梳理当前版本清单 → 查官方兼容矩阵 → 预发升级 → 回归写入/检索/混合/备份 → 灰度 → 全量
代码 / 命令
# 待确认:各客户端与服务端兼容版本范围,以官方客户端文档与版本说明为准
# 记录:实例版本、模块名及版本、SDK 版本、外部模型端点
常见误区
- 误区:只升级服务端不管 SDK。正解:SDK 与服务端接口契约不匹配会导致调用报错。
- 误区:跨多个大版本直接升级。正解:应按官方建议版本路径分阶段推进。
追问
- 问:升级后某模块不可用怎么办?答:先查模块是否仍在启用清单与支持范围,再回退实例或替换模块。
- 问:兼容性问题怎么提前暴露?答:预发用真实集合与查询集回归,而不是只验证能启动。
05.6.4.1-042 自提供向量出现维度不一致怎么排查?
频率 ★★★★☆ | 难度 高级
一句话结论
维度不一致通常源于模型切换、版本漂移、向量截断或批量混写;排查从失败对象向量长度、生成管线模型版本、集合声明维度三处对照定位。
概念解释
- 常见来源:查询与入库模型不同、向量被截断/补零、多版本模型结果混入。
- 表现:写入校验失败、检索距离异常、同类对象相似度背离。
- 定位顺序:先看报错对象向量长度,再看生成侧模型与维度,最后核对集合索引维度。
原理流程
记录失败对象 id → 取向量长度 → 对照集合维度与模型输出 → 查生成管线模型版本
定位混入批次 → 修正管线 → 重建受影响数据 → 回归检索
代码 / 命令
# 检查:模型名/版本、归一化、向量长度、批次时间、是否截断或拼接
# 待确认:服务端维度校验报错返回字段,以 API 文档为准
常见误区
- 误区:维度不一致只是 warning 可继续检索。正解:距离计算按固定维度进行,混维度会产生错误结果。
- 误区:查询向量维度错了服务端会自动纠正。正解:服务端不做模型换算,错误由调用方修正。
追问
- 问:历史数据混了两种维度怎么办?答:按批次定位,隔离重建到对应集合或命名向量,不要在同一空间混用。
- 问:上线前怎么防住?答:写入前校验向量长度与归一化,管线锁定模型版本并记录批次元数据。
05.6.4.1-043 用命名向量做多模型迁移与双写怎么做?
频率 ★★★☆☆ | 难度 高级
一句话结论
模型迁移采用“新增命名向量 → 双写生成新旧向量 → 影子读对比召回 → 灰度切流 → 下线旧向量”路径,保证迁移期可回滚且新旧空间互不污染。
概念解释
- 双写:同一对象同时生成旧模型向量与新模型命名向量。
- 对比:用同一查询集比较新旧向量召回质量与延迟。
- 切流:查询逐步从旧向量切到新向量,保留旧向量一段时间便于回退。
原理流程
定义新命名向量 → 回填历史对象 → 增量双写 → 影子读对比 → 灰度切查询 → 观察 → 移除旧向量
代码 / 命令
# 对比指标:recall@k、P99、命中差异;回滚条件:新向量召回不达标即切回
# 待确认:命名向量回填与删除的客户端 API,以官方文档为准
常见误区
- 误区:新模型直接覆盖旧向量。正解:无对比与回退路径,召回下降时无法快速恢复。
- 误区:回填完成后增量就不用双写。正解:切流完成前增量必须继续双写。
追问
- 问:回填期间查询走哪个向量?答:走旧向量,新向量只做影子对比,不影响线上排序。
- 问:两个模型维度不同能放同一集合吗?答:作为独立命名向量可以,各自维度独立;不能共用一条向量。
05.6.4.1-044 大对象与长文本字段建模有什么边界?
频率 ★★☆☆☆ | 难度 高级
一句话结论
超长文本与大二进制不应整体塞进向量库:文本应切片后分段入库,原始大文件放对象存储并以引用标识关联,向量库只保存检索所需片段与元数据。
概念解释
- 文本切片:长文档按 chunk 切分,每段对象带位置与来源引用。
- 大文件:blob 仅适合受限二进制场景,大文件走外部存储。
- 检索边界:向量库不承担原文全文存档与下载服务职责。
原理流程
原文 → 切片/抽取元数据 → 片段入库(向量 + 来源引用)→ 检索命中片段 → 业务侧回原文定位
大文件存对象存储,库内只存引用
代码 / 命令
# 对象保留:chunk 文本、标题、来源 id、位置序号、时间/权限等过滤字段
# 待确认:单对象大小限制与 blob 适用边界,以官方对象与 schema 文档为准
常见误区
- 误区:整篇长文存一个对象再做语义检索。正解:长文压进单一向量会丢失细粒度语义,需切片。
- 误区:向量库存原图/原视频。正解:大二进制成本高且检索效率差,应存引用。
追问
- 问:片段之间怎么保持上下文?答:对象间保留顺序与来源引用,必要时查询后拼装相邻片段。
- 问:片段更新怎么同步?答:按来源文档版本重建对应片段,避免新旧 chunk 混杂。
05.6.4.1-045 租户离卸(offload-s3)的机制与读写约束是什么?
频率 ★★★☆☆ | 难度 高级
一句话结论
离卸把整个租户分片迁到冷对象存储以释放本地资源,离卸期间租户不可读写,需先加载回集群才能查询;该能力依赖对应离卸模块且有存储提供方限制。
概念解释
- 用途:长期不活跃租户冷存,降低在线内存与磁盘占用。
- 约束:离卸数据不在本地,未回载前读写被拒绝。
- 模块边界:离卸模块与备份模块不同,可用存储提供方与版本以官方文档为准。
原理流程
判定冷租户 → 触发离卸 → 分片写入冷存储 → 本地释放 → 标记 offloaded
需要访问 → 回载集群 → 恢复读写 → 完成后可再次离卸
代码 / 命令
# 待确认:offload 模块名、支持存储提供方、回载接口与版本要求,以官方离卸文档为准
常见误区
- 误区:离卸等同于备份。正解:离卸是冷热分层,仍需独立备份覆盖可恢复性要求。
- 误区:离卸租户在查询里会被自动拉回。正解:需显式回载,直接查询会因状态受限失败。
追问
- 问:回载慢影响什么?答:冷租户首次访问延迟升高,需预热或接受高延迟并告知业务。
- 问:离卸后备份怎么处理?答:离卸数据不进本地备份,需先回载再备份,或单独管理冷存储副本。
05.6.4.1-046 版本升级前要做哪些兼容性检查?
频率 ★★★★☆ | 难度 高级
一句话结论
升级前核对服务端版本路径、模块清单与配置变更、客户端 SDK 兼容、索引与 schema 兼容、备份可回滚,并在预发完成写入/检索/混合/备份回归。
概念解释
- 版本路径:确认能否从当前版本直接升到目标版本,避免跨大版本跳跃。
- 配置变更:参数改名、默认值变化、废弃模块都要排查。
- 数据兼容:旧索引文件、向量格式、租户状态是否需要重建或迁移。
- 回滚准备:保留旧版本镜像与备份快照。
原理流程
盘点当前版本与配置 → 读变更说明 → 预发升级 → 回归主链路 → 灰度观察 → 全量
异常时按回滚路径恢复并校验元数据与数据
代码 / 命令
# 检查清单:实例版本、模块及版本、SDK 版本、不可变配置、索引类型、备份状态、外部端点
# 待确认:目标版本变更项与废弃说明,以官方版本发布说明为准
常见误区
- 误区:小版本升级无风险。正解:默认值、配置项与索引实现都可能变化。
- 误区:升级后不重建索引行为完全一致。正解:部分索引或量化实现变更后需按说明重建。
追问
- 问:升级失败怎么回滚?答:保留旧镜像与升级前备份,回滚后校验集合可读写、分片可加载。
- 问:滚动升级期间注意什么?答:在途请求与副本一致性受影响,低峰操作并观察查询错误率。
05.6.4.1-047 备份恢复演练要覆盖哪些环节?
频率 ★★★☆☆ | 难度 高级
一句话结论
恢复演练要在隔离环境完成“选后端 → 恢复 schema 与数据 → 校验对象数与向量 → 抽样检索 → 核对租户与过滤字段”,并记录 RTO 与数据一致性结论。
概念解释
- 恢复前置:目标实例模块与版本兼容,必要时先建 schema。
- 校验内容:对象总数、命名向量存在性、租户状态、抽样相似度命中。
- 版本注意:特定旧版本存在备份恢复相关修复,恢复前需核对版本要求。
原理流程
取备份 → 隔离环境恢复 → 校验对象数/向量/租户 → 抽样检索对比 → 记录耗时与差异 → 修正备份策略
代码 / 命令
# 待确认:备份恢复版本注意事项与兼容要求,以官方备份文档版本说明为准
# 演练记录:备份时间、后端、恢复耗时、对象数偏差、抽样召回结果
常见误区
- 误区:备份文件存在就算可恢复。正解:没做过恢复演练的备份不可信。
- 误区:恢复后能写入就代表数据完整。正解:必须核对对象数、向量与抽样检索,而不只看接口成功。
追问
- 问:跨版本恢复要注意什么?答:按官方兼容范围选目标版本,超出范围先升到中间版本。
- 问:备份包含外部模型配置吗?答:不包含外部提供方凭据与模型设置,恢复后需重新配置模块。
05.6.4.1-048 设计一个 RAG 场景的 Weaviate 架构与 Schema,怎么组织?
频率 ★★★★★ | 难度 高级
一句话结论
按“规模与过滤维度定集合/多租户 → 定向量化与索引 → 选向量来源 → 设计切片与元数据字段 → 配副本与一致性 → 留备份监控与迁移路径”给出完整方案,并标注假设与验证方式。
概念解释
- 输入:文档数与 chunk 数、向量维度、日增量、QPS 与 P99 目标、租户/时间/权限过滤维度。
- 关键决策:向量来源、索引类型与量化、分片副本、多租户还是字段隔离、混合检索与重排链路。
- 交付物:集合 schema、资源清单、部署拓扑、扩容阈值、监控告警与压测计划。
原理流程
1) 估对象数/维度/增量 2) 定向量来源与命名向量 3) 定索引与量化
4) 定分片副本与隔离方式 5) 设计切片与过滤字段 6) 配备份/监控/升级路径
7) 真实分布压测 recall@k 与 P99 8) 灰度上线与回滚预案
代码 / 命令
# 表达:先说假设 → 再说方案 → 再说取舍理由 → 最后说如何验证
# Schema 骨架:chunk 文本 + 来源/标题/时间/权限/租户字段 + 向量配置 + 索引/副本/多租户配置
常见误区
- 误区:直接说“上集群加模块”。正解:无规模假设与数字依据的方案不可信。
- 误区:忽略权限与租户过滤。正解:权限过滤维度会影响集合/多租户建模与查询强制条件设计。
追问
- 问:峰值 QPS 高、平时低怎么办?答:弹性扩缩 + 限流 + 降级,避免长期高配;检索侧控制候选与重排规模。
- 问:如何验证方案可行?答:用真实分布数据集压测 recall@k 与 P99,小规模真实数据回填内存模型后再放量。
参考来源
- Weaviate 官方文档(概念与数据结构):https://docs.weaviate.io/weaviate/concepts/data
- Weaviate 集合与 Schema 配置参考:https://docs.weaviate.io/weaviate/config-refs/schema/vector-index
- Weaviate 模块参考(向量器 / 重排 / 生成):https://docs.weaviate.io/weaviate/modules
- Weaviate 认证与授权文档:https://docs.weaviate.io/weaviate/configuration/authz-authn.html
- Weaviate 备份配置文档:https://docs.weaviate.io/deploy/configuration/backups
- Weaviate 多租户文档:https://docs.weaviate.io/weaviate/manage-collections/multi-tenancy