Weaviate中skip_vectorization与vectorize_property_name参数作用解析

首先给出Weaviate中配置属性的签名：

wvc.config.Property(
    *,
    name: str,
    data_type: weaviate.collections.classes.config.DataType,
    description: Optional[str] = None,
    index_filterable: Optional[bool] = None,
    index_searchable: Optional[bool] = None,
    nested_properties: Union[weaviate.collections.classes.config.Property, List[weaviate.collections.classes.config.Property], NoneType] = None,
    skip_vectorization: bool = False,
    tokenization: Optional[weaviate.collections.classes.config.Tokenization] = None,
    vectorize_property_name: bool = True,
) -> None

其中两个关键参数的基础定义：

• skip_vectorization: 是否跳过属性的向量化。默认值为False。
• vectorize_property_name: 是否对属性名称进行向量化。默认值为True。

问题 #

向量数据库是向量到具有多个属性的对象的映射，请问这两个参数分别控制属性向量化、属性名称向量化的作用是什么？

一、skip_vectorization 的作用 #

这个参数直接决定属性的内容是否会被纳入对象向量的计算过程：

• 设为False（默认）时：属性里的文本、数值等内容会被Weaviate的向量化模型处理，成为对象最终向量的一部分。
• 设为True时：该属性的内容完全不参与向量化，不会对对象的向量产生任何影响。
• 实用场景：比如order_id（纯数字标识）、create_time（日期格式）这类不需要参与语义检索的属性，跳过向量化能节省计算资源，还能避免无关信息干扰向量的语义精准度。

二、vectorize_property_name 的作用 #

这个参数控制属性的名称是否要加入向量计算：

• 设为True（默认）时：属性名（比如product_review）会和属性内容一起被向量化，让向量同时包含"这个内容是什么类型"的语义信息。
• 设为False时：只有属性的内容会被向量化，属性名本身不会对向量产生影响。
• 实用场景：如果属性名是有意义的（比如user_feedback），包含它能让向量更准确反映对象的结构语义；但如果属性名是无意义的缩写（比如uid），关掉这个参数可以避免引入无效噪声。

内容的提问来源于stack exchange，提问作者figs_and_nuts