As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Pesquisa assíncrona no Amazon OpenSearch Service

Com a pesquisa assíncrona do Amazon OpenSearch Service, você pode enviar uma consulta de pesquisa que é executada em segundo plano, monitorar o andamento da solicitação e recuperar os resultados em um estágio posterior. Você pode recuperar resultados parciais à medida que eles se tornam disponíveis antes da conclusão da pesquisa. Após a conclusão da pesquisa, salve os resultados para recuperação e análise posteriores.

A pesquisa assíncrona requer o OpenSearch 1.0 ou posterior ou o Elasticsearch 7.10 ou posterior.

Esta documentação fornece uma breve visão geral da pesquisa assíncrona. Também discute as limitações do uso da pesquisa assíncrona com um domínio gerenciado do Amazon OpenSearch Service em vez de um cluster do OpenSearch de código aberto. Para obter a documentação completa sobre pesquisa assíncrona, incluindo configurações disponíveis, permissões e uma referência de API completa, consulte Pesquisa assíncrona na documentação do OpenSearch.

Exemplo de chamada de pesquisa

Para executar uma pesquisa assíncrona, envie solicitações HTTP ao _plugins/_asynchronous_search usando o seguinte formato:

POST opensearch-domain/_plugins/_asynchronous_search

Também é possível especificar as seguintes opções de pesquisa assíncrona:

Exemplo de solicitação

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

Permissões da pesquisa assíncrona

A pesquisa assíncrona oferece suporte ao controle de acesso refinado. Para obter detalhes sobre combinação e correspondência de permissões para se adequar ao seu caso de uso, consulte Segurança da pesquisa assíncrona.

Para domínios com controle de acesso refinado habilitado, você precisa das seguintes permissões mínimas para uma função:

# 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 domínios com controle de acesso refinado desabilitado, use o acesso do IAM e a chave secreta para assinar todas as solicitações. Você pode acessar os resultados com o ID da pesquisa assíncrona.

Configurações da pesquisa assíncrona

O OpenSearch permite alterar todas as configurações da pesquisa assíncrona via API _cluster/settings. No OpenSearch Service, só é possível alterar as seguintes configurações:

Pesquisa entre clusters

Você pode executar uma pesquisa assíncrona em clusters com as seguintes limitações secundárias:

Se você configurar uma conexão entre domain-a -> domain-b com alias de conexão cluster_b e domain-a -> domain-c com alias de conexão cluster_c, domain-a, pesquise assincronamente domain-b e domain-c da seguinte forma:

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

Resposta

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

Para ter mais informações, consulte Pesquisa entre clusters no Amazon OpenSearch Service.

UltraWarm

As pesquisas assíncronas com índices UltraWarm continuam funcionando. Para ter mais informações, consulte UltraWarm armazenamento para Amazon OpenSearch Service.