Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Ricerca puntuale in Amazon OpenSearch Service
Point in Time (PIT) è un tipo di ricerca che consente di eseguire diverse query su un set di dati fisso nel tempo. In genere, quando si esegue la stessa query sullo stesso indice in momenti diversi, si ottengono risultati diversi perché i documenti vengono costantemente indicizzati, aggiornati ed eliminati. Con PIT, è possibile eseguire query su uno stato costante del set di dati.
L'uso principale della ricerca PIT è abbinarla alla `search_after` funzionalità. Questo è il metodo di impaginazione preferito OpenSearch, specialmente per l'impaginazione profonda, perché opera su un set di dati congelato nel tempo, non è vincolato a una query e supporta un'impaginazione coerente in avanti e indietro. È possibile utilizzare PIT con un dominio che esegue la versione 2.5. OpenSearch
**Nota**
Questo argomento fornisce una panoramica di PIT e alcuni aspetti da considerare quando lo si utilizza su un dominio Amazon OpenSearch Service gestito anziché su un OpenSearch cluster autogestito. Per la documentazione completa di PIT, incluso un riferimento completo sulle API, consulta [Point in Time](https://opensearch.org/docs/latest/opensearch/point-in-time/) nella OpenSearch documentazione open source.
## Considerazioni
Considerate quanto segue quando configurate le vostre ricerche PIT:
+ Se state eseguendo l'aggiornamento da un dominio che esegue la OpenSearch versione 2.3 e avete bisogno di un controllo preciso degli accessi sulle azioni PIT, dovete aggiungere manualmente tali azioni e ruoli.
+ Non c'è resilienza per PIT. Il riavvio del nodo, la chiusura del nodo, le implementazioni blu/verdi e il riavvio del OpenSearch processo causano la perdita di tutti i dati PIT.
+ Se uno shard si riposiziona durante l' blue/green implementazione, solo i segmenti di dati in tempo reale vengono trasferiti al nuovo nodo. I segmenti di shard detenuti da PIT (sia esclusivamente che quelli condivisi con i dati in tempo reale) rimangono sul vecchio nodo.
+ Le ricerche PIT attualmente non funzionano con la ricerca asincrona.
## Crea un PIT
Per eseguire una query PIT, inviate le richieste HTTP a `_search/point_in_time` utilizzando il seguente formato:
```
POST opensearch-domain/my-index/_search/point_in_time?keep_alive=time
```
È possibile specificare le seguenti opzioni PIT:
| Opzioni | Description | Valore predefinito | Richiesto |
| --- | --- | --- | --- |
| keep\$1alive | Il periodo di tempo necessario per conservare il PIT. Ogni volta che si accede a un PIT con una richiesta di ricerca, la durata del PIT viene prolungata del periodo di tempo pari al `keep_alive` parametro. Questo parametro di interrogazione è obbligatorio quando si crea un PIT, ma facoltativo in una richiesta di ricerca. | | Sì |
| preference | Una stringa che specifica il nodo o lo shard utilizzato per eseguire la ricerca. | Casuale | No |
| routing | Una stringa che specifica di indirizzare le richieste di ricerca a uno shard specifico. | Il documento \$1id | No |
| expand\$1wildcards | Una stringa che specifica il tipo di indice che può corrispondere al modello dei caratteri jolly. Supporta valori separati da virgole. I valori validi sono i seguenti.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/opensearch-service/latest/developerguide/pit.html) | open | No |
| allow\$1partial\$1pit\$1creation | Un valore booleano che specifica se creare un PIT con errori parziali. | true | No |
**Risposta di esempio**
```
{
"pit_id": "o463QQEPbXktaW5kZXgtMDAwMDAxFnNOWU43ckt3U3IyaFVpbGE1UWEtMncAFjFyeXBsRGJmVFM2RTB6eVg1aVVqQncAAAAAAAAAAAIWcDVrM3ZIX0pRNS1XejE5YXRPRFhzUQEWc05ZTjdyS3dTcjJoVWlsYTVRYS0ydwAA",
"_shards": {
"total": 1,
"successful": 1,
"skipped": 0,
"failed": 0
},
"creation_time": 1658146050064
}
```
Quando si crea un PIT, si riceve un ID PIT nella risposta. Questo è l'ID che utilizzate per eseguire ricerche con il PIT.
## Autorizzazioni temporanee
PIT supporta un controllo [granulare](fgac.md) degli accessi. Se stai eseguendo l'aggiornamento a un dominio OpenSearch versione 2.5 e hai bisogno di un controllo degli accessi dettagliato, devi creare manualmente ruoli con le seguenti autorizzazioni:
```
# 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"
```
Per i domini con OpenSearch versione 2.5 e successive, puoi utilizzare il ruolo integrato. `point_in_time_full_access` Per ulteriori informazioni, consulta il [modello di sicurezza]( https://opensearch.org/docs/latest/search-plugins/point-in-time/#security-model) nella OpenSearch documentazione.
## Impostazioni PIT
OpenSearch consente di modificare tutte le [impostazioni PIT](https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#pit-settings) disponibili utilizzando l'`_cluster/settings`API. In OpenSearch Service, al momento non è possibile modificare le impostazioni.
## Funzionalità di ricerca tra cluster
È possibile creare PITs, cercare con PIT IDs PITs, elencare ed eliminare PITs tra cluster con le seguenti limitazioni minori:
+ È possibile elencare tutto ed eliminare tutto PITs solo nel dominio di origine.
+ Non è possibile ridurre a icona i round trip di rete come parte di una query di ricerca tra cluster.
Per ulteriori informazioni, consulta [Ricerca tra cluster in Amazon Service OpenSearch](cross-cluster-search.md).
## UltraWarm
Le ricerche PIT con UltraWarm indici continuano a funzionare. Per ulteriori informazioni, consulta [UltraWarm spazio di archiviazione per Amazon OpenSearch Service](ultrawarm.md).
**Nota**
È possibile monitorare le statistiche di ricerca PIT in. CloudWatch Per un elenco completo di parametri, consulta [Metriche puntuali](managedomains-cloudwatchmetrics.md#managedomains-cloudwatchmetrics-pit).