

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

# CreateBulkImportJob API
<a name="ingest-bulkImport"></a>

`CreateBulkImportJob` API를 사용하여 Amazon S3에서 대량의 데이터를 가져옵니다. Amazon S3에 데이터를 CSV 형식으로 저장해야 합니다. 데이터 파일에는 다음과 같은 열이 있을 수 있습니다.

**참고**  
 1970년 1월 1일 00:00:00 UTC보다 오래된 데이터는 지원되지 않습니다.  
자산 속성을 식별하려면 다음 중 하나를 지정합니다.  
데이터를 보낼 자산 속성의 `ASSET_ID` 및 `PROPERTY_ID`.
데이터 스트림 별칭(예: `/company/windfarm/3/turbine/7/temperature`)인 `ALIAS`. 이 옵션을 사용하려면 먼저 자산 속성의 별칭을 설정해야 합니다. 속성 별칭을 설정하는 방법에 대한 자세한 내용은 [에 대한 데이터 스트림 관리 AWS IoT SiteWise](manage-data-streams.md) 단원을 참조하세요.
+ `ALIAS` – OPC UA 서버 데이터 스트림 경로(예: `/company/windfarm/3/turbine/7/temperature`)와 같이 속성을 식별하는 속성 별칭입니다. 자세한 내용은 [에 대한 데이터 스트림 관리 AWS IoT SiteWise](manage-data-streams.md) 단원을 참조하십시오.
+ `ASSET_ID` – 자산의 ID입니다.
+ `PROPERTY_ID` – 자산 속성의 ID입니다.
+ `DATA_TYPE` – 속성의 데이터 형식입니다. 다음 중 하나일 수 있습니다.
  + `STRING` – 최대 1,024바이트의 문자열입니다.
  + `INTEGER` – 범위가 [-2,147,483,648, 2,147,483,647]인 부호 있는 32비트 정수입니다.
  + `DOUBLE` – 범위가 [-10^100, 10^100]이고 IEEE 754 배정밀도를 갖는 부동 소수점 숫자입니다.
  + `BOOLEAN` - `true` 또는 `false`입니다.
+ `TIMESTAMP_SECONDS` - Unix Epoch 시간으로 표시된 데이터 포인트의 타임스탬프입니다.
+ `TIMESTAMP_NANO_OFFSET` - `TIMESTAMP_SECONDS`에서 변환된 나노초의 오프셋입니다.
+ `QUALITY` - (선택 사항) 자산 속성 값의 품질입니다. 값은 다음 중 하나일 수 있습니다.
  + `GOOD` - (기본값) 데이터가 어떤 문제의 영향도 받지 않습니다.
  + `BAD` – 데이터가 센서 고장과 같은 문제의 영향을 받습니다.
  + `UNCERTAIN` – 데이터가 센서 부정확과 같은 문제의 영향을 받습니다.

  가 계산에서 데이터 품질을 AWS IoT SiteWise 처리하는 방법에 대한 자세한 내용은 [공식 표현식의 데이터 품질을 참조하세요](expression-tutorials.md#data-quality).
+ `VALUE` - 자산 속성의 값입니다.

**Example .csv 형식의 데이터 파일**  

```
asset_id,property_id,DOUBLE,1635201373,0,GOOD,1.0
asset_id,property_id,DOUBLE,1635201374,0,GOOD,2.0
asset_id,property_id,DOUBLE,1635201375,0,GOOD,3.0
```

```
unmodeled_alias1,DOUBLE,1635201373,0,GOOD,1.0
unmodeled_alias1,DOUBLE,1635201374,0,GOOD,2.0
unmodeled_alias1,DOUBLE,1635201375,0,GOOD,3.0
unmodeled_alias1,DOUBLE,1635201376,0,GOOD,4.0
unmodeled_alias1,DOUBLE,1635201377,0,GOOD,5.0
unmodeled_alias1,DOUBLE,1635201378,0,GOOD,6.0
unmodeled_alias1,DOUBLE,1635201379,0,GOOD,7.0
unmodeled_alias1,DOUBLE,1635201380,0,GOOD,8.0
unmodeled_alias1,DOUBLE,1635201381,0,GOOD,9.0
unmodeled_alias1,DOUBLE,1635201382,0,GOOD,10.0
```

AWS IoT SiteWise 는 대량 가져오기 작업을 생성하고 기존 작업에 대한 정보를 가져오기 위해 다음과 같은 API 작업을 제공합니다.
+ [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html) - 새 대량 가져오기 작업을 생성합니다.
+ [DescribeBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeBulkImportJob.html) - 대량 가져오기 작업에 대한 정보를 검색합니다.
+ [ListBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListBulkImportJobs.html) - 모든 대량 가져오기 작업의 요약 목록을 페이지별로 나누어 검색합니다.