기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 가져오기 작업에 대한 이해 AWS HealthImaging에서 [데이터 스토어](getting-started-concepts.md#concept-data-store)를 생성한 후에는 Amazon S3 입력 버킷에서 데이터 스토어로 의료 영상 데이터를 가져와서 [이미지 세트](getting-started-concepts.md#concept-image-set)를 생성해야 합니다. AWS Management Console AWS CLI, 및 AWS SDKs 사용하여 가져오기 작업을 시작, 설명 및 나열할 수 있습니다. DICOM P10 데이터를 AWS HealthImaging 데이터 스토어로 가져오면 서비스는 [메타데이터 요소를](understanding-image-sets.md) 기반으로 연구 UID, 시리즈 UID, 인스턴스 UID의 DICOM 계층 구조에 따라 인스턴스를 자동으로 구성하려고 시도합니다. 가져온 데이터의 [메타데이터 요소가](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`success.ndjson`은를 사용하여 EventBridge 이벤트를 내보내고 `isPrimary: False`에 기록된 레코드도 `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) 업데이트에 설명된 단계를 사용하여 기본의 인스턴스를 업데이트할 수 있습니다. 가져오는 동안 크기가 1MB를 초과하는 프라이빗 태그(VR 유형 OB, OD, OF, OL, OV, OW, UN 포함)의 이진 값은 메타데이터와 별도로 저장됩니다. `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` 폴더로 구성됩니다. **참고** 단일 가져오기 작업에 최대 1만 개의 중첩된 폴더를 포함할 수 있습니다. + 이 `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일 동안 보존된 다음 보관됩니다.