本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用 CreateBulkImportJob API 采集数据
您可以使用CreateBulkImportJob API 从Amazon S3 导入大量数据。您的数据必须以 CSV 格式保存在 Amazon S3 中。数据文件可以有以下几列。
注意
要标识资产属性的特性，您可以指定以下几项中的一项。
-
您要向其发送数据的资产属性的
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— 一个浮点数，范围为 [-10^100，10^100]，IEEE 754 双精度。 -
DOUBLE— 带符号的 32 位整数，范围为 [-2,147,483,648，2,147,483,647]。 -
BOOLEAN—true或false。
-
-
TIMESTAMP_SECONDS— 数据点的时间戳，用 Unix 纪元时间表示。 -
TIMESTAMP_NANO_OFFSET— 转换后的纳秒偏移量TIMESTAMP_SECONDS。 -
QUALITY—（可选）资产属性的质量。该值可以是以下值中的一个。-
GOOD—（默认）数据不受任何问题的影响。 -
BAD— 数据受到诸如传感器故障之类的问题的影响。 -
UNCERTAIN— 数据受到诸如传感器不准确之类的问题的影响。
有关 Amazon IoT SiteWise 如何在计算中处理数据质量的详细信息，请参阅公式表达式中的数据质量。
-
-
VALUE— 资产的价值。
例 .csv 格式的数据文件
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
Amazon IoT SiteWise提供以下 API 操作，您可以使用这些操作来创建批量导入任务和获取有关现有任务的信息。
-
CreateBulkImportJob— 创建新的批量导入任务。
-
DescribeBulkImportJob— 检索有关批量导入任务的信息。
-
ListBulkImportJob— 检索所有批量导入任务摘要的分页列表。