# 获取数据项

只能通过 `Table` 对象获取一个记录项 `Record` 实例，`Table` 对象提供三种获取记录项：

1. `createRecord()`: 创建一个空的记录项。
2. `getWithoutData(recordId: xxxx)`: 获取一个只有 Id 的记录项。
3. `get(recordId) { }` : 从知晓云获取指定 Id 的记录详情。

## 创建一个空的数据项

```
let record = table.createRecord()
```

```
BaaSRecord *record = [table createRecord];
```

该方法常用于新增数据项和批量更新数据，先创建一个空的数据项，设置记录值，并将这些记录信息上传到知晓云数据表。详见 [新增数据项](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/create-record)

## 获取一个只有 Id 的数据项

```
let record = table.getWithoutData(recordId: xxxx)
```

```
BaaSRecord *record = [table getWithoutDataWithRecordId: xxxx];
```

该方法常用于更新一条记录项，先获取一个只有 `Id` 的数据项，并设置记录值。详见 [更新数据项](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/update-record)

## 获取数据项详情

**示例代码**

```
let select = ["name", "created_by"]
let expand = ["created_by"]
table.get("5caae446ce8e9e5be81bba48", select: select, expand: expand) { (record, error) in

}
```

```
NSArray *select = @[@"color", @"created_by"];
NSArray *expand = @[@"created_by"];
[_table get:@"5ca47715d625d83705971cec" select:select expand:expand completion:^(BaaSRecord * _Nullable record, NSError * _Nullable error) {
                        
}];
```

**参数说明**

| 参数       | 类型     | 必填 | 说明                                                                                              |
| -------- | ------ | -- | ----------------------------------------------------------------------------------------------- |
| recordId | String | Y  | 记录 Id                                                                                           |
| select   | Array  | N  | 指定筛选的字段，详见[数据表 - 字段过滤](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/select-and-expand)章节 |
| expand   | Array  | N  | 指定扩展的字段，详见[数据表 - 字段扩展](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/select-and-expand)章节 |

**返回结果**

| 名称     | 类型      | 说明                                                                                               |
| ------ | ------- | ------------------------------------------------------------------------------------------------ |
| record | Record  | 数据项实例, 关于 `Record` 类型查看 [数据类型](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/data-type) 章节 |
| error  | NSError | 错误信息，参考[错误处理和错误码](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/error-code)                       |

常见错误：

| 错误码 | 可能的原因  |
| --- | ------ |
| 404 | 数据行不存在 |

### 字段过滤与扩展

请参考[数据表 - 字段过滤](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/select-and-expand)章节

## 访问数据项属性

数据项属性包括内置属性和自定义属性，其中内置属性详见 [Record](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/data-type)

**访问内置字段**

```
record.Id      
record.created_by       
record.created_at      
...                  // 其他内置字段类似方式获取
```

```
record.Id  
record.created_by   
record.created_at      
...                   // 其他内置字段类似方式获取
```

**访问自定义字段**

```
record.get("keyName")
```

```
[record get:@"keyName"];
```

如果访问了**不存在**的属性，会返回 **`nil`**。