기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# HealthImaging에서 DICOM 데이터 검색
<a name="dicomweb-search"></a>

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
<a name="dicomweb-search-services"></a>

다음 표에서는 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 쿼리 유형
<a name="dicomweb-query-types"></a>

HealthImaging은 연구, 시리즈 및 SOP 인스턴스 수준에서 QIDO-RS 계층적 리소스 쿼리를 지원합니다. HealthImaging에 QIDO-RS 계층 검색을 사용하는 경우:
+ 연구를 검색하면 연구 목록이 반환됩니다.
+ 연구 시리즈를 검색하려면 알려진가 필요하며 시리즈 목록을 `StudyInstanceUID` 반환합니다.
+ 인스턴스 목록을 검색하려면 알려진 `StudyInstanceUID` 및가 필요합니다. `SeriesInstanceUID` 

다음 표에서는 HealthImaging에서 데이터를 검색하는 데 지원되는 QIDO-RS 계층적 쿼리 유형을 설명합니다.


**HealthImaging에서 지원하는 QIDO-RS 쿼리 유형**  

| 쿼리 유형 | 예제 | 
| --- | --- | 
| 속성 값 쿼리 | 가 있는 연구의 모든 시리즈를 검색합니다`modality=CT`.<br />`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`<br />환자 ID와 연구 날짜가 각각 이러한 값인 모든 연구를 검색합니다.<br />`…/studies?PatientID=11235813&StudyDate=20130509` | 
| 키워드 쿼리 | `SeriesInstanceUID` 키워드를 사용하여 모든 시리즈를 검색합니다.<br />`.../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` | 
| 쿼리 태그 지정 | 그룹/요소 양식에 전달된 쿼리 파라미터를 사용하여 태그를 검색합니다.<br />0020000D와 같은 {group}{element} | 
| 범위 쿼리 | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | 
| limit 및를 사용한 결과 페이징 offset | `.../studies?limit=1&offset=0&00080020=20000101`<br />제한 및 오프셋 파라미터를 사용하여 검색 응답을 페이지 매김할 수 있습니다. 제한의 기본값은 1000이며 최대값은 [AWS HealthImaging 엔드포인트 및 할당량](endpoints-quotas.md) 섹션을 참조하세요.<br />최대 한도 = 1000, 최대 오프셋 = 9000 | 
| 와일드카드 쿼리 | 와일드카드 쿼리는 "\*" 및 "?"를 사용하여 보다 유연하게 검색할 수 있습니다. "\*"는 모든 문자 시퀀스(길이가 0인 값 포함)와 일치하고 "?"는 모든 단일 문자와 일치합니다.<br />StudyDescription에 "Nuclear"가 포함된 데이터 스토어에서 모든 연구를 검색합니다.<br />`.../studies?StudyDescription=*Nuclear*`<br />StudyDescription이 "Nuclear"로 끝나는 모든 연구를 검색합니다.<br />`.../studies?StudyDescription=*Nuclear`<br />StudyDescription이 "Nuclear"로 시작하는 모든 연구를 검색합니다.<br />`.../studies?StudyDescription=Nuclear*`<br />PatientID가 200965981 뒤에 정확히 3자를 가지고 있는 모든 연구를 검색합니다.<br />`.../studies?PatientID=200965981???` | 
| FuzzyMatching 쿼리 | fuzzymatching 선택적 쿼리 파라미터를 추가하여 이름 DICOM 속성(PatientName(0010,0010), ReferringPhysicianName(0008,0090))에서 퍼지 매칭을 활성화합니다.<br />`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`<br />이 쿼리는 PatientName 값의 모든 부분에서 대소문자를 구분하지 않는 접두사 단어 일치를 수행합니다. "thomas", "Albert", "Thomas Albert", "Thomas^Albert"와 같은 PatientName 값으로 결과를 반환하지만 "hom" 또는 "ber"는 반환하지 않습니다. | 

**Topics**
+ [HealthImaging용 DICOMweb 검색 APIs](#dicomweb-search-services)
+ [HealthImaging에 지원되는 DICOMweb 쿼리 유형](#dicomweb-query-types)
+ [HealthImaging에서 DICOM 연구 검색](dicomweb-search-studies.md)
+ [HealthImaging에서 DICOM 시리즈 검색](dicomweb-search-series.md)
+ [HealthImaging에서 DICOM 인스턴스 검색](dicomweb-search-instances.md)