를 사용하여 개념 세부 정보 검색 $lookup - AWS HealthLake
사용량지원되는 파라미터예시응답 파라미터동작오류 처리경고

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

를 사용하여 개념 세부 정보 검색 $lookup

AWS HealthLake 는 이제 CodeSystem 리소스에 대한 $lookup 작업을 지원하므로 코드와 같은 식별 정보를 제공하여 코드 시스템의 특정 개념에 대한 세부 정보를 검색할 수 있습니다. 이 작업은 다음이 필요한 경우에 특히 유용합니다.

  • 특정 의료 코드에 대한 세부 정보 검색

  • 코드 의미 및 속성 검증

  • 액세스 개념 정의 및 관계

  • 정확한 용어 데이터로 임상 의사 결정 지원

사용량

$lookup 작업은 GET 및 POST 메서드를 모두 사용하여 CodeSystem 리소스에서 호출할 수 있습니다.

지원되는 작업

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup

지원되는 파라미터

HealthLake는 FHIR R4 $lookup 파라미터의 하위 집합을 지원합니다.

파라미터 Type 필수 설명
code code 예 찾고 있는 개념 코드(예: SNOMED CT의 "71620000")
system uri 예 코드 시스템의 정식 URL(예: "http://snomed.info/sct")
version 문자열 No 코드 시스템의 특정 버전

예시

GET 요청

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
POST 요청

POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
샘플 응답

작업은 개념 세부 정보가 포함된 파라미터 리소스를 반환합니다.

{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}

응답 파라미터

응답에는 사용 가능한 경우 다음 파라미터가 포함됩니다.

파라미터 유형 설명
name 문자열 코드 시스템 이름
version 문자열 코드 시스템 버전
display 문자열 개념의 표시 이름
designation BackboneElement 이 개념에 대한 추가 표현입니다.
property BackboneElement 개념의 추가 속성(정의, 관계 등)

동작

$lookup 작업:

  1. 필수 파라미터(code 및 system)를 검증합니다.

  2. 데이터 스토어에 저장된 지정된 코드 시스템 내에서 개념을 검색합니다.

  3. 표시 이름, 지정 및 속성을 포함한 자세한 개념 정보를 반환합니다.

  4. version 파라미터가 제공될 때 버전별 조회 지원

  5. HealthLake 데이터 스토어에 명시적으로 저장된 코드 시스템에서만 작동합니다.

오류 처리

작업은 다음 오류 조건을 처리합니다.

  • 400 잘못된 요청: 잘못된 $lookup 작업(부적합 요청 또는 필수 파라미터 누락)

  • 404 찾을 수 없음: 코드 시스템을 찾을 수 없거나 지정된 코드 시스템에서 코드를 찾을 수 없음

경고

이번 릴리스에서는 다음이 지원되지 않습니다.

  • $lookup 외부 용어 서버를 호출하여 작업

  • $lookup HealthLake에서 관리하지만 데이터 스토어에 명시적으로 저장되지 않은 CodeSystems에서의 작업

$lookup 작업 사양에 대한 자세한 내용은 FHIR R4 CodeSystem $lookup 설명서를 참조하세요.