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

# AWS IoT SiteWise 대량 가져오기 작업 생성(AWS CLI)
<a name="CreateBulkImportJob"></a>

[CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html) API 작업을 사용하여 Amazon S3에서 AWS IoT SiteWise에 데이터를 전송할 수 있습니다. [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html) API를 사용하면 대량의 기록 데이터를 수집하고 분석 데이터 스트림을 소규모 배치로 버퍼링된 수집할 수 있습니다. 데이터 수집을 위한 비용 효과적인 기본 원칙을 제공합니다. 다음 예제에서는 AWS CLI를 사용합니다.

**중요**  
대량 가져오기 작업을 생성하기 전에 AWS IoT SiteWise 웜 티어 또는 AWS IoT SiteWise 콜드 티어를 활성화해야 합니다. 자세한 내용은 [에서 스토리지 설정 구성 AWS IoT SiteWise](configure-storage.md) 단원을 참조하십시오.  
 [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html) API는 adaptive-ingestion-flag 파라미터를 설정하는 옵션을 AWS IoT SiteWise 사용하여 과거 데이터를에 수집할 수 있도록 지원합니다.  
`false`로 설정하면 API는 계산 또는 알림을 트리거하지 않고 기록 데이터를 수집합니다.
`true`로 설정하면 API는 새 데이터를 수집하여 지표를 계산하고 데이터를 변환하여 7일 이내에 지속적인 분석 및 알림을 최적화합니다.

다음 명령을 실행합니다. {{file-name}}을 대량 가져오기 작업 구성이 포함된 파일의 이름으로 바꿉니다.

```
aws iotsitewise create-bulk-import-job --cli-input-json file://{{file-name}}.json
```

**Example 일괄 가져오기 작업 구성**  
다음은 구성 설정의 예입니다.  
+ {{adaptive-ingestion-flag}}를 `true` 또는 `false`로 바꿉니다.
  + `false`로 설정하면 일괄 가져오기 작업이 기록 데이터를 AWS IoT SiteWise로 수집합니다.
  + `true`로 설정하면 일괄 가져오기 작업은 다음을 수행합니다.
    + 새 데이터를에 수집합니다 AWS IoT SiteWise.
    + 지표를 계산하고 변환하며 7일 이내에 타임스탬프가 지정된 데이터에 대한 알림을 지원합니다.
+ {{delete-files-after-import-flag}}를 로 바꾸`true`어 AWS IoT SiteWise 웜 티어 스토리지에 수집한 후 Amazon S3 데이터 버킷에서 데이터를 삭제합니다.
+ amzn-s3-demo-bucket{{-for-errors}}를 이 일괄 가져오기 작업과 관련된 오류가 전송되는 Amazon S3 버킷의 이름으로 바꿉니다.
+ amzn-s3-demo-bucket{{-for-errors-prefix}}를 이 일괄 가져오기 작업과 관련된 오류가 전송되는 Amazon S3 버킷의 접두어로 바꿉니다.

  Amazon S3에서는 접두사를 버킷의 폴더 이름으로 사용합니다. 각 Amazon S3 객체에는 버킷의 고유 식별자인 키가 있습니다. 버킷 내 각 객체는 정확히 하나의 키를 갖습니다. 접두사는 슬래시(/)로 끝나야 합니다. 자세한 내용을 알아보려면 *Amazon Simple Storage Service 사용 설명서*의 [접두어를 사용한 객체 구성](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html)을 참조하세요.
+ amzn-s3-demo-bucket{{-data}}를 데이터를 가져오는 Amazon S3 버킷의 이름으로 바꿉니다.
+ {{data-bucket-key}}를 데이터가 들어 있는 Amazon S3 객체의 키로 대체합니다. 각 객체에는 고유 식별자인 키가 있습니다. 각 객체에는 정확히 하나의 키가 있습니다.
+ {{data-bucket-veron-id}}를 버전 ID로 바꾸면 데이터가 들어 있는 Amazon S3 객체의 특정 버전을 식별할 수 있습니다. 이 파라미터는 선택 사항입니다.
+ {{column-name}}을 .csv 파일에 지정된 열 이름으로 대체하세요.
+ {{job-name}}을 대량 가져오기 작업을 식별하는 고유한 이름으로 대체하세요.
+ {{job-role-arn}}을 AWS IoT SiteWise 에서 Amazon S3 데이터를 읽을 수 있는 IAM 역할로 대체하세요.
역할에 다음 예에 표시된 것과 같은 권한이 있는지 확인합니다. amzn-s3-demo-bucket{{-data}}를 데이터가 포함된 Amazon S3 버킷의 이름으로 바꿉니다. 또한 {{amzn-s3-demo-bucket-for-errors}}를 이 일괄 가져오기 작업과 관련된 오류가 전송되는 Amazon S3 버킷의 이름으로 바꿉니다.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "s3:GetObject",
                "s3:GetBucketLocation"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket{{-data}}",
                "arn:aws:s3:::amzn-s3-demo-bucket{{-data}}/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:GetBucketLocation"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket{{-for-errors}}",
                "arn:aws:s3:::amzn-s3-demo-bucket{{-for-errors}}/*"
            ],
            "Effect": "Allow"
        }
    ]
}
```

```
{
   "adaptiveIngestion": adaptive-ingestion-flag,
   "deleteFilesAfterImport": delete-files-after-import-flag,       
   "errorReportLocation": { 
      "bucket": "amzn-s3-demo-bucket{{-for-errors}}",
      "prefix": "amzn-s3-demo-bucket{{-for-errors-prefix}}"
   },
   "files": [ 
      { 
         "bucket": "{{amzn-s3-demo-bucket-data}}",
         "key": "{{data-bucket-key}}",
         "versionId": "{{data-bucket-version-id}}"
      }
   ],
   "jobConfiguration": { 
      "fileFormat": { 
         "csv": { 
            "columnNames": [ "{{column-name}}" ]
         }
      }
   },
   "jobName": "{{job-name}}",
   "jobRoleArn": "{{job-role-arn}}"    
}
```

**Example response**  

```
{
   "jobId":"f8c031d0-01d1-4b94-90b1-afe8bb93b7e5",
   "jobStatus":"PENDING",
   "jobName":"myBulkImportJob"
}
```