Momento temporale in Amazon OpenSearch Service

La funzionalità point in time (PIT) è un tipo di ricerca che consente di eseguire diverse interrogazioni 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, puoi eseguire interrogazioni in base allo stato costante del tuo set di dati.

L'uso principale della funzionalità PIT è abbinarla allasearch_after funzionalità. Questo è il metodo di impaginazione preferito OpenSearch, soprattutto per l'impaginazione profonda, perché opera su un set di dati bloccato nel tempo, non è associato a una query e supporta un'impaginazione coerente in avanti e indietro. È possibile utilizzare PIT con la versione 2.5 del OpenSearch servizio e successive.

Per ulteriori informazioni su PIT, vedere Point in Time nella OpenSearch documentazione.

Considerazioni

Quando configuri le tue ricerche PIT considera quanto segue:

• Se stai effettuando l'upgrade da un dominio 2.3 e hai bisogno di un controllo preciso degli accessi alle azioni PIT, devi 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 processo ES causano la perdita di tutti i dati PIT.

• Se uno shard si trasferisce durante la distribuzione blu/verde, solo i segmenti di dati in tempo reale vengono trasferiti sul nuovo nodo. I segmenti di shard detenuti da PIT (sia esclusivamente che quelli condivisi con dati in tempo reale) rimangono sul vecchio nodo.

• Le ricerche PIT attualmente non funzionano con la ricerca asincrona.

Crea un PIT

Per creare un PIT, inviare le richieste HTTP_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	Descrizione	Valore predefinito	Obbligatorio
keep_alive	Il periodo di conservazione del PIT. Ogni volta che si accede a un PIT con una richiesta di ricerca, la durata del PIT viene prolungata della quantità di tempo pari alkeep_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_id	No
expand_wildcards	Una stringa che specifica il tipo di indice che può corrispondere al pattern jolly. Supporta valori separati da virgola. I valori validi sono i seguenti. all: corrisponde a qualsiasi indice o flusso di dati, inclusi quelli nascosti. open: abbina indici aperti, non nascosti o flussi di dati non nascosti. closed: corrisponde a indici chiusi, non nascosti o flussi di dati non nascosti. hidden: corrisponde a indici o flussi di dati nascosti. Deve essere combinato con aperto, chiuso o sia aperto che chiuso. none: non sono accettati modelli jolly.	open	No
allow_partial_pit_creation	Un 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 crei un PIT, ricevi un PIT ID nella risposta. Questo è l'ID che usi per eseguire ricerche con il PIT.

Autorizzazioni temporali

PIT supporta il controllo granulare degli accessi. Se stai eseguendo l'aggiornamento a un dominio 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 versione 2.5 e successive, puoi utilizzare ilpoint_in_time_full_access ruolo integrato. Per ulteriori informazioni, consulta Modello di sicurezza nella OpenSearch documentazione.

Impostazioni PIT

OpenSearch consente di modificare tutte le impostazioni PIT disponibili utilizzando l'_cluster/settingsAPI. In OpenSearch Service, al momento non è possibile modificare le impostazioni.

Funzionalità di ricerca tra cluster

Puoi creare PIT, effettuare ricerche con ID PIT, elencare i PIT ed eliminare i PIT tra i cluster con le seguenti limitazioni minori:

• È possibile elencare tutti ed eliminare tutti i PIT 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 .

UltraWarm

Le ricerche PIT con UltraWarm indici continueranno a funzionare. Per ulteriori informazioni, consulta UltraWarm spazio di archiviazione per Amazon OpenSearch Service.

Nota

È possibile monitorare le statistiche di ricerca PIT in CloudWatch. Per un elenco completo di parametri, consulta Metriche puntuali.