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 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'implementazione blu/verde, 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	Descrizione	Valore predefinito	Richiesto
keep_alive	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 _id	No
expand_wildcards	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. all: corrisponde a qualsiasi indice o flusso di dati, compresi quelli nascosti. open: abbina indici aperti e non nascosti o flussi di dati non nascosti. closed: abbina indici chiusi e non nascosti o flussi di dati non nascosti. hidden: abbina 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 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 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 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

È possibile creare PIT, cercare con ID PIT, elencare PIT ed eliminare PIT tra 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 continuano 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.