Ingerir datos mediante la API CreateBulkImportJob - AWS IoT SiteWise

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ingerir datos mediante la API CreateBulkImportJob

Utilice la CreateBulkImportJob API para importar grandes cantidades de datos de Amazon S3. Los datos deben guardarse en formato CSV en Amazon S3. Los archivos de datos pueden tener las siguientes columnas.

nota

Para identificar una propiedad de un activo, especifique una de las siguientes opciones.

  • La ASSET_ID y PROPERTY_ID de la propiedad del activo al que va a enviar los datos.

  • El ALIAS, que es un alias de flujo de datos (por ejemplo, /company/windfarm/3/turbine/7/temperature). Para utilizar esta opción, primero debe establecer el alias de la propiedad del activo. Para aprender a configurar los alias de las propiedades, consulte Asignación de flujos de datos industriales a propiedades de activos.

  • ALIAS: el alias que identifica la propiedad, como una ruta de flujo de datos del servidor OPC-UA (por ejemplo, /company/windfarm/3/turbine/7/temperature). Para obtener más información, consulte Asignación de flujos de datos industriales a propiedades de activos.

  • ASSET_ID: el ID del activo.

  • PROPERTY_ID: el ID de la propiedad del activo.

  • DATA_TYPE: el tipo de datos de la propiedad puede ser uno de los siguientes.

    • STRING – Una cadena con hasta 1024 bytes.

    • INTEGER: un entero de 32 bits con signo con rango [-2.147.483.648, 2.147.483.647].

    • DOUBLE: un número de punto flotante con rango [-10^100, 10^100] e IEEE 754 doble precisión.

    • BOOLEAN – true o false.

  • TIMESTAMP_SECONDS: la marca temporal del punto de datos, con la hora en formato Unix.

  • TIMESTAMP_NANO_OFFSET: el desplazamiento de nanosegundos convertido de TIMESTAMP_SECONDS.

  • QUALITY: (opcional) La calidad del valor de la propiedad del activo. El valor puede ser uno de los siguientes:

    • GOOD: (predeterminado) los datos no se ven afectados por ningún problema.

    • BAD: los datos se ven afectados por un problema, como un fallo del sensor.

    • UNCERTAIN: los datos se ven afectados por un problema, como la falta de precisión de un sensor.

    Para obtener más información sobre cómo se AWS IoT SiteWise gestiona la calidad de los datos en los cálculos, consulte Calidad de los datos en las expresiones de fórmulas.

  • VALUE: el valor de la propiedad del activo.

ejemplo archivo(s) de datos en formato .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 proporciona las siguientes operaciones de API para crear un trabajo de importación masiva y obtener información sobre un trabajo existente.