查询 (Where)

数据类型对应查询操作符表

数据类型可使用的查询操作说明
string=, in, notIn, !=, isNull, isNotNull, contains, matches, exists, notExists
integer=, >, >=, <, <=, !=, in, notIn, isNull, isNotNull, exists, notExists
number=, >, >=, <, <=, !=, in, notIn, isNull, isNotNull, exists, notExists
array=, in, notIn, isNull, isNotNull, arrayContains, exists, notExistsfile、geojson、object、date 类型的 array 不支持查询操作。如果进行查询,会返回空数组
boolean=, exists, notExists, isNull, isNotNull
date=, >, >=, <, <=, exists, notExists, isNull, isNotNull
fileisNull, isNotNull, exists, notExists
geojsoninclude, within, withinCircle, exists, notExists, isNull, isNotNull
object=, hasKey, isNull, isNotNull, exists, notExists
pointer=, in, notIn, !=, isNull, isNotNull, exists, notExists
  • 使用查询时,字段必须满足相应的类型。(请先查阅上表)
  • file、geojson、object、date 类型的 array 不支持查询操作。如果进行查询,会返回空数组

操作步骤

1.通过 tableNametableId 实例化一个 Table 对象,操作该对象即相当于操作对应的数据表,这里推荐用 tableName

示例代码

  1. // 通过 tableId 创建数据表实例
  2. let table = Table(Id: "1236")
  3. // 通过 tablename 创建数据表实例
  4. let table = Table(name: "Book")
  1. // 通过 tableId 创建数据表实例
  2. BaaSTable *table = [[BaaSTable alloc] initWithId: @"1236"];
  3. // 通过 tablename 创建数据表实例
  4. BaaSTable *table = [[BaaSTable alloc] initWithName:@"Book"];

参数说明

tableName 和 tableID 二选一

名称类型说明
tableIdString数据表的 Id
tableNameString数据表名

2.创建 Where 对象,在该对象上添加查询条件

  1. let whereargs = Where.contains("color", value: "red")
  1. BaaSWhere *where = [BaaSWhere contains:@"color" value:@"red"];

查看下面的文档,了解目前支持的查询条件

3.设置查询条件并执行查找操作

  1. let query = Query()
  2. query.where = whereargs
  3. table.find(query: query) { (listResult, error) in
  4. }
  1. BaaSQuery *query = [[BaaSQuery alloc] init];
  2. query.where = where;
  3. [table findWithQuery:query completion:^(BaaSRecordList * _Nullable listResult, NSError * _Nullable error) {
  4. }];

参数说明

参数类型必填说明
queryQueryN查询条件

返回结果

名称类型说明
listResultRecordList结果列表,详见 数据类型 章节
errorNSError错误信息,参考错误处理和错误码

注意:知晓云的 api URL 长度限定为 16386,超出则返回 502,请在构造查询条件时注意长度控制,如 in 操作符后边的数组长度、match 操作符后边的字符串长度等。

示例

示例代码

  1. // 设置查询条件
  2. let whereargs = Where.contains("color", value: "red")
  3. // 应用查询条件
  4. let query = Query()
  5. query.where = whereargs
  6. table.find(query: query) { (listResult, error) in
  7. }
  1. // 设置查询条件
  2. BaaSWhere *where = [BaaSWhere icontains:@"color" value:@"red"];
  3. // 应用查询条件
  4. BaaSQuery *query = [[BaaSQuery alloc] init];
  5. query.where = where;
  6. [table findWithQuery:query completion:^(BaaSRecordList * _Nullable listResult, NSError * _Nullable error) {
  7. }];

比较查询

  1. // 价钱小于等于 10
  2. let whereargs = Where.compare("price", operator: .greaterThanOrEqualTo, value: 10)

operator 说明:

类型说明
equalTo=
notEqualTo!=
greaterThan>
greaterThanOrEqualTo>=
lessThan<
lessThanOrEqualTo<=
  1. // 价钱小于等于 10
  2. BaaSWhere *where = [BaaSWhere compare:@"price" operator: BaaSOperatorGreaterThanOrEqualTo value:@10];

operator 说明:

类型说明
BaaSOperatorEqualTo=
BaaSOperatorNotEqualTo!=
BaaSOperatorGreaterThan>
BaaSOperatorGreaterThanOrEqualTo>=
BaaSOperatorLessThan<
BaaSOperatorLessThanOrEqualTo<=

字符串查询

查询返回满足包含相应字符串的记录,如下示例:

  1. // name 列包含 apple
  2. let whereargs = Where.contains("name", value: "apple")
  3. // name 列包含 apple (不区分大小写)
  4. let whereargs = Where.icontains("name", value: "apple")
  1. // name 列包含 apple
  2. BaaSWhere *where = [BaaSWhere contains:@"name" value:@"apple"];
  3. // name 列不包含 app
  4. BaaSWhere *where = [BaaSWhere icontains:@"color" value:@"app"];

正则匹配

构造正则表达式语法

  1. regex = "/pattern/flags"
  • pattern: 匹配模式
  • flags: 修饰符,如下表介绍
flag介绍
gglobal match; find all matches rather than stopping after the first match
iignore case; if u flag is also enabled, use Unicode case folding
mmultiline; treat beginning and end characters (^ and $) as working over multiple lines (i.e., match the beginning or end of each line (delimited by \n or \r), not only the very beginning or end of the whole input string)
s"dotAll"; allows . to match newlines
uUnicode; treat pattern as a sequence of Unicode code points
zsticky; matches only from the index indicated by the lastIndex property of this regular expression in the target string (and does not attempt to match from any later indexes).

正则表达式,使用的是 JavaScript 的语法规则,请参考 RegExp

代码示例

  1. /* 以查找名字为例,name 字段必须为 String 类型 */
  2. // 查找 以 foo 开头的名字,并且对大小写不敏感
  3. let regExp = "/^foo/i"
  4. let whereargs = Where.matches("name", regx: regExp)
  5. /* 以查找手机号码为例,phoneNumber 字段必须为 string 类型 */
  6. // 查找 以 188 开头的手机号码
  7. let regx = "/^188/"
  8. // 查找 以 708 结尾的手机号码
  9. let regx = "/708$/"
  10. // 查找 以 188 开头的手机号码,以 708 结尾的手机号码
  11. let regx = "/^188\d+708$/"
  12. let whereargs = Where.matches('phoneNumber', regx: regx)
  1. /* 以查找名字为例,name 字段必须为 NSString 类型 */
  2. // 查找 以 foo 开头的名字,并且对大小写不敏感
  3. NSString *regx = @"/^foo/i";
  4. BaaSWhere *where = [BaaSWhere matches:@"name" regx: regx];
  5. /* 以查找手机号码为例,phoneNumber 字段必须为 NSString 类型 */
  6. // 查找 以 188 开头的手机号码
  7. NSString *regx = @"/^188/";
  8. // 查找 以 708 结尾的手机号码
  9. NSString *regx = @"/708$/";
  10. // 查找 以 188 开头的手机号码,以 708 结尾的手机号码
  11. NSString *regx = @"/^188\d+708$/";
  12. BaaSWhere *where = [BaaSWhere matches:@"phoneNumber" regx: regx];

数组查询

  • inList

数据表中的 field 的类型不限制,field 的 value 含有 array 中的一个或多个

  1. let whereargs = Where.inList("fieldname", list: array)
  1. BaaSWhere *where = [BaaSWhere inList: @"fieldname" list: array];
  • notInList

数据表中的 field 的类型不限制,field 的 value 不含有 array 中的任何一个

  1. let whereargs = Where.notInList("fieldname", list: array)
  1. BaaSWhere *where = [BaaSWhere notInList: @"fieldname" list: array];
  • arrayContains

数据表中的 field 的类型必须为数组, field 的 value 包含 array 中的每一个

  1. let whereargs = Where.arrayContains("fieldname", list: array)
  1. BaaSWhere *where = [BaaSWhere arrayContains: @"fieldname" list: array];

如果希望查找数组中只包含指定数组中所有的值的记录,可以使用比较查询

  1. let whereargs = Where.compare("fieldname", operator: .equalTo, value: array)
  1. BaaSWhere *where = [BaaSWhere compare:@"keyname" operator:BaaSOperatorEqualTo value: array]

null 或非 null 查询

查询字段值为 null 或非 null 记录

  1. let whereargs = Where.isNull("name")
  2. let whereargs = Where.isNotNull("name")
  1. BaaSWhere *where = [BaaSWhere isNull:@"name"];
  2. BaaSWhere *where = [BaaSWhere isNotNull:@"name"];

空或非空查询

查询字段值为空或非空记录

  1. let whereargs = Where.exists("name")
  2. let whereargs = Where.notExists("name")
  1. BaaSWhere *where = [BaaSWhere exists:@"name"];
  2. BaaSWhere *where = [BaaSWhere notExists:@"name"];

hasKey 查询 (仅限 object 类型)

参数说明

参数类型必填说明
keyString在数据表中的类型必须是 Object
valueString需要检测的属性名, 只能包含字母、数字和下划线,必须以字母开头

示例代码

假设数据表有如下数据行

  1. [
  2. {
  3. 'id': '59a3c2b5afb7766a5ec6e84e',
  4. name: '战争与和平',
  5. publisherInfo: {
  6. name: 'abc出版社',
  7. },
  8. },
  9. {
  10. 'id': '59a3c2b5afb7766a5ec6e84g',
  11. name: '西游记',
  12. publisherInfo: {
  13. name: 'efg出版社',
  14. location: '广东省广州市天河区五山路 100 号'
  15. },
  16. },
  17. ]

查询字段 publisherInfo 中存在 location 属性的数据行

  1. let whereargs = Where.hasKey("publisherInfo", fieldName: "location")
  1. BaaSWhere *where = [BaaSWhere hasKey:@"publisherInfo" fieldName:@"location"];

目前暂不支持查询内嵌属性

假设数据行如下

  1. [
  2. {
  3. 'id': '59a3c2b5afb7766a5ec6e84g',
  4. name: '西游记',
  5. publisherInfo: {
  6. abc: {
  7. name: 'efg出版社',
  8. location: '广东省广州市天河区五山路 100 号'
  9. }
  10. },
  11. }
  12. ]

则下面的查询语句是非法的

  1. let whereargs = Where.hasKey("publisherInfo", fieldName: "abc.location")
  1. BaaSWhere *where = [BaaSWhere hasKey:@"publisherInfo" fieldName:@"abc.location"];

pointer 查询

目前 pointer 仅支持针对 pointer 本身的查询,不支持嵌套查询(即查询 pointer 指向的数据行的字段)

示例代码

假设现在有两张表: Book 表和 Author 表。

order 表部分字段结构如下:

字段名字段类型说明
authorpointer指向了 Author

现在需要查询 Book 表中,同时满足以下条件的数据行:

  • author 字段指向 Author 表中 id 为 5bad87ab0769797b4fb27a1b 的数据行
  1. let bookTable = Table(name: "Book")
  2. let authorTable = Table(name: "Author")
  3. let author = authorTable.getWithoutData(recordId: "5bad87ab0769797b4fb27a1b")
  4. let whereArgs = Where.compare("customer", operator: .equalTo, value: author)
  1. // 通过 tableId 创建数据表实例
  2. BaaSTable *bookTable = [[BaaSTable alloc] initWithId: "Book"];
  3. BaaSTable *authorTable = [[BaaSTable alloc] initWithId: "Author"];
  4. BaaSRecord *author = [authorTable getWithoutDataWithRecordId:@"5bad87ab0769797b4fb27a1b"];
  5. BaaSWhere *where = [BaaSWhere compare:@"customer" operator:BaaSOperatoEqualThan value: author];

组合查询

当有多个查询时,可以使用 andor 来组合查询查询条件。

  1. let args1 = Where.compare("price", operator:.lessThan , value: 10)
  2. let args2 = Where.isNull("name")
  3. // and 查询
  4. let whereargs = Where.and(wheres: [args1, args2])
  5. // or 查询
  6. let whereargs.or(wheres: [args1, args2])
  1. BaaSWhere *args1 = [BaaSWhere isNull:@"name"];
  2. BaaSWhere *args2 = [BaaSWhere compare:@"price" operator:BaaSOperatorLessThan value:@10];
  3. // and 查询
  4. BaaSWhere *where = [BaaSWhere and:@[args1, args2]];
  5. // or 查询
  6. BaaSWhere *where = [BaaSWhere or:@[args1, args2]];