Cliente Elasticsearch para C++: elasticlient e guia completo

Cliente Elasticsearch para C++: guia completo sobre elasticlient

Elasticsearch é um poderoso sistema de busca distribuído, construído sobre o Apache Lucene. Para interagir com ele a partir do C++, existem várias bibliotecas. Neste artigo, vamos examinar detalhadamente o elasticlient — um cliente leve, moderno e conveniente que utiliza a biblioteca libcurl para requisições HTTP e nlohmann/json para trabalhar com JSON. Ele é ideal para incorporar funções de busca em aplicações nativas, componentes de servidor e ferramentas de análise de dados.

Principais recursos do elasticlient

\n
• Suporte a todas as operações principais do Elasticsearch: indexação, atualização, exclusão de documentos.
\n
• Execução de consultas de busca com texto completo, filtros e agregações.
\n
• Gerenciamento de índices: criação, exclusão, configuração de mapeamentos.
\n
• Processamento em lote (bulk) para alta performance.
\n
• Suporte a SSL/TLS e autenticação básica.
\n
• Requisições assíncronas através de mecanismos de callback.
\n

Instalação da biblioteca

Para compilar o elasticlient, será necessário um compilador com suporte a C++17 e as dependências instaladas: libcurl (desenvolvimento) e nlohmann-json. Instalação via gerenciador de pacotes (Ubuntu/Debian):

sudo apt install libcurl4-openssl-dev nlohmann-json3-dev cmake g++

Compilação a partir do código fonte:

git clone https://github.com/elastic/elasticlient.git\ncd elasticlient\nmkdir build && cd build\ncmake .. -DCMAKE_BUILD_TYPE=Release\nmake -j4\nsudo make install

Conexão básica e configuração

Para começar, crie uma instância do cliente informando a URL do seu cluster Elasticsearch:

#include <elasticlient/client.h>\n#include <iostream>\n\nint main() {\n    elasticlient::Client client({"http://localhost:9200"});\n    // Verificação de conexão\n    auto ping = client.ping();\n    if (ping.status() == 200) {\n        std::cout << "Conexão estabelecida!" << std::endl;\n    }\n    return 0;\n}

Para um cluster com vários nós, passe uma lista de URLs:

elasticlient::Client client({\n    "http://node1:9200",\n    "http://node2:9200",\n    "http://node3:9200"\n});

Trabalhando com documentos

Indexação de um novo documento (criação ou atualização):

#include <nlohmann/json.hpp>\nusing json = nlohmann::json;\n\njson doc = {\n    {"title", "Elasticsearch para C++"},\n    {"content", "Guia detalhado sobre o uso do cliente elasticlient"},\n    {"tags", {"cpp", "elasticsearch", "pesquisa"}},\n    {"views", 0}\n};\n\nauto result = client.index("articles", "article", doc.dump(), "1");\nif (result.status() == 201) {\n    std::cout << "Documento criado: " << result.body() << std::endl;\n}

Obtendo um documento pelo ID:

auto getResult = client.get("articles", "article", "1");\nif (getResult.status() == 200) {\n    json docJson = json::parse(getResult.body());\n    std::cout << "Título: " << docJson["_source"]["title"] << std::endl;\n}

Atualização de um documento existente (parcial):

json updateFields = {\n    {"doc", {{"views", 42}}}\n};\nauto updateResult = client.update("articles", "article", "1", updateFields.dump());

Pesquisa e filtragem

Executando uma pesquisa de texto completo usando Query DSL:

json searchQuery = {\n    {"query", {\n        {"bool", {\n            {"must", {\n                {{"match", {{"content", "guia"}}}}\n            }},\n            {"filter", {\n                {{"term", {{"tags", "cpp"}}}}\n            }}\n        }}\n    }},\n    {"size", 10}\n};\n\nauto searchResult = client.search("articles", searchQuery.dump());\nif (searchResult.status() == 200) {\n    json