新增数据记录

操作步骤

  • 创建一个 Table 对象 table；
  • 在 table 对象创建一条空记录；
  • 为空记录赋值；
  • 将创建的记录保存到服务器。

创建 Table 对象

通过 tableName 或 tableId 实例化一个 Table 对象，操作该对象即相当于操作对应的数据表，这里推荐用 tableName。

示例代码

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

参数说明

tableName 和 tableId 二选一

名称类型说明
IdString数据表的 Id
nameString数据表名

本地创建一条空记录

  1. let record: Record = table.createRecord()
  1. BaaSRecord *record = [table createRecord];

关于 Record 类型查看 数据类型 章节

为上面创建的空记录赋值

有两种类型的赋值操作：

a.一次性赋值：

  1. record.set(["name": "bookname", "color": "red", "price": 19])

参数说明

名称类型说明
recordDictionary记录信息，key 为字段名称
  1. [record set:@{@"name": @"bookname", @"color": @"red", @"price": @10}];

参数说明

名称类型说明
recordNSDictionary记录信息，key 为字段名称

b.逐个赋值：

  1. record.set("color", value: "red")
  2. record.set("price", value: 10)
  1. [record set:@"color" value:@"red"];
  2. [record set:@"price" value:@10];

对同一字段进行多次 set 操作，后面的数据会覆盖掉前面的数据

在通过 set(key:value:) 和 set(record: ) 设置数据时，value 支持的类型包括 Int、String、Array、Dictionary 等基本数据类型，同时也支持 GeoPoint 、GeoPolygon、User、Record。

将创建的记录保存到服务器

  1. record.save { (success, error) in
  3. }
  1. [record save:^(BOOL success, NSError * _Nullable error) {
  3. }];

返回结果

名称类型说明
successBool是否新增数据成功
errorNSError错误信息，参考错误处理和错误码

若 success 为 true，本地记录实例 record 的数据将被更新。此时访问 record.get(key: "color") 为 red。

通过上面的四个步骤，即完成了一条记录的插入，具体操作阅读以下内容。

添加普通数据

假设有一个 Book 表，包括 name、author、price 等字段，表示书名、作者、价格。

请求示例

  1. // 创建 `Table` 对象
  2. let bookTable = Table(name: "Book")
  4. // 创建一条空的记录
  5. let book = bookTable.createRecord()
  7. // 设置方式一
  8. book.set(["name": "老人与海", "author": "海明威", "price": 49])
  10. // 设置方式二
  11. book.set("name", value: "老人与海");
  12. book.set("author", value: "海明威")
  13. book.set("price", value: 49)
  15. book.save { (success, error) in
  17. }
  1. // 创建 `Table` 对象
  2. BaaSTable *bookTable = [[BaaSTable alloc] initWithName:@"Book"];
  4. // 创建一条空记录
  5. BaaSRecord *book = [bookTable createRecord];
  7. // 设置方式一
  8. [book set:@{@"name": @"老人与海", @"author": @"海明威" @"price": 49}];
  10. // 设置方式二
  11. [book set:@"name" value:@"老人与海"];
  12. [book set:@"author" value:@"海明威"];
  13. [book set:@"price" value:49];
  15. [book save:^(BOOL success, NSError * _Nullable error) {
  17. }];

添加日期时间 Date 类型的数据

数据表允许添加时间日期类型的字段，为该类型的记录赋值，需要使用 ISO Date 格式的字符串，如 Book 表定义一个时间日期类型的列 publish_date，创建一条记录时，该字段的赋值操作如下：

  1. let dateISO = ISO8601DateFormatter().string(from: Date())
  2. book.set("publish_date", value: dateISO)
  3. book.save { (success, error) in
  5. }
  1. NSISO8601DateFormatter *dateFormatter = [[NSISO8601DateFormatter alloc] init];
  2. NSString *dateISO = [dateFormatter stringFromDate:[NSDate date]];
  3. [book set:@"publish_date" value:dateISO];
  4. [book save:^(BOOL success, NSError * _Nullable error) {
  6. }];

添加 file 类型数据

如 Book 表定义 file 类型的列 cover，表示书的封面。示例：获取 id 为 5c98b065d575a97d5f878225 的文件，将该文件设置为书的封面。

实例代码

  1. FileManager.get("@"5c98b065d575a97d5f878225"") { (file, error) in
  2.     book.set("cover", value: file)
  3.     book.save { (success, error) in
  5.     }
  6. }
  1. [BaaSFileManager get:@"5c98b065d575a97d5f878225", completion:^(BaaSFile * _Nullable file, NSError * _Nullable error) {
  2.     [book set:@"cover" value:file];
  3.     [book save:^(BOOL success, NSError * _Nullable error) {
  5.     }];
  6. }];

关于 File 类型查看 文件 章节

添加 file 数组类型数据

如 Book 表定义 file 数组类型的列 photos。示例：获取 id 为 5c98b065d575a97d5f878225 的文件，将该文件作为数组的一个元素添加到 photos 中。

实例代码

  1. FileManager.get("@"5c98b065d575a97d5f878225"") { (file, error) in
  2.     book.set("photos", value: [file])
  3.     book.save { (success, error) in
  5.     }
  6. }
  1. [BaaSFileManager get:@"5c98b065d575a97d5f878225", completion:^(BaaSFile * _Nullable file, NSError * _Nullable error) {
  2.     [book set:@"photos" value:@[file]];
  3.     [book save:^(BOOL success, NSError * _Nullable error) {
  5.     }];
  6. }];

关于 File 类型查看 文件 章节

添加 geojson 类型数据

详见 地理位置操作 设置地理信息小节

添加 object 类型数据

对象内的属性名只能包含字母、数字和下划线，必须以字母开头，比如 {$ifanr.x: 123} 和 {知晓云: "test"} 是错误的。

示例

假如 Book 表中的 publish_info 为 object 类型，表示出版商，其中有两个字段信息：name 表示出版商名称，location 为出版商地址。

  1. let table = Table(name: "Book")
  2. let book = table.createRecord()
  3. book.set("publish_info", value: ["name": "efg出版社", "location": "广东省广州市天河区五山路 100 号"])
  4. book.save { (success, error) in
  6. }
  1. [book set:@"publish_info" value: @{@"name": @"efg出版社", @"location": @"广东省广州市天河区五山路 100 号"}];
  2. [book save:^(BOOL success, NSError * _Nullable error) {
  4. }];

添加 array 类型数据

添加 array 类型数据的方法与添加其他类型数据的方法基本一致。区别在于，array 类型数据是将一个的数组赋值给某个字段。

array 类型数据中的元素类型，要与预先在知晓云平台设定的字段类型一致。否则创建的数据将不包含该 array 类型的字段。

示例

Book 表中的 recommender 为 array 类型，表示推荐者。

  1. book.set("recommender", value: ["yuminghong", "hua")
  2. book.save { (success, error) in
  4. }
  1. [book set:@"recommender" value: @[@"yuminghong", @"hua"]];
  2. [book save:^(BOOL success, NSError * _Nullable error) {
  4. }];

添加 pointer 类型数据

每张表最多能建立 3 个 pointer 类型的字段。如有更多需求，请提交工单说明pointer 指向的数据表，不能改名或删除

假设现在有一张 Book 表, Book 表部分字段如下:

字段名字段类型说明
commentpointer指向了 Comment 表

现在在 Book 表中新增一条数据，其中:

comment 字段指向了 Comment 表中 id 为 5bad87ab0769797b4fb27a1b 的数据行

  1. let comment = table.getWithoutData(recordId: "5bad87ab0769797b4fb27a1b")
  2. book.set("comment", value: comment)
  3. book.save { (success, error) in
  5. }
  1. BaaSRecord *comment = [table getWithoutDataWithRecordId:@"5bad87ab0769797b4fb27a1b"];
  2. [book set:@"comment" value:comment];
  3. [book save:^(BOOL success, NSError * _Nullable error) {
  5. }];

批量新增数据项

一次创建多条记录，同时根据需要设置是否触发触发器。

  1. let options = ["enable_trigger": true]
  2. table.createMany([["name": "书名六", "author": "hua", "price": 19], 
  3.                   ["name": "书名七", "author": "lin", "price": 19]], options: options) { (success, error) in
  5. }
  1. NSDictionary *options = @{@"enable_trigger": @YES};
  2. [table createMany:@[@{@"name": @"bookname", @"price": @10}, 
  3.                      @{@"name": @"bookname2", @"price": @11}] options:options completion:^(NSDictionary<NSString *,id> * _Nullable records, NSError * _Nullable error) {
  5. }];

在通过 createMany 方法新增记录时，记录值支持的类型包括 Int、Float、String、Array、Dictionary 等基本数据类型，同时也支持 GeoPoint 、GeoPolygon、User、Record。

参数说明

参数名类型说明必填
recordsDictionary符合表结构的记录数据Y
optionsDictionary批量操作选项 ，目前支持支持 enable_trigger, true 为触发触发器N

返回结果

名称类型说明
resultDictionary新增的数据结果
errorNSError错误信息，参考错误处理和错误码

error 为 nil 不说明批量写入数据完全成功，仅代表服务端已收到并处理了这个请求，只有当返回的结果中 operation_result 列表中不存在 error 元素时，才可以认为所有数据均写入成功。

返回示例

  1.  {
  2.   "succeed": 10,
  3.   "total_count": 10,
  4.   "operation_result": [
  5.     {"success": {"id": "5bfe000ce74243582bf2979f", "created_at": "1543459089"}},
  6.     {
  7.        "error": {
  8.          "code": 11000,
  9.          "err_msg": "数据写入失败，具体错误信息可联系知晓云微信客服：minsupport3 获取。"
  10.        }
  11.     }
  12.   ]
  13. }

参数说明

  • succeed: 成功创建记录数
  • total_count: 总的待创建记录数
  • operation_result: 批量写入每一条数据的结果

常见错误码

  • 201：成功写入
  • 400：非法数据
  • 403：无权限写入（表权限）