기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS IoT TwinMaker 대량 작업
<a name="tm-import-export"></a>

metadataTransferJob을 사용하여 AWS IoT TwinMaker 리소스를 대규모로 전송하고 관리합니다. metadataTransferJob을 사용하면 대량 작업을 수행하고 AWS IoT TwinMaker 및 Amazon S3 간에 리소스를 전송할 수 AWS IoT SiteWise 있습니다.

다음 시나리오에서 대량 작업을 사용할 수 있습니다.
+ 개발 계정에서 프로덕션 계정으로 마이그레이션하는 등 계정 간 자산 및 데이터의 대량 마이그레이션.
+ 대규모 자산 업로드 및 편집과 같은 대규모 AWS IoT 자산 관리.
+ 자산을 AWS IoT TwinMaker 및 로 대량 가져옵니다 AWS IoT SiteWise.
+ `revit` 또는 파일과 같은 기존 온톨로지 `BIM` 파일에서 AWS IoT TwinMaker 엔터티를 대량으로 가져옵니다.

**Topics**
+ [주요 개념 및 용어](#tm-import-export-terminology)
+ [대량 가져오기 및 내보내기 작업 수행](tm-import-export-api.md)
+ [AWS IoT TwinMaker 메타데이터 전송 작업 스키마](tm-import-export-schema.md)

## 주요 개념 및 용어
<a name="tm-import-export-terminology"></a>

AWS IoT TwinMaker 대량 작업은 다음 개념과 용어를 사용합니다.
+ **가져오기**: 리소스를 워크스페이스로 이동하는 작업입니다 AWS IoT TwinMaker . 예를 들어 로컬 파일, Amazon S3 버킷의 파일 또는에서 AWS IoT TwinMaker 워크스페이스 AWS IoT SiteWise 로.
+ **내보내기**: 워크스페이스에서 AWS IoT TwinMaker 로컬 시스템 또는 Amazon S3 버킷으로 리소스를 이동하는 작업입니다.
+ **소스**: 리소스를 이동할 시작 위치입니다.

  예를 들어 Amazon S3 버킷은 가져오기 소스이고 AWS IoT TwinMaker 워크스페이스는 내보내기 소스입니다.
+ **대상**: 리소스를 이동할 위치입니다.

  예를 들어 Amazon S3 버킷은 내보내기 대상이고 AWS IoT TwinMaker 워크스페이스는 가져오기 대상입니다.
+ **AWS IoT SiteWise 스키마**: 리소스를 가져오고 내보내는 데 사용되는 스키마입니다 AWS IoT SiteWise.
+ **AWS IoT TwinMaker 스키마**: 리소스를 가져오고 내보내는 데 사용되는 스키마입니다 AWS IoT TwinMaker.
+ **AWS IoT TwinMaker 최상위 리소스**: 기존 APIs. 특히 **개체** 또는 **ComponentType**입니다.
+ **AWS IoT TwinMaker 하위 수준 리소스**: 메타데이터 정의에 사용되는 중첩 리소스 유형입니다. 특히 **구성 요소입니다**.
+ **메타데이터**: AWS IoT SiteWise 및 AWS IoT TwinMaker 리소스를 성공적으로 가져오거나 내보내는 데 필요한 주요 정보입니다.
+ **metadataTransferJob**: `CreateMetadataTransferJob`을 실행할 때 생성된 객체입니다.

### AWS IoT TwinMaker metadataTransferJob 기능
<a name="tm-import-export-rules"></a>

이 주제에서는 일괄 작업을 실행할 때 AWS IoT TwinMaker 의 동작, 즉 metadataTransferJob이 처리되는 방식에 대해 설명합니다. 또한 리소스를 전송하는 데 필요한 메타데이터를 사용하여 스키마를 정의하는 방법을 설명합니다. AWS IoT TwinMaker bulk 작업은 다음 기능을 지원합니다.
+ **최상위 리소스 생성 또는 대체:** AWS IoT TwinMaker 는 새 리소스를 생성하거나 리소스 ID로 고유하게 식별되는 모든 기존 리소스를 대체합니다.

  예를 들어 엔터티가 시스템에 있는 경우 엔터티 정의는 `Entity` 키 아래의 템플릿에 정의된 새 엔터티 정의로 대체됩니다.
+ **하위 리소스 생성 또는 교체:**

  EntityComponent 수준에서는 구성 요소만 생성하거나 교체할 수 있습니다. 개체가 이미 있어야 합니다. 그렇지 않으면 작업이 ValidationException을 생성합니다.

  속성 또는 관계 수준에서는 속성 또는 관계만 생성하거나 바꿀 수 있으며 포함된 EntityComponent가 이미 있어야 합니다.
+ **하위 리소스 삭제:**

  AWS IoT TwinMaker 는 하위 리소스 삭제도 지원합니다. 하위 리소스는 구성 요소, 속성 또는 관계일 수 있습니다.

  구성 요소를 삭제하려면 개체 수준에서 삭제해야 합니다.

  속성 또는 관계를 삭제하려면 Entity 또는 EntityComponent 수준에서 삭제해야 합니다.

  하위 리소스를 삭제하려면 상위 수준 리소스를 업데이트하고 하위 리소스의 정의를 생략합니다.
+ **최상위 리소스 삭제 없음:** AWS IoT TwinMaker 는 최상위 리소스를 삭제하지 않습니다. 최상위 리소스는 개체 또는 ComponentType을 나타냅니다.
+ **하나의 템플릿에 동일한 최상위 리소스에 대한 하위 리소스 정의가 없습니다.**

  동일한 템플릿에서 동일한 개체의 전체 개체 정의 및 하위 리소스(예: 속성) 정의를 제공할 수 없습니다.

  entityId가 Entity에서 사용되는 경우 Entity, EntityComponent, 속성 또는 관계에 동일한 ID를 사용할 수 없습니다.

  EntityComponent entityId 또는 componentName 조합을 사용하는 경우 EntityComponent, 속성 또는 관계에서 동일한 조합을 사용할 수 없습니다.

  entityId, componentName, propertyName 조합을 속성 또는 관계에 사용하는 경우 속성 또는 관계에 동일한 조합을 사용할 수 없습니다.
+ **ExternalId는 선택 사항입니다 AWS IoT TwinMaker.** ExternalId를 사용하여 리소스를 식별할 수 있습니다.