Pesquisa pontual no Amazon OpenSearch Service

Point in Time (PIT) é um tipo de pesquisa que permite executar consultas diferentes em um conjunto de dados 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 search_after funcionalidade. Esse é o método de paginação preferido 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 o PIT com um domínio executando a OpenSearch versão 2.5.

nota

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

Considerações

Considere o seguinte ao configurar suas pesquisas com o PIT:

• Se você estiver atualizando do domínio executando a OpenSearch versão 2.3 e precisar de um controle de acesso refinado nas ações do PIT, precisará adicionar manualmente essas ações e funções.

• Não há resiliência para o PIT. A reinicialização do nó, o encerramento do nó, as implantações em azul/verde e a reinicialização do OpenSearch processo fazem com que todos os dados do PIT sejam perdidos.

• 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 _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ê estiver atualizando para um domínio da OpenSearch versão 2.5 e precisar de um controle de acesso refinado, precisará criar funções manualmente 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 a OpenSearch versão 2.5 e superior, você pode usar a point_in_time_full_access função integrada. Para obter mais informações, consulte Modelo de segurança na OpenSearch documentação.

Configurações do PIT

OpenSearch permite que você altere todas as configurações de PIT disponíveis usando a _cluster/settings API. No momento, no OpenSearch Serviço, você não pode 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 ter mais informações, consulte Pesquisa entre clusters no Amazon Service OpenSearch .

UltraWarm

As pesquisas PIT com UltraWarm índices continuam funcionando. Para ter mais informações, consulte UltraWarm armazenamento para Amazon OpenSearch Service.

nota

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