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 asincrona in Amazon Service OpenSearch

Con la ricerca asincrona per Amazon OpenSearch Service puoi inviare una query di ricerca che viene eseguita in background, monitorare l'avanzamento della richiesta e recuperare i risultati in una fase successiva. È possibile recuperare i risultati parziali man mano che diventano disponibili prima del completamento della ricerca. Al termine della ricerca, salvare i risultati per il recupero e l'analisi successivi.

La ricerca asincrona richiede OpenSearch 1.0 o versione successiva oppure Elasticsearch 7.10 o versione successiva.

Questa documentazione fornisce una breve panoramica della ricerca asincrona. Descrive inoltre i limiti dell'uso della ricerca asincrona con un dominio Amazon OpenSearch Service gestito anziché con un cluster open source. OpenSearch Per la documentazione completa sulla ricerca asincrona, comprese le impostazioni disponibili, le autorizzazioni e un riferimento completo all'API, consulta Ricerca asincrona nella documentazione. OpenSearch

Chiamata di ricerca di esempio

Per eseguire una ricerca asincrona, inviare le richieste HTTP a _plugins/_asynchronous_search utilizzando il seguente formato:

POST opensearch-domain/_plugins/_asynchronous_search

È possibile specificare le seguenti opzioni di ricerca asincrona:

Richiesta di esempio

POST _plugins/_asynchronous_search/?pretty&size=10&wait_for_completion_timeout=1ms&keep_on_completion=true&request_cache=false
{
  "aggs": {
    "city": {
      "terms": {
        "field": "city",
        "size": 10
      }
    }
  }
}

Autorizzazioni di ricerca asincrona

La ricerca asincrona supporta il controllo granulare degli accessi. Per informazioni dettagliate sull'uso delle autorizzazioni per adattarle al proprio caso d'uso, consultare Sicurezza asincrona della ricerca.

Per i domini con il controllo granulare degli accessi abilitato, sono necessarie le seguenti autorizzazioni minime per un ruolo:

# Allows users to use all asynchronous search functionality
asynchronous_search_full_access:
  reserved: true
  cluster_permissions:
    - 'cluster:admin/opensearch/asynchronous-search/*'
  index_permissions:
    - index_patterns:
        - '*'
      allowed_actions:
        - 'indices:data/read/search*'

# Allows users to read stored asynchronous search results
asynchronous_search_read_access:
  reserved: true
  cluster_permissions:
    - 'cluster:admin/opensearch/asynchronous-search/get'

Per i domini con il controllo granulare degli accessi disabilitato, utilizzare l'accesso IAM e la chiave segreta per firmare tutte le richieste. È possibile accedere ai risultati con l'ID di ricerca asincrona.

Impostazioni della ricerca asincrona

OpenSearch consente di modificare tutte le impostazioni di ricerca asincrona disponibili utilizzando l'API. _cluster/settings In OpenSearch Service, puoi modificare solo le seguenti impostazioni:

Funzionalità di ricerca tra cluster

È possibile eseguire una ricerca asincrona tra cluster con le seguenti limitazioni minori:

Se si imposta una connessione tra domain-a -> domain-b con l'alias di connessione cluster_b e domain-a -> domain-c con l'alias di connessione cluster_c, ricercare in maniera asincrona domain-a, domain-b e domain-c come segue:

POST https://src-domain.us-east-1.es.amazonaws.com/local_index,cluster_b:b_index,cluster_c:c_index/_plugins/_asynchronous_search/?pretty&size=10&wait_for_completion_timeout=500ms&keep_on_completion=true&request_cache=false 
{
  "size": 0,
  "_source": {
    "excludes": []
  },
  "aggs": {
    "2": {
      "terms": {
        "field": "clientip",
        "size": 50,
        "order": {
          "_count": "desc"
        }
      }
    }
  },
  "stored_fields": [
    "*"
  ],
  "script_fields": {},
  "docvalue_fields": [
    "@timestamp"
  ],
  "query": {
    "bool": {
      "must": [
        {
          "query_string": {
            "query": "status:404",
            "analyze_wildcard": true,
            "default_field": "*"
          }
        },
        {
          "range": {
            "@timestamp": {
              "gte": 1483747200000,
              "lte": 1488326400000,
              "format": "epoch_millis"
            }
          }
        }
      ],
      "filter": [],
      "should": [],
      "must_not": []
    }
  }
}

Risposta

{
  "id" : "Fm9pYzJyVG91U19xb0hIQUJnMHJfRFEAAAAAAAknghQ1OWVBczNZQjVEa2dMYTBXaTdEagAAAAAAAAAB",
  "state" : "RUNNING",
  "start_time_in_millis" : 1609329314796,
  "expiration_time_in_millis" : 1609761314796
}

Per ulteriori informazioni, consulta Ricerca tra cluster in Amazon Service OpenSearch .

UltraWarm

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