대량 내보내기 작업을 실행합니다. - AWS IoT SiteWise

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

대량 내보내기 작업을 실행합니다.

대량 내보내기는 작업 AWS IoT SiteWise 공간에서 Amazon S3 버킷으로 메타데이터를 이동하는 작업입니다.

AWS IoT SiteWise 콘텐츠를 Amazon S3로 대량 내보내는 경우 필터를 지정하여 내보내려는 특정 자산 모델 및 자산을 제한할 수 있습니다.

필터는 JSON 요청의 소스 iotSiteWiseConfiguration 섹션 내 섹션에 지정해야 합니다.

참고

요청에 여러 필터를 포함할 수 있습니다. 일괄 작업에서는 필터 중 하나와 일치하는 자산 모델 및 자산을 내보냅니다.

필터를 제공하지 않으면 대량 작업에서 모든 자산 모델 및 자산을 내보냅니다.

예 필터가 포함된 요청 본문
{ "metadataTransferJobId": "your-transfer-job-id", "sources": [ { "type": "iotsitewise", "iotSiteWiseConfiguration": { "filters": [ { "filterByAssetModel": { "assetModelId": "asset model ID" } }, { "filterByAssetModel": { "assetModelId": "asset model ID", "includeAssets": true } }, { "filterByAssetModel": { "assetModelId": "asset model ID", "includeOffspring": true } } ] } } ], "destination": { "type": "s3", "s3Configuration": { "location": "arn:aws:s3:::amzn-s3-demo-bucket" } } }

메타데이터 내보내기 (콘솔)

다음 절차는 콘솔 내보내기 작업을 설명합니다.

에서 내보내기 작업을 생성합니다. AWS IoT SiteWise Console
  1. AWS IoT SiteWise 콘솔로 이동합니다.

  2. 탐색 창에서 대량 작업 새로 만들기를 선택합니다.

  3. 새 내보내기를 선택하여 내보내기 프로세스를 시작합니다.

  4. 메타데이터 내보내기 페이지에서:

    • 내보내기 작업의 이름을 입력합니다. Amazon S3 버킷에서 내보낸 파일에 사용되는 이름입니다.

    • 내보낼 리소스를 선택하면 작업에 대한 필터가 설정됩니다.

      • 모든 자산 및 자산 모델을 내보냅니다. 에셋 및 에셋 모델에 필터를 사용합니다.

      • 자산 내보내기. 자산을 기준으로 필터링합니다.

        • 내보내기 필터에 사용할 자산을 선택합니다.

        • (선택 사항) 자손 또는 관련 자산 모델을 추가합니다.

      • 자산 모델을 내보냅니다. 자산 모델을 기준으로 필터링합니다.

        • 내보내기 필터에 사용할 자산 모델을 선택합니다.

        • (선택 사항) 하위 자산이나 관련 자산 또는 둘 다를 추가합니다.

      • Next(다음)를 선택합니다.

    • Amazon S3 버킷으로 이동합니다.

      • Amazon S3 버킷과 파일을 보려면 [Amazon S3 찾아보기] 를 선택합니다.

      • 파일을 배치해야 하는 Amazon S3 버킷으로 이동합니다.

      • Next(다음)를 선택합니다.

    • 내보내기 작업을 검토하고 내보내기를 선택합니다.

  5. SiteWise 메타데이터 대량 작업 페이지에는 새로 생성된 가져오기 작업이 작업 진행 테이블에 AWS IoT SiteWise Console 표시됩니다.

메타데이터를 내보낼 때 필터를 사용하는 다양한 방법에 대한 내용은 을 참조하십시오메타데이터 내보내기 예제.

메타데이터 내보내기 (AWS CLI)

다음 절차는 AWS CLI 내보내기 작업을 설명합니다.

Amazon AWS IoT SiteWise S3로 데이터 내보내기
  1. 요청 JSON 본문을 사용하여 파일을 생성합니다. 요청 본문은 전송 작업의 소스와 대상을 지정합니다. 다음 예시는 요청 본문의 예를 보여줍니다.

    { "metadataTransferJobId": "your-transfer-job-Id", "sources": [{ "type": "iotsitewise" }], "destination": { "type": "s3", "s3Configuration": { "location": "arn:aws:s3:::amzn-s3-demo-bucket" } } }

    Amazon S3 버킷을 메타데이터 전송 작업의 대상으로 지정해야 합니다.

    참고

    이 예제는 모든 자산 모델 및 자산을 내보냅니다. 내보내기를 특정 자산 모델 또는 자산으로 제한하려면 요청 본문에 필터를 포함시킬 수 있습니다. 내보내기 필터 적용에 대한 자세한 내용은 을 참조하십시오메타데이터 내보내기 예제.

  2. 다음 단계에서 사용할 수 있도록 요청 본문 파일을 저장합니다. 이 예시에서 파일의 이름은 createMetadataTransferJobExport.json으로 지정됩니다.

  3. 다음 AWS CLI 명령을 CreateMetadataTransferJob 실행하여 를 호출합니다.

    aws iottwinmaker create-metadata-transfer-job --region us-east-1 \ --cli-input-json file://createMetadataTransferJobExport.json

    입력 JSON 파일을 자체 전송 파일 createMetadataTransferJobExport.json 이름으로 바꿉니다.