의료 FHIR R4 데이터 스키마 참조

Vertex AI Search는 FHIR R4 리소스의 하위 집합을 지원합니다. 이 페이지에는 지원되는 FHIR 리소스 및 요소와 색인 생성 가능 여부, 검색 가능성, 가져오기 가능성과 같은 Google이 정의한 스키마 구성이 나와 있습니다. 데이터 스토어를 만들 때 맞춤 스키마 옵션을 선택하여 데이터 스토어를 만들 때 스키마 구성을 수정하거나 데이터 스토어를 만든 후 구성을 수정할 수 있습니다.

리소스 수준 사양

Vertex AI Search는 다음 리소스 및 리소스 참조를 지원합니다.

데이터 스토어 수준 사양

데이터 스토어 내의 다음 속성이 지원됩니다.

속성 색인 생성 가능 검색 가능 가져오기 가능
id
resource_type
resource_datetime
patient_id

필드 수준 사양

Vertex AI Search는 지원되는 각 FHIR 리소스 내에서 FHIR 데이터 요소의 하위 집합을 지원합니다. 다음 섹션에서는 지원되는 모든 FHIR 리소스에 지원되는 요소를 나열하고 이러한 조건에서 요소를 색인 생성, 검색, 검색할 수 있는지 여부를 설명합니다.

  • 반복되는 요소에 빈 색인이 있거나 []이면 이 요소의 모든 인스턴스가 지원됩니다. 예를 들어 AllergyIntolerance 리소스에서는 clinicalStatus.coding[].code의 모든 인스턴스가 지원됩니다.
  • 반복되는 요소에 특정 색인 또는 [0]가 있는 경우 첫 번째 인스턴스만 지원됩니다. 예를 들어 컴포지션 리소스에서는 author[0].display의 첫 번째 인스턴스만 지원됩니다.
  • 상대 리소스 참조는 Resource/resourceId 형식으로 지원됩니다. 예를 들어 subject.reference의 값은 Patient/034AB16여야 합니다.
  • 절대 참조는 바이너리 리소스에서만 지원되며 데이터 유형이 attachment로 설정된 경우에만 지원됩니다. 절대 참조는 다음 패턴을 따르는 Cloud Storage 위치에서만 지원됩니다. gs://BUCKET_NAME/FILE_PATH.
  • 내부 또는 논리적 참조는 지원되지 않으며 이러한 참조는 확인되지 않습니다.

AllergyIntolerance

AllergyIntolerance 리소스 내에서 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
asserter.display
asserter.reference 의료인만 해당
clinicalStatus.coding[].code
clinicalStatus.coding[].display
clinicalStatus.coding[].system
code.coding[].code
code.coding[].display
code.coding[].system
code.text
encounter.reference
id
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
patient.reference 환자만 해당
reaction[].description
reaction[].manifestation[].text
reaction[].severity
recordedDate
recorder.display
recorder.reference 의료인만 해당
verificationStatus.coding[].code
verificationStatus.coding[].display
verificationStatus.coding[].system

Basic

기본 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
author.display
author.reference 의료인만 해당
code.coding[].code
code.coding[].display
code.coding[].system
code.text
created
id
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
subject.reference 환자만 해당
text.div

Composition

컴포지션 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
author[0].display
author[0].reference 의료인만 해당
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
date
encounter.reference
id
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
section[].text.div 리소스를 색인화하려면 이 필드가 있어야 합니다.
status
subject.reference 환자만 해당
title
type.coding[].code
type.coding[].display
type.coding[].system
type.text

Condition

조건 리소스 내에서 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
asserter.display
asserter.reference 의료인만 해당
bodySite[].coding[].code
bodySite[].coding[].display
bodySite[].coding[].system
bodySite[].text
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
clinicalStatus.coding[].code
clinicalStatus.coding[].display
clinicalStatus.coding[].system
code.coding[].code
code.coding[].display
code.coding[].system
code.text
encounter.reference
id
identifier[].system
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
onsetDateTime
onsetPeriod.end
onsetPeriod.start
recordedDate
recorder.display
recorder.reference 의료인만 해당
subject.reference 환자만 해당
verificationStatus.coding[].code
verificationStatus.coding[].display
verificationStatus.coding[].system

DiagnosticReport

DiagnosticReport 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
conclusion
effectiveDateTime
id
imagingStudy[].imagingStudyId
issued
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
performer[0].display
performer[0].reference 의료인만 해당
subject.reference 환자만 해당

DocumentReference

DocumentReference 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
authenticator.display
authenticator.reference
author[0].display
author[0].reference
content[0].attachment.contentType

지원되는 MIME 유형:

  • application/json
  • application/pdf
  • application/rtf
  • application/xhtml+xml
  • application/xml
  • image/bmp
  • image/gif
  • image/jpeg
  • image/png
  • image/tiff
  • text/html
  • text/plain
  • text/xml
content[0].attachment.creation
content[0].attachment.title
content[0].attachment.url
content[0].format.code
content[0].format.display
content[0].format.system
context.encounter[].reference
context.period.end
context.period.start
custodian.display
custodian.reference 의료인만 해당
date
description
docStatus
id
identifier[].system
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
status
subject.reference 환자만 해당
type.coding[].code
type.coding[].display
type.coding[].system
type.text

Encounter

Encounter(접촉) 리소스 내에서 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
class.code
class.display
class.system
id
identifier[].system
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
participant[0].individual.display
participant[0].individual.reference 의료인만 해당
participant[].type[].coding[].code
participant[].type[].coding[].display
participant[].type[].coding[].system
participant[].type[].text
period.end
period.start
reasonCode[].coding[].code
reasonCode[].coding[].display
reasonCode[].coding[].system
reasonCode[].text
serviceType.coding[].code
serviceType.coding[].display
serviceType.coding[].system
serviceType.text
status
subject.reference 환자만 해당
type[].coding[].code
type[].coding[].display
type[].coding[].system
type[].text

ImagingStudy

ImagingStudy 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
description
encounter.reference
endpoint[0].reference
id
identifier[].system
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
modality[].code
modality[].display
modality[].system
note[].text
procedureCode[].coding[].code
procedureCode[].coding[].display
procedureCode[].coding[].system
procedureCode[].text
referrer.display
referrer.reference 의료인만 해당
started
status
subject.reference 환자만 해당

Immunization

Immunization(예방 접종) 리소스 내에서 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
encounter.reference
id
identifier[].system
identifier[].value
manufacturer.display
manufacturer.reference
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
occurrenceDateTime
occurrenceString
patient.reference 환자만 해당
primarySource
recorded
status
statusReason.coding[].code
statusReason.coding[].display
statusReason.coding[].system
statusReason.text
vaccineCode.coding[].code
vaccineCode.coding[].display
vaccineCode.coding[].system
vaccineCode.text

MedicationAdministration

MedicationAdministration 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
category.coding[].code
category.coding[].display
category.coding[].system
category.text
context.reference
dosage.dose.unit
dosage.dose.value
dosage.method.coding[].code
dosage.method.coding[].display
dosage.method.coding[].system
dosage.method.text
dosage.rateQuantity.unit
dosage.rateQuantity.value
dosage.route.coding[].code
dosage.route.coding[].display
dosage.route.coding[].system
dosage.route.text
dosage.site.coding[].code
dosage.site.coding[].display
dosage.site.coding[].system
dosage.site.text
dosage.text
effectiveDateTime
effectivePeriod.end
effectivePeriod.start
id
identifier[].system
identifier[].value
medicationCodeableConcept.coding[].code
medicationCodeableConcept.coding[].display
medicationCodeableConcept.coding[].system
medicationCodeableConcept.text
medicationReference.display
medicationReference.reference 의약품만 해당
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
performer[0].actor.display
performer[0].actor.reference 의료인만 해당
request.reference
status
subject.reference 환자만 해당

MedicationDispense

MedicationDispense 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
category.coding[].code
category.coding[].display
category.coding[].system
category.text
context.reference
daysSupply.code
daysSupply.system
daysSupply.unit
daysSupply.value
dosageInstruction[].doseAndRate[].doseQuantity.unit
dosageInstruction[].doseAndRate[].doseQuantity.value
dosageInstruction[].doseAndRate[].rateQuantity.unit
dosageInstruction[].doseAndRate[].rateQuantity.value
dosageInstruction[].method.coding[].code
dosageInstruction[].method.coding[].display
dosageInstruction[].method.coding[].system
dosageInstruction[].method.text
dosageInstruction[].route.coding[].code
dosageInstruction[].route.coding[].display
dosageInstruction[].route.coding[].system
dosageInstruction[].route.text
dosageInstruction[].site.coding[].code
dosageInstruction[].site.coding[].display
dosageInstruction[].site.coding[].system
dosageInstruction[].site.text
dosageInstruction[].text
id
identifier[].system
identifier[].value
medicationCodeableConcept.coding[].code
medicationCodeableConcept.coding[].display
medicationCodeableConcept.coding[].system
medicationCodeableConcept.text
medicationReference.display
medicationReference.reference 의약품만 해당
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
quantity.code
quantity.system
quantity.unit
quantity.value
status
statusReasonCodeableConcept.coding[].code
statusReasonCodeableConcept.coding[].display
statusReasonCodeableConcept.coding[].system
statusReasonCodeableConcept.text
subject.reference 환자만 해당
whenHandedOver

MedicationRequest

MedicationRequest 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
authoredOn
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
dosageInstruction[].doseAndRate[].doseQuantity.unit
dosageInstruction[].doseAndRate[].doseQuantity.value
dosageInstruction[].patientInstruction
dosageInstruction[].route.text
dosageInstruction[].text
dosageInstruction[].timing.code.text
id
medicationCodeableConcept.coding[].code
medicationCodeableConcept.coding[].display
medicationCodeableConcept.coding[].system
medicationCodeableConcept.text
medicationReference.display
medicationReference.reference 의약품만 해당
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
reportedBoolean
reportedReference.display
reportedReference.reference
requester.display
requester.reference 의료인만 해당
status
subject.reference 환자만 해당

MedicationStatement

MedicationStatement 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
category.coding[].code
category.coding[].display
category.coding[].system
category.text
context.reference
dateAsserted
dosage[].doseAndRate[].doseQuantity.unit
dosage[].doseAndRate[].doseQuantity.value
dosage[].patientInstruction
dosage[].route.coding[].code
dosage[].route.coding[].display
dosage[].route.coding[].system
dosage[].route.text
dosage[].text
dosage[].timing.code.text
effectiveDateTime
effectivePeriod.end
effectivePeriod.start
id
medicationCodeableConcept.coding[].code
medicationCodeableConcept.coding[].display
medicationCodeableConcept.coding[].system
medicationCodeableConcept.text
medicationReference.display
medicationReference.reference
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
status
subject.reference

Observation

Observation 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
category[].coding[].code
category[].coding[].display
category[].coding[].system
code.coding[].code
code.coding[].display
code.coding[].system
code.text
component[].code.coding[].code
component[].code.coding[].display
component[].code.coding[].system
component[].code.text
component[].valueQuantity.unit
component[].valueQuantity.value
effectiveDateTime
encounter.reference
id
issued
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
performer[].display
performer[].reference 의료인만 해당
status
subject.reference 환자만 해당
valueQuantity.unit
valueQuantity.value
valueString

Patient

Patient(환자) 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
active
birthDate
gender
id
identifier[].system
identifier[].type.coding[].code
identifier[].type.coding[].display
identifier[].type.coding[].system
identifier[].type.text
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
name[].family
name[].given[]
name[].text

Procedure

Procedure(절차) 리소스 내에서 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
basedOn[].display
basedOn[].reference
bodySite[].coding[].code
bodySite[].coding[].display
bodySite[].coding[].system
bodySite[].text
category.coding[].code
category.coding[].display
category.coding[].system
category.text
code.coding[].code
code.coding[].display
code.coding[].system
code.text
encounter.reference
id
identifier[].system
identifier[].value
location.display
location.reference
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
performedDateTime
performer[0].actor.display
performer[0].actor.reference 의료인만 해당
recorder.display
recorder.reference
status
statusReason.coding[].code
statusReason.coding[].display
statusReason.coding[].system
statusReason.text
subject.reference 환자만 해당

ServiceRequest

ServiceRequest 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
authoredOn
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
code.coding[].code
code.coding[].display
code.coding[].system
code.text
id
intent
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
priority
requester.display
requester.reference 의료인만 해당
status
subject.reference 환자만 해당

참조

Vertex AI Search는 검색을 포괄적으로 만들기 위해 특정 참조를 확인합니다. 예를 들어 의료인 이름을 검색하고 해당 의료인을 언급하는 리소스를 찾을 수 있습니다. 참조 컨텍스트에서 지원되는 리소스는 다음과 같습니다. 또한 참조가 포함된 리소스를 검색할 때는 리소스 내에 지정된 요소만 사용됩니다.

리소스 요소 가져오기 가능 색인 생성 가능 검색 가능 제약조건
바이너리 id
바이너리 contentType
  • application/json
  • application/pdf
  • application/rtf
  • application/xhtml+xml
  • application/xml
  • image/bmp
  • image/gif
  • image/jpeg
  • image/png
  • image/tiff
  • text/html
  • text/plain
  • text/xml
바이너리 data
의약품 id
의약품 code.coding[].code
의약품 code.coding[].system
의약품 code.coding[].display
의료인 id
의료인 name[0].family 이름의 첫 번째 인스턴스만 해당
의료인 name[0].given[] 이름의 첫 번째 인스턴스만 해당
의료인 name[0].text 이름의 첫 번째 인스턴스만 해당