使用 CreateBulkImportJob API 摄取数据 - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

使用 CreateBulkImportJob API 摄取数据

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

注意

要标识资产属性,可以指定以下属性之一。

  • 您要向PROPERTY_ID其发送数据的资产属性的ASSET_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]。

    • BOOLEANtruefalse

  • 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 操作,您可以使用这些操作来创建批量导入任务和获取有关现有任务的信息。