

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

# 使用资产和模型进行批量操作
<a name="bulk-operations-assets-and-models"></a>

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

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


**Topics**
+ [关键概念和术语](#bulk-operations-terminology)
+ [支持的功能](#bulk-operations-functionality)
+ [批量操作先决条件](bulk-operations-prereqs.md)
+ [运行批量导入作业](running-bulk-operations-import.md)
+ [运行批量导出作业](running-bulk-operations-export.md)
+ [作业进度跟踪和错误处理](jobs-progress-error-handling.md)
+ [导入元数据示例](bulk-operations-import-metadata-example.md)
+ [导出元数据示例](bulk-operations-export-filter-examples.md)
+ [Amazon IoT SiteWise 元数据传输任务架构](bulk-operations-schema.md)

## 关键概念和术语
<a name="bulk-operations-terminology"></a>

Amazon IoT SiteWise 批量导入和导出功能依赖于以下概念和术语：
+ **导入**：将资产或资产模型从 Amazon S3 存储桶中的文件移动到 Amazon IoT SiteWise的操作。
+ **导出**：将资产或资产模型从 Amazon S3 存储桶移 Amazon IoT SiteWise 至 Amazon S3 存储桶的操作。
+ **源**：您要从中移动内容的起始位置。

  例如，Amazon S3 存储桶既是导入源，又 Amazon IoT SiteWise 是导出源。
+ **目标**：您要将内容移动到的所需位置。

  例如，Amazon S3 存储桶是导出目的地， Amazon IoT SiteWise 也是导入目的地。
+ **Amazon IoT SiteWise 架构**：此架构用于从中导入和导出元数据 Amazon IoT SiteWise。
+ **顶级资源：**可以单独创建或更新的 Amazon IoT SiteWise 资源，例如资产或资产模型。
+ **子资源：**顶级 Amazon IoT SiteWise 资源中的嵌套资源。示例包括属性、层次结构和复合模型。
+ **元数据**：成功导入或导出资源所需的关键信息。元数据的示例包括资产和资产模型的定义。
+ **metadataTransferJob**：运行时创建的对象`CreateMetadataTransferJob`。

## 支持的功能
<a name="bulk-operations-functionality"></a>

本主题说明了在运行批量操作时您可以完成哪些任务。批量操作支持以下功能：
+ **顶级资源创建：**导入未定义 ID 的资产或资产模型或者其 ID 与现有资产或资产模型不匹配的资产或资产模型时，该资产或资产模型将被创建为新资源。
+ **顶级资源替换：**导入其 ID 与已存在的资产或资产模型相匹配的资产或资产模型时，该资产或资产模型将替换现有资源。
+ **子资源创建、替换或删除：**当您的导入内容替换顶级资源（例如资产或资产模型）时，新定义将替换所有子资源，例如属性、层次结构或复合模型。

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