Búsqueda asíncrona en Amazon OpenSearch Service

Con la búsqueda asíncrona de Amazon OpenSearch Service, puede enviar una consulta de búsqueda que se ejecute en segundo plano, monitorear el progreso de la solicitud y recuperar los resultados en una etapa posterior. Puede recuperar resultados parciales, a medida que estén disponibles, antes de que se complete la búsqueda. Una vez finalizada la búsqueda, guarde los resultados para una posterior recuperación y análisis.

La búsqueda asíncrona requiere OpenSearch 1.0 o posterior o Elasticsearch 7.10 o posterior.

Esta documentación proporciona una breve información general de la búsqueda asíncrona. También se analizan las limitaciones del uso de la búsqueda asíncrona con un dominio administrado de Amazon OpenSearch Service en lugar de con un clúster de OpenSearch de código abierto. Para obtener la documentación completa de la búsqueda asíncrona, que incluye la configuración disponible, los permisos y una referencia completa de la API, consulte Asynchronous search en la documentación de OpenSearch.

Ejemplo de llamada de búsqueda

Para realizar una búsqueda asíncrona, envíe solicitudes HTTP a _plugins/_asynchronous_search con el siguiente formato:

POST opensearch-domain/_plugins/_asynchronous_search

Puede especificar las siguientes opciones de búsqueda asíncrona:

Solicitud de ejemplo

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
      }
    }
  }
}

Permisos de búsqueda asíncrona

La búsqueda asíncrona admite el control de acceso detallado. Para obtener más información sobre la combinación y la coincidencia de permisos para adaptarlos al caso de uso, consulte Asynchronous search security.

Para los dominios con control de acceso detallado habilitado, necesita los siguientes permisos mínimos para un rol:

# 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'

Para dominios con control de acceso detallado deshabilitado, utilice el acceso de IAM y la clave secreta para firmar todas las solicitudes. Puede acceder a los resultados con el ID de búsqueda asíncrona.

Configuración de búsqueda asincrónica

OpenSearch permite cambiar todas las configuraciones de búsqueda asincrónica mediante la API de _cluster/settings. En OpenSearch Service, solo puede cambiar la configuración siguiente:

Búsqueda en clústeres

Puede realizar una búsqueda asíncrona entre clústeres con las siguientes limitaciones menores:

Si configura una conexión entre domain-a -> domain-b, con alias de conexión cluster_b, y domain-a -> domain-c, con alias de conexión cluster_c, realice una búsqueda asíncrona de domain-a, domain-b y domain-c, de la siguiente manera:

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": []
    }
  }
}

Respuesta

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

Para obtener más información, consulte Búsqueda en clústeres de Amazon OpenSearch Service.

UltraWarm

Las búsquedas asíncronas con índices de UltraWarm siguen en funcionamiento. Para obtener más información, consulte Almacenamiento UltraWarm para Amazon OpenSearch Service.