View a markdown version of this page

使用资产和模型进行批量操作 - 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工作区即可执行此操作。您只需要一个可在其中放置 AWS IoT SiteWise内容的 Amazon S3 存储桶。

主题

关键概念和术语

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。

  • Top-level 资源：可以单独创建或更新的AWS IoT SiteWise资源，例如资产或资产模型。

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

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

  • 元数据 TransferJob：运行时创建的对象CreateMetadataTransferJob。

支持的功能

本主题说明了在运行批量操作时您可以完成哪些任务。批量操作支持以下功能：

  • Top-level 资源创建：当您导入的资产或资产模型未定义 ID，或者其 ID 与现有资产或资产模型的 ID 不匹配时，它将被创建为新资源。

  • Top-level 资源替换：当您导入的资产或资产模型的ID与已经存在的资产或资产模型相匹配时，它将替换现有资源。

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

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

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