Healthcare 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 -

基本

基本资源中支持以下元素。

元素 可编入索引 可搜索 可检索 参考支持 限制条件
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

组成

支持组合资源中的以下元素。

元素 可编入索引 可搜索 可检索 参考支持 限制条件
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
  • 文本/html
  • text/plain
  • 文本/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 资源中的以下元素。

元素 可编入索引 可搜索 可检索 参考支持 限制条件
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 - 仅患者。

疫苗接种数据

免疫资源支持以下元素。

元素 可编入索引 可搜索 可检索 参考支持 限制条件
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 资源中的以下元素受支持。

元素 可编入索引 可搜索 可检索 参考支持 限制条件
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 -

患者

支持患者资源中的以下元素。

元素 可编入索引 可搜索 可检索 参考支持 限制条件
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 资源中的以下元素受支持。

元素 可编入索引 可搜索 可检索 参考支持 限制条件
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
  • 文本/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 仅限名称的第一个实例。