使用提取数据 CreateBulkImportJob API

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

注意

要标识资产属性，请指定以下选项之一。

• 您要向其发送数据的资产属性的 ASSET_ID 和 PROPERTY_ID。

• ALIAS，这是一个数据流别名（例如，/company/windfarm/3/turbine/7/temperature）。要使用此选项，您必须首先设置资产属性的别名。要了解如何设置属性别名，请参阅将工业数据流映射到资产属性。

• ALIAS— 标识属性的别名，例如 OPC UA 服务器数据流路径（例如/company/windfarm/3/turbine/7/temperature）。有关更多信息，请参阅 将工业数据流映射到资产属性。

• 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]，双精度为 754。IEEE

  • BOOLEAN – true 或 false。

• TIMESTAMP_SECONDS – 数据点的时间戳，以 Unix 纪元时间表示。

• TIMESTAMP_NANO_OFFSET – 从 TIMESTAMP_SECONDS 转换时的纳秒偏移量。

• QUALITY –（可选）资产属性值的质量。值可以是以下值之一。

  • GOOD –（默认）数据不受任何问题的影响。

  • BAD – 数据受传感器故障等问题的影响。

  • UNCERTAIN – 数据受传感器不准确等问题的影响。

  有关如何在计算中 AWS IoT SiteWise 处理数据质量的更多信息，请参阅公式表达式中的数据质量。

• VALUE – 资产属性的值。

例 .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— 创建新的批量导入任务。

• DescribeBulkImportJob— 检索有关批量导入任务的信息。

• ListBulkImportJob— 检索所有批量导入任务摘要的分页列表。