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
  • 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 资源中的以下元素。

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