기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # HealthImaging에서 DICOM 데이터 검색 AWS HealthImaging은 [ DICOMweb QIDO-RS](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) APIs를 표현하여 환자 ID별로 연구, 시리즈 및 인스턴스를 검색하고 추가 사용을 위해 고유 식별자를 수신합니다. HealthImaging의 DICOMweb QIDO-RS APIs HealthImaging에 저장된 데이터를 검색하고 레거시 애플리케이션과의 상호 운용성을 제공하는 방법에 유연성을 제공합니다. **중요** HealthImaging의 DICOMweb APIs 사용하여 QIDO-RS로 이미지 세트 정보를 반환할 수 있습니다. HealthImaging DICOMweb APIs 달리 명시되지 않는 한 기본 [이미지 세트](getting-started-concepts.md#concept-image-set)만 참조합니다. HealthImaging [클라우드 네이티브 작업](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) 또는 DICOMweb 작업의 선택적 이미지 세트 파라미터를 사용하여 기본이 아닌 이미지 세트를 검색합니다. HealthImaging의 DICOMweb APIs 사용하여 DICOMweb 적합성 응답과 함께 이미지 세트 정보를 반환할 수 있습니다. HealthImaging DICOMweb QIDO-RS 작업은 최대 10,000개의 레코드를 반환할 수 있습니다. 10,000개 이상의 리소스가 있는 경우 QIDO-RS 작업을 통해 검색할 수 없지만 DICOMweb WADO-RS 작업 또는 [클라우드 네이티브 작업을](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) 통해 검색할 수 있습니다. 이 섹션에 나열된 APIs는 웹 기반 의료 영상에 대한 DICOMweb(QIDO-RS) 표준을 준수하도록 구축되었습니다. AWS CLI 및 AWS SDKs 통해 제공되지 않습니다. ## HealthImaging용 DICOMweb 검색 APIs 다음 표에서는 HealthImaging에서 데이터를 검색하는 데 사용할 수 있는 DICOMweb QIDO-RS APIs의 모든 HealthImaging 표현을 설명합니다. **DICOMweb QIDO-RS APIs의 HealthImaging 표현** | 이름 | 설명 | | --- | --- | | SearchDICOMStudies | GET 요청을 사용하여 검색 쿼리 요소를 지정하여 HealthImaging에서 DICOM 연구를 검색합니다. 연구 검색 결과는 마지막 업데이트, 날짜 내림차순(최신에서 가장 오래된) 순서로 JSON 형식으로 반환됩니다. [연구 검색](dicomweb-search-studies.md)을(를) 참조하세요. | | SearchDICOMSeries | GET 요청을 사용하여 검색 쿼리 요소를 지정하여 HealthImaging에서 DICOM 시리즈를 검색합니다. 시리즈 검색 결과는 JSON 형식으로 반환되며, 오름차순(가장 오래된 - 최신)Series Number (0020, 0011)으로 정렬됩니다. [시리즈 검색](dicomweb-search-series.md)을(를) 참조하세요. | | SearchDICOMInstances | GET 요청을 사용하여 검색 쿼리 요소를 지정하여 HealthImaging에서 DICOM 인스턴스를 검색합니다. 인스턴스 검색 결과는 JSON 형식으로 반환되며 오름차순(가장 오래된 - 최신)Instance Number (0020, 0013)으로 정렬됩니다. [인스턴스 검색](dicomweb-search-instances.md)을(를) 참조하세요. | ## HealthImaging에 지원되는 DICOMweb 쿼리 유형 HealthImaging은 연구, 시리즈 및 SOP 인스턴스 수준에서 QIDO-RS 계층적 리소스 쿼리를 지원합니다. HealthImaging에 QIDO-RS 계층 검색을 사용하는 경우: + 연구를 검색하면 연구 목록이 반환됩니다. + 연구 시리즈를 검색하려면 알려진가 필요하며 시리즈 목록을 `StudyInstanceUID` 반환합니다. + 인스턴스 목록을 검색하려면 알려진 `StudyInstanceUID` 및가 필요합니다. `SeriesInstanceUID` 다음 표에서는 HealthImaging에서 데이터를 검색하는 데 지원되는 QIDO-RS 계층적 쿼리 유형을 설명합니다. **HealthImaging에서 지원하는 QIDO-RS 쿼리 유형** | 쿼리 유형 | 예제 | | --- | --- | | 속성 값 쿼리 | 가 있는 연구의 모든 시리즈를 검색합니다`modality=CT`.
`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`
환자 ID와 연구 날짜가 각각 이러한 값인 모든 연구를 검색합니다.
`…/studies?PatientID=11235813&StudyDate=20130509` | | 키워드 쿼리 | `SeriesInstanceUID` 키워드를 사용하여 모든 시리즈를 검색합니다.
`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894868` | | 쿼리 태그 지정 | 그룹/요소 양식에 전달된 쿼리 파라미터를 사용하여 태그를 검색합니다.
0020000D와 같은 {group}{element} | | 범위 쿼리 | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | | limit 및를 사용한 결과 페이징 offset | `.../studies?limit=1&offset=0&00080020=20000101`
제한 및 오프셋 파라미터를 사용하여 검색 응답을 페이지 매김할 수 있습니다. 제한의 기본값은 1000이며 최대값은 섹션을 참조[AWS HealthImaging 엔드포인트 및 할당량](endpoints-quotas.md)하세요.
최대 한도 = 1000, 최대 오프셋 = 9000 | | 와일드카드 쿼리 | 와일드카드 쿼리는 "\*" 및 "?"를 사용하여 보다 유연하게 검색할 수 있습니다. "\*"는 모든 문자 시퀀스(길이가 0인 값 포함) 및 "?"와 일치합니다. 는 모든 단일 문자와 일치합니다.
StudyDescription에 "Nuclear"가 포함된 데이터 스토어에서 모든 연구를 검색합니다.
`.../studies?StudyDescription=*Nuclear*`
StudyDescription이 "Nuclear"로 끝나는 모든 연구를 검색합니다.
`.../studies?StudyDescription=*Nuclear`
StudyDescription이 "Nuclear"로 시작하는 모든 연구를 검색합니다.
`.../studies?StudyDescription=Nuclear*`
PatientID가 200965981 뒤에 정확히 3자를 가지고 있는 모든 연구를 검색합니다.
`.../studies?PatientID=200965981???` | | FuzzyMatching 쿼리 | fuzzymatching 선택적 쿼리 파라미터를 추가하여 이름 DICOM 속성(PatientName(0010,0010), ReferringPhysicianName(0008,0090))에서 fuzzy 일치를 활성화합니다.
`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`
이 쿼리는 PatientName 값의 모든 부분에서 대소문자를 구분하지 않는 접두사 단어 일치를 수행합니다. "thomas", "Albert", "Thomas Albert", "Thomas^Albert"와 같은 PatientName 값으로 결과를 반환하지만 "hom" 또는 "ber"는 반환하지 않습니다. | | IncludeField 쿼리 | `includefield` 쿼리 파라미터를 사용하여 기본 응답 세트 이외의 추가 DICOM 속성을 요청합니다.
태그별로 특정 속성을 반환합니다.
`.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight`
사용 가능한 모든 속성을 반환합니다.
`.../studies?PatientID=11235813&includefield=all`
점 표기법을 사용한 반환 시퀀스(SQ) 하위 속성:
`.../studies?PatientID=11235813&includefield=00080096.00080100`
프라이빗 데이터 요소 반환:
`.../instances?includefield=00191001&00190010=Philips` | ## QIDO-RS 쿼리에서 IncludeField 사용 `includefield` 쿼리 파라미터를 사용하면 HealthImaging QIDO-RS 쿼리의 기본 응답 세트 외에 추가 DICOM 속성을 요청할 수 있습니다. 연구, 시리즈 및 인스턴스 수준에서 `includefield`를 사용할 수 있습니다. ### 구문 QIDO-RS 쿼리에 추가 필드를 포함하려면 다음 GET 요청 형식을 사용합니다. ``` GET .../studies?&includefield= GET .../studies//series?&includefield= GET .../studies//series//instances?&includefield= ``` 단일 요청으로 여러 `includefield` 파라미터를 지정할 수 있습니다. ``` GET .../studies?PatientID=11235813&includefield=00101081&includefield=00101030&includefield=00101010 ``` ### includefield에 지원되는 값 다음 표에서는 `includefield` 파라미터에 대해 지원되는 값을 설명합니다. **지원되는 includefield 값** | 값 유형 | 설명 | 예제 | | --- | --- | --- | | DICOM 태그(816진수 문자) | 태그별로 GGGGEE 형식의 특정 DICOM 속성을 요청합니다. | includefield=00081030 | | all | 리소스 수준에서 사용 가능한 모든 DICOM 속성을 요청합니다. | includefield=all | | 점선 SQ 경로 | 점 표기법: .를 사용하여 시퀀스(SQ) 속성 내에서 특정 하위 속성을 요청합니다. | includefield=00080096.00080100 | | 프라이빗 데이터 요소 태그 | 프라이빗 태그(odd-group 요소)를 요청합니다. privateCreatorElement 파라미터가 필요합니다. | includefield=00191001 | | bulkdata를 포함한 표준 DICOM 속성 | 태그 또는 키워드별로 특정 단일 또는 다중 속성을 요청합니다. | includefield=00102201 | ### 동작 및 규칙 `includefield` 쿼리에는 다음 규칙이 적용됩니다. + **기본 응답** -이 없으면 `includefield`QIDO-RS 응답은 표준 속성 집합만 반환합니다. + **includefield=all** - 요청된 수준에서 사용 가능한 모든 속성을 반환합니다. `all`가 다른 `includefield` 값과 결합되면 `all`가 우선합니다. + **최대 태그** - 요청에는 최대 50개의 `includefield` 파라미터가 포함될 수 있습니다. + **중복 태그** - 중복 `includefield` 값은 중복 제거되고 단일 요청으로 처리됩니다. + **유효하지 않거나 누락된 태그** - 요청된 태그가 DICOM 데이터에 없거나 유효하지 않은 경우 응답에서 자동으로 생략됩니다. 다른 유효한 `includefield` 속성은 여전히 반환됩니다. ### 시퀀스(SQ) 속성 점 표기법을 사용하여 시퀀스(SQ) 속성 내에 중첩된 속성을 요청합니다. ``` includefield=. ``` 예를 들어 ReferringPhysicianIdentificationSequence(0008,0096) 내에서 CodeValue(0008,0100)를 검색하려면 ``` GET .../studies?PatientID=11235813&includefield=00080096.00080100 ``` 다단계 중첩이 지원됩니다. 예제: ``` includefield=00081115.00081199.00081150 ``` ### 프라이빗 태그 프라이빗 DICOM 데이터 요소(홀수 그룹 태그)는 모든 리소스 수준에서 지원됩니다. 프라이빗 태그를 요청하려면 `privateCreatorElement` 쿼리 파라미터를 포함합니다. 다음 구문을 사용합니다. ``` GET .../instances?includefield=&= ``` 예제: ``` GET .../instances?includefield=00191001&00190010=Philips ``` 프라이빗 태그에는 다음 규칙이 적용됩니다. + 프라이빗 `privateCreatorElement` 태그가 요청된 경우 태그와 생성자 이름을 일치 파라미터로 제공해야 합니다. + 지정된 `privateCreatorElement`를 찾을 수 없는 경우 프라이빗 태그는 자동으로 생략됩니다. + 프라이빗 데이터 요소가 없는 `privateCreatorElement` 태그만 요청하면 생성자 요소 이름과 값만 반환됩니다. 해당 생성자의 블록에 속하는 모든 태그를 반환하지는 않습니다. ### 대량 데이터 태그 의 일부로 요청된 이진 값이 1MB보다 큰 bulkdata VRs(OB, OD, OF, OL, UN, OW, OV)이 있는 DICOM 속성`includefield`은 원시 이진 값 `bulkdataURI` 대신 로 반환됩니다. 대량 데이터 검색에 대한 자세한 내용은 [ HealthImaging에서 DICOM 대량 데이터 검색을 참조하세요](https://docs.aws.amazon.com/healthimaging/latest/devguide/dicom-retrieve-bulkdata.html). ### 각 수준에서 includefield=all은 무엇을 반환하나요? `includefield=all`이 지정되면 응답에는 특정 리소스 수준의 모든 속성이 포함됩니다. #### 연구 수준(includefield=all) 다음 표에는이 지정될 때 연구 수준에서 반환되는 모든 속성이 나열되어 `includefield=all` 있습니다. **includefield=all에 대한 연구 수준 속성** | 태그 | 이름 | VR | | --- | --- | --- | | 00080005 | SpecificCharacterSet | CS | | 00080020 | StudyDate | DA | | 00080030 | StudyTime | TM | | 00080050 | AccessionNumber | SH | | 00080051 | IssuerOfAccessionNumberSequence | SQ | | 00080056 | InstanceAvailability | CS | | 00080061 | ModalitiesInStudy | CS | | 00080062 | SOPClassesInStudy | UI | | 00080090 | ReferringPhysicianName | PN | | 0008009C | ConsultingPhysicianName | PN | | 00080201 | TimezoneOffsetFromUTC | SH | | 00081030 | StudyDescription | LO | | 00081048 | PhysiciansOfRecord | PN | | 00081060 | NameOfPhysiciansReadingStudy | PN | | 00081080 | AdmittingDiagnosesDescription | LO | | 00081190 | RetrieveURL | UR | | 00100010 | PatientName | PN | | 00100020 | PatientID | LO | | 00100021 | IssuerOfPatientID | LO | | 00100022 | TypeOfPatientID | CS | | 00100026 | SourcePatientGroupIdentificationSequence | SQ | | 00100027 | GroupOfPatientsIdentificationSequence | SQ | | 00100028 | SubjectRelativePositionInImage | US | | 00100030 | PatientBirthDate | DA | | 00100032 | PatientBirthTime | TM | | 00100033 | PatientBirthDateInAlternativeCalendar | LO | | 00100034 | PatientDeathDateInAlternativeCalendar | LO | | 00100035 | PatientAlternativeCalendar | CS | | 00100040 | PatientSex | CS | | 00100050 | PatientInsurancePlanCodeSequence | SQ | | 00100101 | PatientPrimaryLanguageCodeSequence | SQ | | 00100102 | PatientPrimaryLanguageModifierCodeSequence | SQ | | 00100200 | QualityControlSubject | CS | | 00100201 | QualityControlSubjectTypeCodeSequence | SQ | | 00100213 | StrainNomenclature | LO | | 00100214 | StrainStockNumber | LO | | 00100215 | StrainSourceRegistryCodeSequence | SQ | | 00100217 | StrainSource | LO | | 00100219 | StrainCodeSequence | SQ | | 00100223 | GeneticModificationsNomenclature | LO | | 00100229 | GeneticModificationsCodeSequence | SQ | | 00101001 | OtherPatientNames | PN | | 00101005 | PatientBirthName | PN | | 00101010 | PatientAge | AS | | 00101020 | PatientSize | DS | | 00101021 | PatientSizeCodeSequence | SQ | | 00101022 | PatientBodyMassIndex | DS | | 00101023 | MeasuredAPDimension | DS | | 00101024 | MeasuredLateralDimension | DS | | 00101030 | PatientWeight | DS | | 00101040 | PatientAddress | LO | | 00101060 | PatientMotherBirthName | PN | | 00101080 | MilitaryRank | LO | | 00101081 | BranchOfService | LO | | 00102000 | MedicalAlerts | LO | | 00102110 | 알러지 | LO | | 00102150 | CountryOfResidence | LO | | 00102152 | RegionOfResidence | LO | | 00102154 | PatientTelephoneNumbers | SH | | 00102160 | EthnicGroup | SH | | 00102180 | 직업 | SH | | 001021A0 | SmokingStatus | CS | | 001021C0 | PregnancyStatus | US | | 001021D0 | LastMenstrualDate | DA | | 001021F0 | PatientReligiousPreference | LO | | 00102201 | PatientSpeciesDescription | LO | | 00102202 | PatientSpeciesCodeSequence | SQ | | 00102203 | PatientSexNeutered | CS | | 00102210 | AnatomicalOrientationType | CS | | 00102292 | PatientBreedDescription | LO | | 00102293 | PatientBreedCodeSequence | SQ | | 00102295 | BreedRegistrationNumber | LO | | 00102296 | BreedRegistryCodeSequence | SQ | | 00102297 | ResponsiblePerson | PN | | 00102298 | ResponsiblePersonRole | CS | | 00102299 | ResponsibleOrganization | LO | | 00109431 | ExaminedBodyThickness | FL | | 0020000D | StudyInstanceUID | UI | | 00200010 | StudyID | SH | | 00201206 | NumberOfStudyRelatedSeries | IS | | 00201208 | NumberOfStudyRelatedInstances | IS | | 00321032 | RequestingPhysician | PN | | 00321033 | RequestingService | LO | | 00321060 | RequestedProcedureDescription | LO | | 00321070 | RequestedContrastAgent | LO | | 00380010 | AdmissionID | LO | | 00380016 | RouteOfAdmissions | LO | | 00380020 | AdmittingDate | DA | | 00380021 | AdmittingTime | TM | | 00380050 | SpecialNeeds | LO | | 00380060 | ServiceEpisodeID | LO | | 00380062 | ServiceEpisodeDescription | LO | | 00380300 | CurrentPatientLocation | LO | | 00380400 | PatientInstitutionResidence | LO | | 00380500 | PatientState | LO | | 00400244 | PerformedProcedureStepStartDate | DA | | 00400245 | PerformedProcedureStepStartTime | TM | | 00400250 | PerformedProcedureStepEndDate | DA | | 00400251 | PerformedProcedureStepEndTime | TM | | 00400253 | PerformedProcedureStepID | SH | | 00081032 | ProcedureCodeSequence | SQ | | 00100024 | IssuerOfPatientIDQualifiersSequence | SQ | | 00321034 | RequestingServiceCodeSequence | SQ | | 00321064 | RequestedProcedureCodeSequence | SQ | | 00401012 | ReasonForPerformedProcedureCodeSequence | SQ | #### 시리즈 수준(includefield=all) 다음 표에는가 지정될 때 반환되는 시리즈 수준 속성이 나열되어 `includefield=all` 있습니다. 시리즈 수준은 이전 표에 나열된 모든 연구 수준 속성도 반환합니다. **includefield=all에 대한 시리즈 수준 속성** | 태그 | 이름 | VR | | --- | --- | --- | | 00080021 | SeriesDate | DA | | 00080031 | SeriesTime | TM | | 00080060 | 양식 | CS | | 00080064 | ConversionType | CS | | 00080068 | PresentationIntentType | CS | | 00080070 | 제조업체 | LO | | 00080080 | InstitutionName | LO | | 00080082 | InstitutionCodeSequence | SQ | | 00081010 | StationName | SH | | 0008103E | SeriesDescription | LO | | 0008103F | SeriesDescriptionCodeSequence | SQ | | 00081040 | InstitutionalDepartmentName | LO | | 00081041 | InstitutionalDepartmentTypeCodeSequence | SQ | | 00081050 | PerformingPhysicianName | PN | | 00081070 | OperatorsName | PN | | 00081090 | ManufacturerModelName | LO | | 00180010 | ContrastBolusAgent | LO | | 00180015 | BodyPartExamined | CS | | 00180050 | SliceThickness | DS | | 00180088 | SpacingBetweenSlices | DS | | 00181000 | DeviceSerialNumber | LO | | 00181016 | SecondaryCaptureDeviceManufacturer | LO | | 00181018 | SecondaryCaptureDeviceManufacturerModelName | LO | | 00181019 | SecondaryCaptureDeviceSoftwareVersions | LO | | 00181020 | SoftwareVersions | LO | | 00181030 | ProtocolName | LO | | 00181050 | SpatialResolution | DS | | 00181200 | DateOfLastCalibration | DA | | 00181201 | TimeOfLastCalibration | TM | | 00185100 | PatientPosition | CS | | 0020000D | StudyInstanceUID | UI | | 0020000E | SeriesInstanceUID | UI | | 00200011 | SeriesNumber | IS | | 00200052 | FrameOfReferenceUID | UI | | 00200060 | 측면성 | CS | | 00201209 | NumberOfSeriesRelatedInstances | IS | | 00540081 | NumberOfSlices | US | | 00540101 | NumberOfTimeSlices | US | | 00541000 | SeriesType | CS | #### 인스턴스 수준(includefield=all) 인스턴스 수준에서는 전체 인스턴스 수준 DICOM 메타데이터를 `includefield=all` 반환합니다. 여기에는 HealthImaging 스토리지의 인스턴스 메타데이터에 저장된 모든 속성이 포함됩니다. 픽셀 데이터 속성을 제외하고 해당 인스턴스의 원본 DICOM 파일에 있는 모든 DICOM 태그가 반환됩니다. **Topics** + [HealthImaging용 DICOMweb 검색 APIs](#dicomweb-search-services) + [HealthImaging에 지원되는 DICOMweb 쿼리 유형](#dicomweb-query-types) + [QIDO-RS 쿼리에서 IncludeField 사용](#dicomweb-includefield) + [HealthImaging에서 DICOM 연구 검색](dicomweb-search-studies.md) + [HealthImaging에서 DICOM 시리즈 검색](dicomweb-search-series.md) + [HealthImaging에서 DICOM 인스턴스 검색](dicomweb-search-instances.md)