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á.

Tutorial: Criar e pesquisar documentos no Amazon OpenSearch Service

Neste tutorial, você aprenderá a criar e pesquisar um documento no Amazon OpenSearch Service. Você adiciona dados a um índice na forma de um documento JSON. O OpenSearch Service cria um índice em torno do primeiro documento que você adiciona.

Este tutorial explica como fazer solicitações HTTP para criar documentos, gerar automaticamente um ID para um documento e realizar pesquisas básicas e avançadas em seus documentos.

Pré-requisitos

Este tutorial tem os seguintes pré-requisitos:

Adicionar um documento a um índice

Criar IDs gerados automaticamente

O OpenSearch Service pode gerar automaticamente um ID para seus documentos. O comando de geração de IDs usa uma solicitação POST em vez de uma solicitação PUT e não requer nenhum ID de documento (em comparação com a solicitação anterior).

Insira a seguinte solicitação no console do desenvolvedor:

POST veggies/_doc
{
  "name":"beet",
  "color":"red",
  "classification":"root"
}

Essa solicitação cria um índice chamado veggies e adiciona o documento ao índice. Ele produz a seguinte resposta:

{
  "_index" : "veggies",
  "_type" : "_doc",
  "_id" : "3WgyS4IB5DLqbRIvLxtF",
  "_version" : 1,
  "result" : "created",
  "_shards" : {
    "total" : 2,
    "successful" : 2,
    "failed" : 0
  },
  "_seq_no" : 0,
  "_primary_term" : 1
}         

Observe o campo _id adicional na resposta, que indica que um ID foi criado automaticamente.

Atualizar um documento com um comando POST

Para atualizar um documento, use um comando HTTP POST com o número do ID.

Primeiro, crie um documento com ID 42:

POST fruits/_doc/42
{
  "name":"banana",
  "color":"yellow"
}                             

Em seguida, use esse ID para atualizar o documento:

POST fruits/_doc/42
{
  "name":"banana",
  "color":"yellow",
  "classification":"berries"
}

Esse comando atualiza o documento com o novo campo classification. Ele produz a seguinte resposta:

{
  "_index" : "fruits",
  "_type" : "_doc",
  "_id" : "42",
  "_version" : 2,
  "result" : "updated",
  "_shards" : {
    "total" : 2,
    "successful" : 2,
    "failed" : 0
  },
  "_seq_no" : 1,
  "_primary_term" : 1
}

Executar ações em massa

Você pode usar a operação da API POST _bulk para executar várias ações em um ou mais índices em uma solicitação. Os comandos de ação em massa têm o seguinte formato:

POST /_bulk
<action_meta>\n
<action_data>\n
<action_meta>\n
<action_data>\n

Cada ação requer duas linhas de JSON. Primeiro, é necessário fornecer a descrição ou os metadados da ação. Na próxima linha, você deve fornecer os dados. Cada parte é separada por uma nova linha (\n). Uma descrição de ação de uma inserção pode ser semelhante a esta:

{ "create" : { "_index" : "veggies", "_type" : "_doc", "_id" : "7" } }

E a próxima linha contendo os dados pode ter a seguinte aparência:

{ "name":"kale", "color":"green", "classification":"leafy-green" }

Juntos, os metadados e os dados representam uma única ação em uma operação em massa. Você pode realizar várias operações em uma solicitação, como esta:

POST /_bulk
{ "create" : { "_index" : "veggies", "_id" : "35" } }
{ "name":"kale", "color":"green", "classification":"leafy-green" }
{ "create" : { "_index" : "veggies", "_id" : "36" } }
{ "name":"spinach", "color":"green", "classification":"leafy-green" }
{ "create" : { "_index" : "veggies", "_id" : "37" } }
{ "name":"arugula", "color":"green", "classification":"leafy-green" }
{ "create" : { "_index" : "veggies", "_id" : "38" } }
{ "name":"endive", "color":"green", "classification":"leafy-green" }
{ "create" : { "_index" : "veggies", "_id" : "39" } }
{ "name":"lettuce", "color":"green", "classification":"leafy-green" }
{ "delete" : { "_index" : "vegetables", "_id" : "1" } }

Observe que a última ação é delete. Não há dados seguindo a ação delete.

Pesquisando documentos

Agora que os dados existem no seu cluster, você pode procurá-los. Por exemplo, talvez você queira pesquisar todos os tubérculos ou obter uma contagem de todas as folhas verdes ou encontrar o número de erros registrados por hora.

Pesquisas básicas

Uma pesquisa básica é semelhante a esta:

GET veggies/_search?q=name:l*

A solicitação produz uma resposta JSON que contém o documento lettuce.

Pesquisas avançadas

É possível realizar pesquisas mais avançadas fornecendo as opções de consulta como JSON no corpo da solicitação:

GET veggies/_search
{
  "query": {
    "term": {
      "name": "lettuce"
    }
  }
}

Este exemplo também produz uma resposta JSON com o documento lettuce.

Classificar

É possível executar mais desse tipo de consulta usando a classificação. Primeiro, é necessário recriar o índice, porque o mapeamento automático de campo escolheu tipos que não podem ser classificados por padrão. Envie as seguintes solicitações para excluir e recriar o índice:

DELETE /veggies

PUT /veggies
{
   "mappings":{
      "properties":{
         "name":{
            "type":"keyword"
         },
         "color":{
            "type":"keyword"
         },
         "classification":{
            "type":"keyword"
         }
      }
   }
}

Em seguida, preencha novamente o índice com dados:

POST /_bulk
{ "create" : { "_index" : "veggies", "_id" : "7"  } }
{ "name":"kale", "color":"green", "classification":"leafy-green" }
{ "create" : { "_index" : "veggies", "_id" : "8" } }
{ "name":"spinach", "color":"green", "classification":"leafy-green" }
{ "create" : { "_index" : "veggies", "_id" : "9" } }
{ "name":"arugula", "color":"green", "classification":"leafy-green" }
{ "create" : { "_index" : "veggies", "_id" : "10" } }
{ "name":"endive", "color":"green", "classification":"leafy-green" }
{ "create" : { "_index" : "veggies", "_id" : "11" } }
{ "name":"lettuce", "color":"green", "classification":"leafy-green" }

Agora você pode pesquisar com uma classificação. Esta solicitação adiciona uma classificação crescente:

GET veggies/_search
{
  "query" : {
    "term": { "color": "green" }
  },
  "sort" : [
      "classification"
  ]
}

Recursos relacionados

Para obter mais informações, consulte os seguintes recursos do :