執行大量匯出工作

大量匯出是將中繼資料從工作 AWS IoT SiteWise 區移至 Amazon S3 儲存貯體的動作。

將 AWS IoT SiteWise 內容大量匯出到 Amazon S3 時，可以指定篩選器來限制要匯出的特定資產模型和資產。

篩選器必須在要iotSiteWiseConfigurationJSON求的來源區段中指定。

注意

您可以在要求中加入多個篩選條件。大量作業會匯出符合任何篩選條件的資產模型和資產。

如果您未提供任何篩選條件，大量作業會匯出所有資產模型和資產。

範例 請求主體與過濾器

{
      "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:::your-S3-bucket-location"
          }
      }
}

匯出中繼資料 (主控台)

下列程序說明主控台匯出動作：

在中建立匯出工作 AWS IoT SiteWise 主控台

1. 導覽至 AWS IoT SiteWise 主控台。

2. 從導覽窗格中選擇 [大量作業新增]。

3. 選擇 [新增匯出] 以開始匯出程序。

4. 在「匯出中繼資料」頁面上：

   • 輸入匯出工作的名稱。這是 Amazon S3 儲存貯體中用於匯出檔案的名稱。

   • 選擇要匯出的資源，以設定工作的篩選條件：

     • 匯出所有資產和資產模型。在資產和資產模型上使用篩選器。

     • 匯出資產。篩選您的資產。

       • 選取要用於匯出篩選的資產。

       • (選擇性) 新增後代或關聯的資產模型。

     • 匯出資產模型。篩選您的資產模型。

       • 選取要用於匯出篩選的資產模型。

       • (選擇性) 新增後代，或相關資產或兩者。

     • 選擇 Next (下一步)。

   • 導航到 Amazon S3 存儲桶：

     • 選擇瀏覽 Amazon S3 以檢視 Amazon S3 儲存貯體和檔案。

     • 導覽至必須放置檔案的 Amazon S3 儲存貯體。

     • 選擇 Next (下一步)。

   • 檢閱匯出工作，然後選擇「匯出」。

5. 的中 SiteWise 繼資料頁面上的大量作業會在「工作」進度表格中 AWS IoT SiteWise 主控台 顯示新建立的匯入工作。

如需匯出中繼資料時使用篩選器的不同方式，請參閱匯出元資料範例。

匯出中繼資料 (AWS CLI)

下列程序說明 AWS CLI 匯出動作：

將資料從 AWS IoT SiteWise Amazon S3 匯出

1. 使用您的請求主體創建一個JSON文件。要求主體會指定傳送工作的來源和目的地。下面的例子顯示了一個請求主體的示例：

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

   確保將 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
   

   createMetadataTransferJobExport.json用您自己的傳輸JSON檔案名稱取代輸入檔案。