--- title: DataTypeForBinQuery description: "设置Input/Output用于运行时算子二进制查找的数据类型，和DataType/DataTypeList的数量一致，且一一对应。" url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_00000.html sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_00000.html indexId: efbd30f28b7eefaa711266a2efc3d15d7379724a96d9a1e4900e34b3065b8e2e77 --- # DataTypeForBinQuery #### 功能说明 设置Input/Output用于运行时算子二进制查找的数据类型，和DataType/DataTypeList的数量一致，且一一对应。 算子编译过程中，会根据数据类型生成多个.o，并通过这些数据类型在运行时索引算子二进制。某些算子支持多种数据类型，且对数据类型不敏感，这时可以使用该接口，将多种数据类型映射到同一个算子二进制，多个数据类型可以复用一个.o，从而减少二进制文件的生成。 例如，如果一个算子的输入支持多种数据类型（ge::DT_INT16 和ge::DT_INT32），并且使用ge::DT_INT16 输入时可以复用ge::DT_INT32 的二进制文件而不影响最终结果，那么可以采用如下配置： ``` this->Input("x") .ParamType(REQUIRED) .DataType({ge::DT_INT16, ge::DT_INT32}) .DataTypeForBinQuery({ge::DT_INT32, ge::DT_INT32}) .Format({ge::FORMAT_ND, ge::FORMAT_ND}); ``` 这样，只需生成一个目标文件（.o），就能实现对多种数据类型的支持。 #### 函数原型 ``` OpParamDef &DataTypeForBinQuery(std::vector types) ``` #### 参数说明 | 参数 | 输入/输出 | 说明 | | --- | --- | --- | | types | 输入 | 算子参数数据类型，ge::DataType请参考DataType(https://www.hiascend.comdocument/detail/zh/canncommercial/900/maintenref/basicdataapi/atlasopapi\_07\_00514.html)。 | #### 返回值说明 OpParamDef算子定义，OpParamDef请参考OpParamDef。 #### 约束说明 - DataTypeForBinQuery的参数个数需要和当前算子参数的DataType或者DataTypeList的参数个数保持一致。 - 不支持与 To （指定数据类型）的接口同时使用。 - 需要保证使用DataTypeForBinQuery后，产生新的算子参数属性集合（使用DataTypeForBinQuery替换原本DataType序列）存在于原本支持的参数属性集合中。 参数属性集合的定义为，算子所支持的所有参数的属性的集合，相当于一列参数的集合。 例如示例一中。算子支持四种原集合，没有重复。 1、x : DT_FLOAT16, FORMAT_ND y : DT_INT16, FORMAT_ND 2、x : DT_FLOAT, FORMAT_ND y : DT_INT16, FORMAT_ND 3、x : DT_INT16, FORMAT_ND y : DT_INT16, FORMAT_ND 4、x : DT_INT32, FORMAT_ND y : DT_INT16, FORMAT_NC 使用DataTypeForBinQuery替换原本DataType序列后，新集合为 1、x : DT_INT16, FORMAT_ND y : DT_INT16, FORMAT_ND 2、x : DT_FLOAT16, FORMAT_ND y : DT_INT16, FORMAT_ND 3、x : DT_FLOAT16, FORMAT_ND y : DT_INT16, FORMAT_ND 4、x : DT_INT16, FORMAT_ND y : DT_INT16, FORMAT_NC 此时发现，新集合1与原集合3一致，新集合2、新集合3与原集合1一致。设置生效。新集合4不属于原集合，设置失效。此时会按照原本的集合4进行编译。 #### 调用示例 - 示例一 ``` this->Input("x") .ParamType(REQUIRED) .DataType({ge::DT_FLOAT16, ge::DT_FLOAT, ge::DT_INT16, ge::DT_INT32}) .DataTypeForBinQuery({ge::DT_INT16, ge::DT_FLOAT16, ge::DT_FLOAT16, ge::DT_INT16}) .Format({ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND}); this->Output("y") .ParamType(REQUIRED) .DataType({ge::DT_INT16, ge::DT_INT16, ge::DT_INT16, ge::DT_INT16}) .Format({ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_NC}); ``` 如下图所示，没有设置DataTypeForBinQuery之前，会生成4个二进制。通过上述代码设置DataTypeForBinQuery后： - 替换后第1列使用原来第3列的二进制，第2列和第3列使用原来第1列的二进制。第4列仍使用第4列的二进制。 - 替换后，第2列和第3列完全一致，达成二进制复用的效果，算子总二进制会由原来的四个（bin1，bin2，bin3，bin4）缩减至现在的三个（bin1，bin3、bin4）。 - 示例二 1 2 3 4 5 6 7 8 9 10 // 简单用例，此时会有两对复用，1、2列->1列，3、4列->4列。总共生成1、4两个二进制。所有支持的DataType会传入这两个二进制运行。 this->Input("x") .ParamType(REQUIRED) .DataType({ge::DT_FLOAT16, ge::DT_FLOAT, ge::DT_INT16, ge::DT_INT32}) .DataTypeForBinQuery({ge::DT_FLOAT16, ge::DT_FLOAT16, ge::DT_INT32, ge::DT_INT32}) .Format({ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND}); this->Output("y") .ParamType(REQUIRED) .DataType({ge::DT_FLOAT, ge::DT_FLOAT, ge::DT_FLOAT, ge::DT_FLOAT}) .Format({ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND}); - 示例三 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 // 复杂用例，可以多个Input/Output同时使用DataTypeForBinQuery，此时也会产生两对复用。1、2列->2列，3、4列->1列。总共生成1、2两个二进制。所有支持的DataType会传入这两个二进制运行。 this->Input("x") .ParamType(REQUIRED) .DataType({ge::DT_FLOAT16, ge::DT_FLOAT, ge::DT_INT16, ge::DT_INT32}) .DataTypeForBinQuery({ge::DT_FLOAT, ge::DT_FLOAT, ge::DT_FLOAT16, ge::DT_FLOAT16}) .Format({ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND}); this->Input("y") .ParamType(REQUIRED) .DataType({ge::DT_FLOAT16, ge::DT_FLOAT, ge::DT_INT32, ge::DT_INT16}) .DataTypeForBinQuery({ge::DT_FLOAT, ge::DT_FLOAT, ge::DT_FLOAT16, ge::DT_FLOAT16}) .Format({ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND}); this->Output("z") .ParamType(REQUIRED) .DataType({ge::DT_FLOAT16, ge::DT_FLOAT, ge::DT_INT32, ge::DT_INT16}) .DataTypeForBinQuery({ge::DT_FLOAT, ge::DT_FLOAT, ge::DT_FLOAT16, ge::DT_FLOAT16}) .Format({ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND, ge::FORMAT_ND});