本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

使用 `CreateBulkImportJob` API 從 Amazon S3 匯入大量資料。您的資料必須以 CSV 格式儲存在 Amazon S3 中。資料檔案可以有下列資料欄。

**注意**  
 不支援早於 1970 年 1 月 1 日 00：00：00 UTC 的資料。  
若要識別資產屬性，請指定下列其中一項。  
您要傳送資料的資產屬性`PROPERTY_ID`的 `ASSET_ID`和 。
`ALIAS`，這是資料串流別名 （例如 `/company/windfarm/3/turbine/7/temperature`)。若要使用這個選項，您必須先設定您的資產屬性別名。若要了解如何設定屬性別名，請參閱[管理 的資料串流 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` – 最多 1024 個位元組的字串。
  + `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 格式的資料檔案 (s)**  

```
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) – 擷取所有大量匯入任務的分頁摘要清單。