接口变更说明
- 新增：表示此次版本新增的接口。
- 修改：表示本接口相比于上个版本有修改。
- 删除：表示该接口在此次版本已经删除。
- 退出声明：表示该接口自作出退出声明的版本起停止演进，且在声明一年后退出并删除。
类名/API原型 |
变更类别 |
变更说明 |
变更版本 |
|---|---|---|---|
AscendIndexIVFSQT的void setFuzzyK(int value)接口 |
修改 |
(0, nlists]->(0, 10]; |
5.0.0 |
AscendIndexIVFSQT的getListLength、getListCodesAndIds、setMemoryLimit、setAddTotal、setPreciseMemControl、fineTune、setMerge、setLowerBound |
修改 |
不支持。后续将会删除。 |
5.0.0 |
AscendIndexInt8的getDim |
新增 |
去掉了public的成员d，现在需要通过getDim接口来获取d的值。 |
5.0.0 |
AscendIndexInt8的getNTotal |
新增 |
去掉了public的成员ntotal，现在需要通过getNTotal接口来获取ntotal的值。 |
5.0.0 |
AscendIndexInt8的isTrained |
新增 |
去掉了public的成员is_trained，现在需要通过isTrained接口来判断是否训练过。 |
5.0.0 |
AscendIndexInt8的getMetricType |
新增 |
去掉了public的成员metric_type，现在需要通过getMetricType接口获取metric_type的值。 |
5.0.0 |
AscendIndexInt8的public成员：d、ntotal、is_trained、metric_type |
删除 |
去掉了这些public的成员，新增了相应的get接口来获取对应的值。 |
5.0.0 |
SQ、IVFSQ、IVFSQT的public成员sq |
删除 |
删除public成员，不支持访问。 |
5.0.0 |
IndexILFlat用例代码编译命令 |
修改 |
新增so路径链接依赖。 |
6.0.RC1 |
AscendIndexFlat的search_with_masks |
新增 |
新增带mask过滤查找接口。 |
6.0.RC1 |
AscendIndexTS的GetBaseByRange |
新增 |
新增基于范围获取底库接口。 |
6.0.RC1 |
AscendIndexBinaryFlat所有接口中的Index::idx_t |
修改 |
由于faiss1.7.4内部idx_t类型所属命名空间变动，为与faiss1.7.4保持一致，接口中涉及类型为faiss::Index::idx_t的参数全部改为faiss::idx_t。 |
6.0.RC1 |
AscendIndexBinaryFlat的AscendIndex，AscendIndexFlatAT， AscendIndexIVFSP， AscendIndexBinaryFlat中的search接口 |
修改 |
const SearchParameters *params: faiss1.7.4的可选参数，默认为“nullptr”，暂不支持该参数。 |
6.0.RC1 |
修改 |
AscendIndexFlat新增支持维度768 |
6.0.RC1 |
|
修改 |
AscendIndexFlat新增支持维度768，2048，3072，4096 |
6.0.RC1 |
|
修改 |
新增功能描述：默认devices为{ 0 }，使用第0个昇腾AI处理器进行计算，默认resources为128MB，默认useKmeansPP为false |
6.0.RC1 |
|
修改 |
新增功能描述：默认devices为{ 0 }，使用第0个昇腾AI处理器进行计算，默认resources为128MB。 |
6.0.RC1 |
|
修改 |
新增功能描述：默认devices为{ 0 }，使用第0个昇腾AI处理器进行计算，默认resources为384MB。 |
6.0.RC1 |
|
修改 |
新增功能描述：默认devices为{ 0 }，使用第0个昇腾AI处理器进行计算，默认resources为384MB。 |
6.0.RC1 |
|
AscendIndexCluster的Init |
修改 |
AscendIndexCluster算法Init接口resourceSize变量使用默认值128M。 |
6.0.RC2 |
AscendIndexBinaryFlat的AscendIndexBinaryFlat构造函数 |
修改 |
AscendIndexBinaryFlat构造函数新增参数usedFloat，用于设置入库为二进制、检索特征为float类型的检索方式（search接口）的性能提升。 |
6.0.RC2 |
AscendIndexBinaryFlat的AscendIndexBinaryFlat的search接口 |
新增 |
AscendIndexBinaryFlat新增 入库特征为二进制特征，检索特征为float类型的检索方式。 |
6.0.RC2 |
AscendIndexInt8Flat的AscendIndexInt8FlatConfig |
修改 |
“resourceSize”配置的值不超过16 * 1024MB（16 * 1024 * 1024 * 1024字节）。 |
6.0.RC3 |
AscendIndexInt8Flat的AscendIndexInt8FlatConfig |
修改 |
“resourceSize”配置的值不超过16 * 1024MB（16 * 1024 * 1024 * 1024字节） |
6.0.RC3 |
AscendIndexTS的Init |
修改 |
修改“maxFeatureRowCount”参数约束。 |
6.0.RC3 |
AscendIndexInt8Flat的setPageSize |
新增 |
设置该AscendIndexInt8Flat在search时一次性连续计算底库的block数量。 |
6.0.RC3 |
AscendIndexTS的InitWithExtraVal |
新增 |
实例带附加属性的初始化函数。 |
6.0.RC3 |
AscendIndexTS的AddWithExtraVal |
新增 |
添加附加属性特征接口。 |
6.0.RC3 |
AscendIndexTS的GetBaseByRangeWithExtraVal |
新增 |
基于范围查询带附加属性的底库。 |
6.0.RC3 |
AscendIndexTS的GetExtraValAttrByLabel |
新增 |
获取指定Label特征的属性。 |
6.0.RC3 |
AscendIndexTS的ExtraValAttr |
新增 |
附加属性信息。 |
6.0.RC3 |
AscendIndexTS的ExtraValFilter |
新增 |
附加属性过滤器。 |
6.0.RC3 |
AscendIndexBinaryFlat的setRemoveFast |
新增 |
AscendIndexBinaryFlat设置是否快速删除底库中的向量。 |
6.0.RC3 |
新增 |
新增AscendIndexVStar新算法 |
6.0.RC3 |
|
新增 |
新增AscendIndexGreat新算法 |
6.0.RC3 |
|
AscendIndexIVFSQT的setSearchParams |
新增 |
设置影响检索精度和性能的参数 |
6.0.RC3 |
AscendIndexIVFSQT的setNumProbes |
退出声明 |
预计2025年9月废除，请使用setSearchParams |
6.0.RC3 |
AscendIndexIVFSQT的updateTParams |
退出声明 |
预计2025年9月废除，请使用setSearchParams |
6.0.RC3 |
AscendIndexTS的SetSaveHostMemory |
新增 |
设置使用节约host内存模式的接口 |
6.0.0 |
AscendIndex的add |
新增 |
Flat算法新增支持fp16数据底库入库函数 |
6.0.0 |
AscendIndex的add_with_ids |
新增 |
Flat算法新增支持fp16数据底库带id入库函数 |
6.0.0 |
AscendIndex的search |
新增 |
Flat算法新增支持fp16数据检索函数 |
6.0.0 |
AscendIndexFlatsearch_with_masks |
新增 |
Flat算法新增支持fp16数据带mask检索函数 |
6.0.0 |
AscendIndexIVFSP的AscendIndexIVFSP |
新增 |
共享码本的构造函数 |
6.0.0 |
AscendIndexIVFSP的saveAllData |
新增 |
存储IVFSP数据至内存中 |
6.0.0 |
AscendIndexIVFSP的loadAllData |
新增 |
从内存中恢复IVFSP |
6.0.0 |