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

# 了解匯入任務
<a name="understanding-import-jobs"></a>

在 AWS HealthImaging 中建立[資料存放](getting-started-concepts.md#concept-data-store)區之後，您必須將醫療影像資料從 Amazon S3 輸入儲存貯體匯入資料存放區，才能建立[影像集](getting-started-concepts.md#concept-image-set)。您可以使用 AWS CLI AWS 管理主控台和 AWS SDKs 來啟動、描述和列出匯入任務。

當您將 DICOM P10 資料匯入 AWS HealthImaging 資料存放區時，服務會嘗試根據研究 UID、序列 UID、執行個體 UID 的 DICOM 階層，根據[中繼資料元素](understanding-image-sets.md)自動組織執行個體。如果匯入資料的[中繼資料元素](understanding-image-sets.md)與資料存放區中的現有主要[影像集](getting-started-concepts.md#concept-image-set)沒有衝突，則匯入的資料將成為主要資料。如果新匯入的 DICOM P10 資料的中繼資料元素與現有的主要[影像集](getting-started-concepts.md#concept-image-set)衝突，則新資料將新增至非主要[影像集](getting-started-concepts.md#concept-image-set)。當資料匯入建立非主要[映像集](getting-started-concepts.md#concept-image-set)時，AWS HealthImaging 會使用 發出 EventBridge 事件`isPrimary: False`，而寫入 的記錄`success.ndjson`也會在 `importResponse` 物件`isPrimary: False`中。

當您匯入資料時，HealthImaging 會執行下列動作：
+ 如果在一個匯入任務中匯入包含 DICOM 序列的執行個體，且執行個體未與資料存放區中已存在的執行個體衝突，則所有執行個體都會組織成一個主要[映像集](getting-started-concepts.md#concept-image-set)。
+ 如果在兩個或多個匯入任務中匯入包含 DICOM 序列的執行個體，且執行個體未與資料存放區中已存在的執行個體衝突，則所有執行個體都會組織為一個主要[映像集](getting-started-concepts.md#concept-image-set)。
+ 如果匯入執行個體超過一次，則最新版本會覆寫存放在主要[映像集中](getting-started-concepts.md#concept-image-set)的任何較舊版本，且主要[映像集](getting-started-concepts.md#concept-image-set)的版本編號會遞增。

您可以使用更新[映像集中繼資料中所述的步驟來更新](update-image-set-metadata.md)主要 中的執行個體。

在匯入期間，私有標籤中的二進位值 （包含 OB、OD、 OF、OL、OV、OW、UN 虛擬實境類型） 大小超過 1MB 會與中繼資料分開存放。使用 `GetDICOMInstanceMetadata`或 擷取這些執行個體的中繼資料時`GetDICOMSeriesMetadata`，會將這些大型二進位值取代為 BulkDataURIs，並使用 `GetDICOMBulkdata` API 擷取實際的二進位資料。

HealthImaging 會嘗試匯入您的所有醫療影像資料。如果在匯入期間遇到資料不一致性或無法辨識的資料元素，HealthImaging 會將警告新增至仍然可以匯入的 DICOM 執行個體的 `warning.ndjson` 檔案。如需警告代碼的完整清單，請參閱 [HealthImaging 警告代碼](reference-warning-codes.md)。

從 Amazon S3 將醫療影像檔案匯入 HealthImaging 資料存放區時，請注意下列事項：
+ 對應至 DICOM 系列的執行個體會自動合併在單一影像集中，表示主要影像集。
+ 您可以在一個匯入任務或多個匯入任務中匯入 DICOM P10 資料，而服務會將執行個體整理成對應至 DICOM 系列的主要映像集
+ 長度限制條件適用於匯入期間的特定 DICOM 元素。為了確保成功匯入任務，請確認您的醫學影像資料未超過長度限制。如需詳細資訊，請參閱[DICOM 元素限制條件](dicom-element-constraints.md)。
+ 像素資料驗證檢查會在匯入任務開始時執行。如需詳細資訊，請參閱[像素資料驗證](pixel-data-verification.md)。
+ 有與 HealthImaging 匯入動作相關聯的端點、配額和限流限制。如需詳細資訊，請參閱[端點和配額](endpoints-quotas.md)及[調節限制](throttling-limits.md)。
+ 對於每個匯入任務，處理結果會存放在 `outputS3Uri`位置。處理結果會組織為`job-output-manifest.json`檔案和`SUCCESS``FAILURE`資料夾。
**注意**  
單一匯入任務最多可包含 10，000 個巢狀資料夾。
  + `job-output-manifest.json` 檔案包含已處理資料的`jobSummary`輸出和其他詳細資訊。下列範例顯示 檔案的輸出`job-output-manifest.json`。

    ```
    {
    "jobSummary": {
    "jobId": "09876543210987654321098765432109",
            "datastoreId": "12345678901234567890123456789012",
            "inputS3Uri": "s3://medical-imaging-dicom-input/dicom_input/",
            "outputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/",
            "successOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/SUCCESS/",
            "failureOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/FAILURE/",
            "warningsOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/WARNING/",
            "numberOfScannedFiles": 5,
            "numberOfImportedFiles": 3,
            "numberOfFilesWithCustomerError": 2,
            "numberOfFilesWithServerError": 0,
            "numberOfGeneratedImageSets": 2,
            "imageSetsSummary": [{
    "imageSetId": "12345612345612345678907890789012",
                    "numberOfMatchedSOPInstances": 2
                },
                {
    "imageSetId": "12345612345612345678917891789012",
                    "numberOfMatchedSOPInstances": 1
                }
            ]
        }
    }
    ```
  + `SUCCESS` 資料夾會保留`success.ndjson`檔案，其中包含成功匯入的所有影像檔案的結果。下列範例顯示 檔案的輸出`success.ndjson`。

    ```
    {"inputFile":"dicomInputFolder/1.3.51.5145.5142.20010109.1105620.1.0.1.dcm","importResponse":{"imageSetId":"12345612345612345678907890789012", "isPrimary": True}} 
    {"inputFile":"dicomInputFolder/1.3.51.5145.5142.20010109.1105630.1.0.1.dcm","importResponse":{"imageSetId":"12345612345612345678917891789012", "isPrimary": True}}
    ```
  + `FAILURE` 資料夾會保留 `failure.ndjson` 檔案，其中包含未成功匯入的所有影像檔案的結果。下列範例顯示 檔案的輸出`failure.ndjson`。

    ```
    {"inputFile":"dicom_input/invalidDicomFile1.dcm","exception":{"exceptionType":"ValidationException","message":"DICOM attribute TransferSyntaxUID does not exist"}}
    {"inputFile":"dicom_input/invalidDicomFile2.dcm","exception":{"exceptionType":"ValidationException","message":"DICOM attributes does not exist"}}
    ```
  + `WARNING` 資料夾會保留`warning.ndjson`檔案，其中包含成功匯入但出現警告的所有影像檔案的結果。下列範例顯示 檔案的輸出`warning.ndjson`。

    ```
    {"inputFile":"dicom_input/warningDicomFile1.dcm","importResponse":{"imageSetId":"12345612345612345678907890789012","imageSetVersion":1,"isPrimary":true,"warnings":[{"warning_reason_code":45330,"type":"InvalidOffsetTable","message":"The file was imported but contains an invalid offset table, may see issues when retrieving certain frames."}]}}
    ```
+ 匯入任務會保留在任務清單中 90 天，然後封存。