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 pontual 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 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](https://opensearch.org/docs/latest/opensearch/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 blue/green implantação, 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 | Description | Valor padrão | Obrigatório |
| --- | --- | --- | --- |
| keep\$1alive | 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 é \$1id | Não |
| expand\$1wildcards | 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:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/pit.html) | open | Não |
| allow\$1partial\$1pit\$1creation | 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](fgac.md). 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]( https://opensearch.org/docs/latest/search-plugins/point-in-time/#security-model) na OpenSearch documentação.
## Configurações do PIT
OpenSearch permite que você altere todas as [configurações de PIT](https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#pit-settings) 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 PITs, listar e excluir PITs em clusters com as seguintes pequenas limitações:
+ Você pode listar tudo e excluir tudo 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](cross-cluster-search.md).
## UltraWarm
As pesquisas PIT com UltraWarm índices continuam funcionando. Para obter mais informações, consulte [UltraWarm armazenamento para Amazon OpenSearch Service](ultrawarm.md).
**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](managedomains-cloudwatchmetrics.md#managedomains-cloudwatchmetrics-pit).