Niveles de consistencia de búsqueda del FHIR - AWS HealthLake
Niveles de consistenciaEjemplo de usoPrácticas recomendadas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Niveles de consistencia de búsqueda del FHIR

El índice HealthLake de búsqueda de AWS funciona según un modelo de coherencia eventual para GET y POST con las operaciones de BÚSQUEDA. En aras de la coherencia, si hay una actualización pendiente del índice de búsqueda de un recurso, los resultados de la búsqueda excluyen la versión N-1 del recurso hasta que se complete la actualización del índice.

AWS HealthLake ahora incluye la posibilidad de seleccionar cómo se comportará el modelo de coherencia para los recursos actualizados. Los desarrolladores pueden incluir «coherencia eventual», el comportamiento predeterminado descrito anteriormente, o «coherencia sólida». Strong Consistency permitirá incluir en los resultados de la búsqueda la versión N-1 del recurso para los recursos con actualizaciones pendientes de los índices de búsqueda. Esto se puede utilizar en casos de uso en los que se requieran todos los recursos en el resultado, incluso cuando la actualización del índice de búsqueda aún no se haya completado. Los clientes pueden controlar este comportamiento mediante el encabezado de la x-amz-fhir-history-consistency-level solicitud.

Niveles de consistencia

Consistencia sólida

x-amz-fhir-history-consistency-level: strongConfigúrelo para que devuelva todos los registros coincidentes, incluidos aquellos con actualizaciones pendientes en el índice de búsqueda. Utilice esta opción cuando necesite buscar recursos inmediatamente después de las actualizaciones.

Consistencia final

x-amz-fhir-history-consistency-level: eventualConfigúrelo para que se devuelvan solo los registros que hayan completado las actualizaciones del índice de búsqueda. Este es el comportamiento predeterminado si no se especifica ningún nivel de coherencia.

Ejemplo de uso

  1. Al actualizar un recurso:

    POST <baseURL>/Patient
Content-Type: application/fhir+json
x-amz-fhir-history-consistency-level: strong

{
  "resourceType": "Patient",
  "id": "123",
  "meta": {
    "profile": ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"]
  },
  "identifier": [
    {
      "system": "http://example.org/identifiers",
      "value": "123"
    }
  ],
  "active": true,
  "name": [
    {
      "family": "Smith",
      "given": ["John"]
    }
  ],
  "gender": "male",
  "birthDate": "1970-01-01"
}

  2. Búsqueda posterior:

    GET <baseURL>/Patient?_id=123

Prácticas recomendadas

  • Utilice una coherencia sólida cuando necesite buscar inmediatamente recursos actualizados recientemente

  • Utilice la coherencia eventual para las consultas generales en las que la visibilidad inmediata no sea fundamental

  • Tenga en cuenta el equilibrio entre la visibilidad inmediata y el posible impacto en el rendimiento

nota

La configuración del nivel de coherencia afecta a la rapidez con la que aparecen los recursos actualizados en los resultados de búsqueda, pero no afecta al almacenamiento real de los recursos.

Si se establece el x-amz-fhir-history-consistency-level encabezado opcional en «fuerte», se duplica el consumo de capacidad de escritura por recurso.

Esta función solo se aplica a los almacenes de datos que tienen activado el historial de versiones (todos los almacenes de datos creados después del 25 de octubre de 2024 lo tienen activado de forma predeterminada).