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

# 執行大量匯入任務
<a name="running-bulk-operations-import"></a>

 大量匯入是將中繼資料移至 AWS IoT SiteWise 工作區的動作。例如，大量匯入可以將中繼資料從本機檔案或 Amazon S3 儲存貯體中的檔案移至 AWS IoT SiteWise 工作區。

## 步驟 1：準備要匯入的檔案
<a name="preparing-import-file"></a>

下載 AWS IoT SiteWise 原生格式檔案以匯入資產和資產模型。如需詳細資訊，請參閱[AWS IoT SiteWise 中繼資料傳輸任務結構描述](bulk-operations-schema.md)。

## 步驟 2：將準備好的檔案上傳至 Amazon S3
<a name="uploading-import-file"></a>

 將檔案上傳至 Amazon S3。如需詳細資訊，請參閱[《Amazon Simple Storage Service 使用者指南》中的將檔案上傳至 Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#uploading-an-object-bucket)。 **

## 匯入中繼資料 （主控台）
<a name="import-metadata-console"></a>

您可以使用 AWS IoT SiteWise 主控台 大量匯入中繼資料。遵循 [步驟 1：準備要匯入的檔案](#preparing-import-file)和 [步驟 2：將準備好的檔案上傳至 Amazon S3](#uploading-import-file)準備準備好匯入的檔案。

**將資料從 Amazon S3 匯入至 AWS IoT SiteWise 主控台**

1. 導覽至 [AWS IoT SiteWise 主控台](https://console.aws.amazon.com/iotsitewise/)。

1. 從導覽窗格中選擇**大量操作新增**。

1. 選擇**新增匯入**以開始匯入程序。

1. 在**匯入中繼資料**頁面上：
   + 選擇**瀏覽 Amazon S3** 以檢視 Amazon S3 儲存貯體和檔案。
   + 導覽至包含預備匯入檔案的 Amazon S3 儲存貯體。
   + 選取要匯入的檔案。
   + 檢閱選取的檔案，然後選擇**匯入**。

1. **SiteWise 中繼資料頁面上的大量操作**會在任務進度表中 AWS IoT SiteWise 主控台 顯示新建立的匯入任務。 ****

## 匯入中繼資料 (AWS CLI)
<a name="import-metadata-cli"></a>

若要執行匯入動作，請使用下列程序：

**將資料從 Amazon S3 匯入至 AWS CLI**

1. 依照 建立中繼資料檔案，指定您要匯入的資源[AWS IoT SiteWise 中繼資料傳輸任務結構描述](bulk-operations-schema.md)。將此檔案存放在 Amazon S3 儲存貯體中。

   如需要匯入的中繼資料檔案範例，請參閱 [匯入中繼資料範例](bulk-operations-import-metadata-example.md)。

1. 現在使用請求內文建立 JSON 檔案。請求內文會指定傳輸任務的來源和目的地。此檔案與上一個步驟的檔案分開。請務必將 Amazon S3 儲存貯體指定為來源和`iotsitewise`目的地。

   下列範例顯示請求內文：

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

1. 執行下列 AWS CLI 命令`CreateMetadataTransferJob`來叫用 。在此範例中，上一個步驟的請求內文檔案名為 `createMetadataTransferJobExport.json`。

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

   這將建立中繼資料傳輸任務，並開始轉移所選資源的程序。