Integridad referencial de FHIR

En esta página, se explica el concepto de integridad referencial en relación con los recursos dentro de un almacén FHIR en la API de Cloud Healthcare.

El almacén de FHIR aplica la integridad referencial en las referencias a otros recursos dentro del mismo almacén:

  • Cuando se crea, se actualiza o se aplica un parche a un recurso, la operación fallará si el contenido resultante del recurso contiene una referencia a un recurso o a una versión del recurso que no existe.
  • La operación fallará si hay otros recursos en el almacén que hagan referencia a ese recurso cuando lo borras.

La integridad referencial se puede inhabilitar mediante la configuración de la opción disableReferentialIntegrity en el momento de la creación del almacén.

Exclusiones y limitaciones

La especificación de FHIR permite varias formas de referencias, algunas de las cuales la integridad referencial no abarca:

  • una URL especifica una referencia externa que no coincide con la URL base del almacén de FHIR.
  • Un identificador de empresa que especifica una referencia lógica.
  • Una referencia que contiene solo una string visible legible.
  • Problema conocido: Las referencias dentro de las extensiones de FHIR no están sujetas a la integridad referencial.

Algunos métodos de la API pueden provocar que se infrinja la integridad referencial en algunas condiciones:

  • FHIR permite que las referencias apunten a una versión del historial específica de un recurso mediante el formulario [resource type]/[resource ID]/_history/[version ID]. La integridad referencial se aplica a estas referencias cuando se crean o se actualizan, pero cuando se usa el método Resource-purge para quitar versiones históricas de un recurso, las referencias entrantes no se verifican.
  • El método import de FHIR no aplica la integridad referencial. El método se puede usar en casos en los que no se requiere la integridad referencial o cuando se sabe que la entrada cumple con la integridad referencial. En el último caso, las referencias dentro del almacén de FHIR alcanzarán la coherencia eventual después de que cada recurso se importe de forma correcta.
  • El método deidentify puede crear un almacén de FHIR en un estado que no cumple con la integridad referencial de forma temporal durante la operación o de forma permanente si se usan filtros para seleccionar un subconjunto de recursos.

Un estado en el que se aplica la integridad, pero se infringió en uno de los casos anteriores, hará que las actualizaciones de recursos se rechacen en un recurso que contenga una referencia no válida, a menos que la actualización corrija o quite todas las referencias no válidas. Este estado también puede crear dificultades para las aplicaciones mediante el almacén que asume la integridad.

Recursos contenidos

La especificación de FHIR contiene una restricción de que cada recurso contenido debe referenciarse desde algún lugar dentro del recurso que lo contiene (incluidas las referencias de otros recursos contenidos) y cada referencia a un recurso contenido debe ser válida. Esta restricción se aplica por separado de la integridad referencial y no se puede inhabilitar como se define en las invariables FHIRPath en cada recurso individual.