昇腾社区首页
中文
注册

函数:create_query_table

产品支持情况

产品

是否支持

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

x

Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件

x

Atlas 训练系列产品

x

Atlas 推理系列产品

Atlas 200I/500 A2 推理产品

x

Atlas 200/300/500 推理产品

x

功能说明

创建aclfvQueryTable类型的数据,表示创建检索输入表信息。

如需销毁aclfvQueryTable类型的数据,请参见函数:destroy_query_table

Atlas 推理系列产品 中的 Atlas 推理系列加速模块产品 不支持该接口。

函数原型

  • C函数原型
    1
    aclfvQueryTable *aclfvCreateQueryTable(uint32_t queryCnt, uint32_t tableLen, uint8_t *tableData, uint32_t tableDataLen)
    
  • python函数
    1
    query_table = acl.fv.create_query_table(query_cnt, table_len, table_data, table_data_len)
    

参数说明

参数名

说明

query_cnt

int,检索请求数量,1:N场景为1,N:M场景最大1024。

table_len

int,单个表长度,长度固定为32KB,系统内部会校验。

table_data

int,特征值列表,根据特征长度连续存储。

table_data_len

int,tableData申请的内存长度,用于校验。

返回值说明

返回值

说明

query_table

int,指针地址。

  • 返回aclfvQueryTable类型,表示成功。
  • 返回0,表示失败。

资源参考

接口调用流程及示例代码,参见特征向量检索