本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# CreateBulkImportJob API
<a name="ingest-bulkImport"></a>

使用 `CreateBulkImportJob` API 从 Amazon S3 导入大量数据。您的数据必须以 CSV 格式保存在 Amazon S3 中。数据文件可以包含以下列。

**注意**  
 不支持早于世界标准时间 1970 年 1 月 1 日 00:00:00 的数据。  
要标识资产属性，请指定以下项之一。  
您要向其发送数据的资产属性的 `ASSET_ID` 和 `PROPERTY_ID`。
`ALIAS`，这是一个数据流别名（例如，`/company/windfarm/3/turbine/7/temperature`）。要使用此选项，您必须首先设置资产属性的别名。要了解如何设置属性别名，请参阅[管理数据流 AWS IoT SiteWise](manage-data-streams.md)。
+ `ALIAS` – 标识属性的别名，例如 OPC UA 服务器数据流路径（例如，`/company/windfarm/3/turbine/7/temperature`）。有关更多信息，请参阅 [管理数据流 AWS IoT SiteWise](manage-data-streams.md)。
+ `ASSET_ID` – 资产的 ID。
+ `PROPERTY_ID` – 资产属性的 ID。
+ `DATA_TYPE` – 属性的数据类型可以是以下类型之一。
  + `STRING` – 最多 1024 字节的字符串。
  + `INTEGER` – 有符号的 32 位整数，范围是 [-2,147,483,648, 2,147,483,647]。
  + `DOUBLE` – 具有 [-10^100, 10^100] 范围和 IEEE 754 双精度的浮点数。
  + `BOOLEAN` – `true` 或 `false`。
+ `TIMESTAMP_SECONDS` – 数据点的时间戳，以 Unix 纪元时间表示。
+ `TIMESTAMP_NANO_OFFSET` – 从 `TIMESTAMP_SECONDS` 转换时的纳秒偏移量。
+ `QUALITY` –（可选）资产属性值的质量。值可以是以下值之一。
  + `GOOD` –（默认）数据不受任何问题的影响。
  + `BAD` – 数据受传感器故障等问题的影响。
  + `UNCERTAIN` – 数据受传感器不准确等问题的影响。

  有关如何在计算中 AWS IoT SiteWise 处理数据质量的更多信息，请参阅[公式表达式中的数据质量](expression-tutorials.md#data-quality)。
+ `VALUE` – 资产属性的值。

**Example .csv 格式的数据文件**  

```
asset_id,property_id,DOUBLE,1635201373,0,GOOD,1.0
asset_id,property_id,DOUBLE,1635201374,0,GOOD,2.0
asset_id,property_id,DOUBLE,1635201375,0,GOOD,3.0
```

```
unmodeled_alias1,DOUBLE,1635201373,0,GOOD,1.0
unmodeled_alias1,DOUBLE,1635201374,0,GOOD,2.0
unmodeled_alias1,DOUBLE,1635201375,0,GOOD,3.0
unmodeled_alias1,DOUBLE,1635201376,0,GOOD,4.0
unmodeled_alias1,DOUBLE,1635201377,0,GOOD,5.0
unmodeled_alias1,DOUBLE,1635201378,0,GOOD,6.0
unmodeled_alias1,DOUBLE,1635201379,0,GOOD,7.0
unmodeled_alias1,DOUBLE,1635201380,0,GOOD,8.0
unmodeled_alias1,DOUBLE,1635201381,0,GOOD,9.0
unmodeled_alias1,DOUBLE,1635201382,0,GOOD,10.0
```

AWS IoT SiteWise 提供了以下 API 操作来创建批量导入任务和获取有关现有任务的信息。
+ [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)— 创建新的批量导入任务。
+ [DescribeBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeBulkImportJob.html)— 检索有关批量导入任务的信息。
+ [ListBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListBulkImportJobs.html)— 检索所有批量导入任务摘要的分页列表。