# filter语法
#### 数值类型
1. 数值类型的范围查询，\[\]包含两端点值，{}不包含两端点值。
   ```
   rowkey:[1 TO *] 大于等于1  
       rowkey:[* TO 1] 小于等于1
       rowkey:[1 TO 10] 1到10
   ```
   Request Body示例：
   ```
   {
     "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...",
     "filter" : "number:[1 TO *]"
   }
   ```
   ![](https://support.huaweicloud.com/api-face/zh-cn_image_0000002014126061.png "点击放大")
   
2. 单值。
   ```
   rowkey:1 值为1
   ```
   Request Body示例：
   ```
   {
     "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...",
     "filter" : "number:10"
   }
   ```
   ![](https://support.huaweicloud.com/api-face/zh-cn_image_0000001977501436.png "点击放大")
   
3. 多条件，使用()区分优先级。
   ```
   rowkey:[1 TO *] && externalImageID:1
       (rowkey:[1 TO *] && externalImageID:1) || timestamp:1000 
       rowkey:[1 TO *] && (externalImageID:1 || timestamp:1000)
   ```
   Request Body示例：
   ```
   {
     "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...",
     "filter" : "number:[1 TO 20] && external_image_id:test"
   }
   ```
   ![](https://support.huaweicloud.com/api-face/zh-cn_image_0000001977507000.png "点击放大")
   
4. 非，需要在非语句前后加括号。
   ```
   externalImageID:1 && (!rowkey:2)
   ```
   Request Body示例：
   ```
   {
     "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...",
     "filter" : "external_image_id:test && (!number:10)"
   }
   ```
   ![](https://support.huaweicloud.com/api-face/zh-cn_image_0000001977517088.png "点击放大")
   
 
#### 字符串类型
1. 单值
   ```
   title:quick
   ```
   Request Body示例：
   ```
   {
     "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...",
     "filter" : "id:zhangsan"
   }
   ```
   ![](https://support.huaweicloud.com/api-face/zh-cn_image_0000002014163497.png "点击放大")
   
2. 多条件
   ```
   title:quick && color:brown
   ```
   Request Body示例：
   ```
   {
     "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...",
     "filter" : "id:zhangsan && number:30"
   }
   ```
   ![](https://support.huaweicloud.com/api-face/zh-cn_image_0000002014284049.png "点击放大")
   
3. 非，使用括号分隔
   ```
   (!color:brown)
   ```
   Request Body示例：
   ```
   {
     "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...",
     "filter" : "(!id:zhangsan)"
   }
   ```
   ![](https://support.huaweicloud.com/api-face/zh-cn_image_0000002014165549.png "点击放大")
   
 
#### boolean类型
单值
```
male:true
```
![](https://support.huaweicloud.com/api-face/public_sys-resources/note_3.0-zh-cn.png)
1. 逻辑条件过多，请使用()来区分优先级。
2. 不支持空字符串，null值搜索。
 
Request Body示例：
```
{
  "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "filter" : "male:true"
}
```
![](https://support.huaweicloud.com/api-face/zh-cn_image_0000001977855590.png "点击放大")