Operaciones masivas con activos y modelos - 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.

Operaciones masivas con activos y modelos

Para trabajar con una gran cantidad de activos o modelos de activos, utilice las operaciones masivas para importar y exportar recursos de forma masiva a una ubicación diferente. Por ejemplo, puede crear un archivo de datos que defina los activos o modelos de activos en un bucket de Amazon S3 y utilizar la importación masiva para crearlos o actualizarlos AWS IoT SiteWise. Como alternativa, si tiene una gran cantidad de activos o modelos de activos AWS IoT SiteWise, puede exportarlos a Amazon S3.

nota

Las operaciones masivas se realizan AWS IoT SiteWise mediante llamadas a las operaciones de la AWS IoT TwinMaker API. Puede hacerlo sin configurar AWS IoT TwinMaker ni crear un AWS IoT TwinMaker espacio de trabajo. Todo lo que necesita es un depósito de Amazon S3 en el que pueda colocar su AWS IoT SiteWise contenido.

Conceptos y terminología clave

AWS IoT SiteWise Las funciones de importación y exportación masivas se basan en los siguientes conceptos y terminología:

  • Importación: acción de mover activos o modelos de activos de un archivo de un bucket de Amazon S3 a AWS IoT SiteWise.

  • Exportación: acción de mover activos o modelos de activos desde AWS IoT SiteWise un bucket de Amazon S3.

  • Origen: la ubicación inicial desde la que desea mover el contenido.

    Por ejemplo, un bucket de Amazon S3 es una fuente de importación y AWS IoT SiteWise una fuente de exportación.

  • Destino: la ubicación deseada a la que quieres mover el contenido.

    Por ejemplo, un bucket de Amazon S3 es un destino de exportación y AWS IoT SiteWise un destino de importación.

  • AWS IoT SiteWise Esquema: este esquema se utiliza para importar y exportar metadatos desde AWS IoT SiteWise.

  • Recurso de nivel superior: un AWS IoT SiteWise recurso que puede crear o actualizar de forma individual, como un activo o un modelo de activos.

  • Subrecurso: recurso anidado dentro de un AWS IoT SiteWise recurso de nivel superior. Los ejemplos incluyen propiedades, jerarquías y modelos compuestos.

  • Metadatos: información clave necesaria para importar o exportar los recursos correctamente. Algunos ejemplos de metadatos son las definiciones de activos y los modelos de activos.

  • metadatos TransferJob: el objeto que se crea al ejecutarCreateMetadataTransferJob.

Funcionalidades compatibles

En este tema se explica lo que puede hacer cuando ejecuta una operación masiva. Las operaciones masivas admiten las siguientes funciones:

  • Creación de recursos de nivel superior: al importar un activo o un modelo de activo que no define un identificador o cuyo identificador no coincide con el de uno existente, se creará como un recurso nuevo.

  • Reemplazo de recursos de nivel superior: cuando importas un activo o un modelo de activo cuyo ID coincide con uno que ya existe, reemplazará el recurso existente.

  • Creación, reemplazo o eliminación de subrecursos: cuando la importación reemplaza un recurso de nivel superior, como un activo o un modelo de activos, la nueva definición reemplaza a todos los subrecursos, como propiedades, jerarquías o modelos compuestos.

    Por ejemplo, si actualizas un modelo de activos durante una importación masiva y la versión actualizada define una propiedad que no estaba presente en el original, se crea una nueva propiedad. Si define una propiedad que ya existe, se actualizará la propiedad existente. Si el modelo de activos actualizado omite una propiedad que estaba presente en el original, se elimina la propiedad.

  • Sin eliminación de recursos de nivel superior: las operaciones masivas no eliminan un activo o un modelo de activos. Las operaciones masivas solo las crean o actualizan.