使用资产和模型进行批量操作 - AWS IoT SiteWise

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

使用资产和模型进行批量操作

要处理大量资产或资产模型,请使用批量操作将资源批量导入和导出到其他位置。例如,您可以创建一个数据文件来定义 Amazon S3 存储桶中的资产或资产模型,然后使用批量导入在中创建或更新它们 AWS IoT SiteWise。或者,如果您有大量资产或资产模型 AWS IoT SiteWise,则可以将其导出到 Amazon S3。

注意

您可以 AWS IoT SiteWise 通过调用中的操作在中执行批量操作 AWS IoT TwinMaker API。无需设置 AWS IoT TwinMaker 或创建 AWS IoT TwinMaker 工作区即可执行此操作。您只需要一个 Amazon S3 存储桶,您可以在其中放置您的 AWS IoT SiteWise 内容。

关键概念和术语

AWS IoT SiteWise 批量导入和导出功能依赖于以下概念和术语:

  • 导入:将资产或资产模型从 Amazon S3 存储桶中的文件移动到 AWS IoT SiteWise。

  • 导出:将资产或资产模型从 Amazon S3 存储桶移 AWS IoT SiteWise 至 Amazon S3 存储桶的操作。

  • 来源:您要从中移动内容的起始位置。

    例如,Amazon S3 存储桶既是导入源,又 AWS IoT SiteWise 是导出源。

  • 目的地:您要将内容移动到的目标位置。

    例如,Amazon S3 存储桶是导出目的地, AWS IoT SiteWise 也是导入目的地。

  • AWS IoT SiteWise 架构:此架构用于从中导入和导出元数据 AWS IoT SiteWise。

  • 顶级资源:可以单独创建或更新的 AWS IoT SiteWise 资源,例如资产或资产模型。

  • 子资源:顶级 AWS IoT SiteWise 资源中的嵌套资源。示例包括属性、层次结构和复合模型。

  • 元数据:成功导入或导出资源所需的关键信息。元数据的示例包括资产和资产模型的定义。

  • metadataTransferJob:运行时创建的对象CreateMetadataTransferJob

支持的功能

本主题说明了在运行批量操作时可以做什么。批量操作支持以下功能:

  • 顶级资源创建:当您导入未定义 ID 或其 ID 与现有资源或资产模型不匹配的资产或资产模型时,它将被创建为新资源。

  • 顶级资源替换:当您导入的资产或资产模型的ID与已存在的资产或资产模型相匹配时,它将替换现有资源。

  • 子资源的创建、替换或删除:当您的导入替换顶级资源(例如资产或资产模型)时,新定义将替换所有子资源,例如属性、层次结构或复合模型。

    例如,如果您在批量导入期间更新了资产模型,并且更新后的版本定义了原始版本中不存在的属性,则会创建一个新属性。如果它定义了一个已经存在的属性,则现有属性将被更新。如果更新的资产模型省略了原始资产模型中存在的属性,则该属性将被删除。

  • 不删除顶级资源:批量操作不会删除资产或资产模型。批量操作只能创建或更新它们。