Níveis de consistência de pesquisa do FHIR - AWS HealthLake
Níveis de consistênciaExemplo de usoPráticas recomendadas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Níveis de consistência de pesquisa do FHIR

O índice HealthLake de pesquisa da AWS opera em um modelo de consistência eventual para GET e POST com operações de PESQUISA. Com consistência eventual, se houver uma atualização pendente do índice de pesquisa para um recurso, os resultados da pesquisa excluirão a versão N-1 do recurso até que a atualização do índice seja concluída.

A AWS HealthLake agora inclui a capacidade de selecionar como o modelo de consistência se comportará para recursos atualizados. Os desenvolvedores podem incluir “Consistência eventual”, o comportamento padrão descrito acima, ou “Consistência forte”. O Strong Consistency permitirá que a versão N-1 do recurso para recursos com atualizações pendentes do índice de pesquisa seja incluída nos resultados da pesquisa. Isso pode ser usado para cenários de casos de uso em que todos os recursos são necessários no resultado, mesmo quando a atualização do índice de pesquisa ainda não foi concluída. Os clientes podem controlar esse comportamento usando o cabeçalho da x-amz-fhir-history-consistency-level solicitação.

Níveis de consistência

Consistência forte

Configure x-amz-fhir-history-consistency-level: strong para retornar todos os registros correspondentes, incluindo aqueles com atualizações pendentes do índice de pesquisa. Use essa opção quando precisar pesquisar recursos imediatamente após as atualizações.

Consistência eventual

x-amz-fhir-history-consistency-level: eventualDefina para retornar somente registros que tenham concluído as atualizações do índice de pesquisa. Esse é o comportamento padrão se nenhum nível de consistência for especificado.

Exemplo de uso

  1. Ao atualizar um 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. Pesquisa subseqüente:

    GET <baseURL>/Patient?_id=123

Práticas recomendadas

  • Use uma consistência forte quando precisar pesquisar imediatamente recursos atualizados recentemente

  • Use a consistência eventual para consultas gerais em que a visibilidade imediata não é essencial

  • Considere a compensação entre visibilidade imediata e impacto potencial no desempenho

nota

A configuração do nível de consistência afeta a rapidez com que os recursos atualizados aparecem nos resultados da pesquisa, mas não afeta o armazenamento real dos recursos.

Definir o x-amz-fhir-history-consistency-level cabeçalho opcional como 'forte' dobra o consumo da capacidade de gravação por recurso.

Esse recurso é aplicável somente para armazenamentos de dados com histórico de versões ativado (todos os armazenamentos de dados criados após 25 de outubro de 2024 o têm ativado por padrão).