Pesquisa de ponto de tempo no Amazon OpenSearch Service - OpenSearch Serviço Amazon
ConsideraçõesCriar um PITPermissões pontuaisConfigurações do PITPesquisa entre clustersUltraWarm

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á.

Pesquisa de ponto de tempo no Amazon OpenSearch Service

Point in Time (PIT) é um tipo de pesquisa que permite executar diversas consultas em um conjunto de dados que é fixo no tempo. Normalmente, quando você executa a mesma consulta no mesmo índice em momentos diferentes, recebe resultados diferentes porque os documentos são constantemente indexados, atualizados e excluídos. Com o PIT, você pode consultar um estado constante do seu conjunto de dados.

O principal uso da pesquisa PIT é combiná-la com a funcionalidade search_after. Esse é o método de paginação preferido no OpenSearch, especialmente para paginação profunda, porque opera em um conjunto de dados congelado no tempo, não está vinculado a uma consulta e oferece suporte à paginação consistente para frente e para trás. Você pode usar a pesquisa PIT com um domínio que executa o OpenSearch versão 2.5.

nota

Este tópico fornece uma visão geral da pesquisa PIT e alguns aspectos a considerar ao usá-la em um domínio gerenciado do Amazon OpenSearch Service em vez de em um cluster autogerenciado do OpenSearch. Para obter a documentação completa da pesquisa PIT, incluindo uma referência de API abrangente, consulte Point in Time na documentação do OpenSearch de código aberto.

Considerações

Considere o seguinte ao configurar suas pesquisas com o PIT:

  • Se você for atualizar de um domínio que executa o OpenSearch versão 2.3 e precisar de controle refinado de acesso em ações PIT, será necessário adicionar manualmente essas ações e perfis.

  • Não há resiliência para o PIT. A reinicialização de nós, o encerramento de nós, as implantações azul/verde e o reinício de processos do OpenSearch causam a perda de todos dados PIT.

  • Se um fragmento for realocado durante a implantação azul/verde, somente segmentos de dados ativos serão transferidos para o novo nó. Segmentos de fragmentos mantidos pelo PIT (tanto exclusivos quanto aqueles compartilhados com dados ativos) permanecem no nó antigo.

  • Atualmente, as pesquisas com PIT não funcionam com a pesquisa assíncrona.

Criar um PIT

Para executar uma consulta PIT, envie solicitações HTTP para _search/point_in_time usando o seguinte formato:

POST opensearch-domain/my-index/_search/point_in_time?keep_alive=time

Você pode especificar as seguintes opções de PIT:

Opções Descrição Valor padrão Obrigatório
keep_alive

A quantidade de tempo para manutenção do PIT. Toda vez que você acessa um PIT com uma solicitação de pesquisa, a vida útil do PIT é estendida pela quantidade de tempo igual ao parâmetro keep_alive. Esse parâmetro de consulta é obrigatório quando você cria um PIT, mas é opcional em uma solicitação de pesquisa.

 Sim
preference

Uma string que especifica o nó ou o fragmento usado para realizar a pesquisa.

 Aleatório Não
routing Uma string que especifica o roteamento de solicitações de pesquisa para um fragmento específico. O documento é _id Não
expand_wildcards Uma string que especifica o tipo de índice que pode corresponder ao padrão curinga. É compatível com valores separados por vírgulas. Os valores válidos são os seguintes:

  • all: combine qualquer índice ou fluxo de dados, inclusive os ocultos.

  • open: combine índices abertos e não ocultos ou fluxos de dados não ocultos.

  • closed: combine índices fechados e não ocultos ou fluxos de dados não ocultos.

  • hidden: combine índices ou fluxos de dados ocultos. Deve ser combinado com aberto, fechado ou aberto e fechado.

  • none: nenhum padrão curinga é aceito.

 open Não
allow_partial_pit_creation Um booleano que especifica se um PIT deve ser criado com falhas parciais. true Não

Exemplo de resposta

{
    "pit_id": "o463QQEPbXktaW5kZXgtMDAwMDAxFnNOWU43ckt3U3IyaFVpbGE1UWEtMncAFjFyeXBsRGJmVFM2RTB6eVg1aVVqQncAAAAAAAAAAAIWcDVrM3ZIX0pRNS1XejE5YXRPRFhzUQEWc05ZTjdyS3dTcjJoVWlsYTVRYS0ydwAA",
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "creation_time": 1658146050064
}

Ao criar um PIT, você recebe um PIT ID na resposta. Esse é o ID que você usa para realizar pesquisas com o PIT.

Permissões pontuais

O PIT é compatível com o controle de acesso detalhado. Se você for atualizar para um domínio do OpenSearch versão 2.5 e precisar de controle de acesso refinado, será necessário criar manualmente perfis com as seguintes permissões:

# Allows users to use all point in time search search functionality
point_in_time_full_access:
  reserved: true
  index_permissions:
    - index_patterns:
        - '*'
      allowed_actions:
        - "indices:data/read/point_in_time/create"
        - "indices:data/read/point_in_time/delete"
        - "indices:data/read/point_in_time/readall"
        - "indices:data/read/search"
        - "indices:monitor/point_in_time/segments"
        

# Allows users to use point in time search search functionality for specific index
# All type operations like list all PITs, delete all PITs are not supported in this case

point_in_time_index_access:
  reserved: true
  index_permissions:
    - index_patterns:
        - 'my-index-1'
      allowed_actions:
        - "indices:data/read/point_in_time/create"
        - "indices:data/read/point_in_time/delete"
        - "indices:data/read/search"
        - "indices:monitor/point_in_time/segments"

Para domínios com o OpenSearch versão 2.5 e acima, você pode usar o perfil integrado point_in_time_full_access. Para obter mais informações, consulte modelo de Segurança na documentação do OpenSearch.

Configurações do PIT

O OpenSearch permite alterar todas as configurações de PIT disponíveis via API _cluster/settings. No OpenSearch Service, atualmente não é possível modificar as configurações.

Pesquisa entre clusters

Você pode criar PITs, pesquisar com PIT IDs, listar PITs e excluir PITs em clusters com as pequenas limitações a seguir:

  • Você pode listar todos e excluir todos os PITs somente no domínio de origem.

  • Não é possível minimizar round trips de rede como parte de uma consulta de pesquisa entre clusters.

Para obter mais informações, consulte Pesquisa entre clusters no Amazon Service OpenSearch .

UltraWarm

O PIT faz buscas com índices UltraWarm continuam funcionando. Para obter mais informações, consulte Armazenamento UltraWarm para Amazon OpenSearch Service.

nota

Você pode monitorar estatísticas da pesquisa PIT no CloudWatch. Para obter uma lista completa de métricas, consulte Métricas pontuais.