의료 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]가 있는 경우 첫 번째 인스턴스만 지원됩니다. 예를 들어 Composition 리소스에서는 author[0].display의 첫 번째 인스턴스만 지원됩니다.
  • 상대 리소스 참조는 Resource/resourceId 형식으로 지원됩니다. 예를 들어 subject.reference의 값은 Patient/034AB16이어야 합니다.
  • 절대 참조는 데이터 유형이 attachment로 설정된 Binary 리소스에만 지원됩니다. 절대 참조는 다음 패턴을 따르는 Cloud Storage 위치에만 지원됩니다. gs://BUCKET_NAME/FILE_PATH.
  • 내부 또는 논리적 참조는 지원되지 않으며 이러한 참조는 확인되지 않습니다.

AllergyIntolerance

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

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
asserter.display
asserter.reference Practitioner만 해당.
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 Patient만 해당.
reaction[].description
reaction[].manifestation[].text
reaction[].severity
recordedDate
recorder.display
recorder.reference Practitioner만 해당.
verificationStatus.coding[].code
verificationStatus.coding[].display
verificationStatus.coding[].system

Basic

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

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
author.display
author.reference Practitioner만 해당.
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 Patient만 해당.
text.div

Composition

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

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
author[0].display
author[0].reference Practitioner만 해당.
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 Patient만 해당.
title
type.coding[].code
type.coding[].display
type.coding[].system
type.text

Condition

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

요소 색인 생성 가능 검색 가능 가져오기 가능 참조 지원 제약조건
asserter.display
asserter.reference Practitioner만 해당.
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 Practitioner만 해당.
subject.reference Patient만 해당.
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 Practitioner만 해당.
subject.reference Patient만 해당.

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 Practitioner만 해당.
date
description
docStatus
id
identifier[].system
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
status
subject.reference Patient만 해당.
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 Practitioner만 해당.
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 Patient만 해당.
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 Practitioner만 해당.
started
status
subject.reference Patient만 해당.

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 Patient만 해당.
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 Medication만 해당.
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
performer[0].actor.display
performer[0].actor.reference Practitioner만 해당.
request.reference
status
subject.reference Patient만 해당.

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 Medication만 해당.
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 Patient만 해당.
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 Medication만 해당.
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
reportedBoolean
reportedReference.display
reportedReference.reference
requester.display
requester.reference Practitioner만 해당.
status
subject.reference Patient만 해당.

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 Practitioner만 해당.
status
subject.reference Patient만 해당.
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 Practitioner만 해당.
recorder.display
recorder.reference
status
statusReason.coding[].code
statusReason.coding[].display
statusReason.coding[].system
statusReason.text
subject.reference Patient만 해당.

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 Practitioner만 해당.
status
subject.reference Patient만 해당.

참조

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

리소스 요소 가져오기 가능 색인 생성 가능 검색 가능 제약조건
Binary id
Binary 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
Binary data
Medication id
Medication code.coding[].code
Medication code.coding[].system
Medication code.coding[].display
Practitioner id
Practitioner name[0].family 이름의 첫 번째 인스턴스만 해당.
Practitioner name[0].given[] 이름의 첫 번째 인스턴스만 해당.
Practitioner name[0].text 이름의 첫 번째 인스턴스만 해당.