{"id":15985,"date":"2024-07-01T08:00:48","date_gmt":"2024-07-01T15:00:48","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=15985"},"modified":"2025-06-13T21:07:20","modified_gmt":"2025-06-14T04:07:20","slug":"announcing-general-availability-of-the-cpp-sdk-for-couchbase","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/announcing-general-availability-of-the-cpp-sdk-for-couchbase\/","title":{"rendered":"Anunciando a disponibilidade geral do SDK C++ para o Couchbase"},"content":{"rendered":"

\u00c9 com grande satisfa\u00e7\u00e3o que anunciamos a disponibilidade geral (GA) do <\/span>SDK C++ <\/span><\/a>para o Couchbase! Esta vers\u00e3o adiciona suporte para a linguagem C++ nativa ao nosso conjunto abrangente existente de <\/span>Bibliotecas do SDK<\/span><\/a> em 11 linguagens de programa\u00e7\u00e3o e representa um marco significativo em nosso compromisso de fornecer ferramentas robustas e de alto desempenho para que os desenvolvedores criem aplicativos modernos e dimension\u00e1veis. De fato, esse SDK C++ \u00e9 a biblioteca principal por tr\u00e1s de nosso <\/span>Python<\/span><\/a>, <\/span>NodeJS<\/span><\/a>, <\/span>Rubi<\/span><\/a>e <\/span>PHP<\/span><\/a> SDKs e se esfor\u00e7a para oferecer uma experi\u00eancia consistente, eficiente e de alto desempenho em todas essas linguagens de programa\u00e7\u00e3o.<\/span><\/p>\n

Por que o SDK do C++?<\/span><\/h2>\n

O C++ continua sendo uma linguagem vital para muitos desenvolvedores devido ao seu desempenho, efici\u00eancia e controle sobre os recursos do sistema. Com a introdu\u00e7\u00e3o do SDK C++, o Couchbase permite que os desenvolvedores aproveitem essas vantagens e, ao mesmo tempo, tirem o m\u00e1ximo proveito dos recursos avan\u00e7ados de NoSQL do Couchbase. Veja a seguir alguns dos principais motivos pelos quais esse lan\u00e7amento \u00e9 um divisor de \u00e1guas:<\/span><\/p>\n

Desempenho<\/span><\/h3>\n

O C++ \u00e9 conhecido por sua velocidade e gerenciamento de mem\u00f3ria de baixo n\u00edvel, o que o torna ideal para aplicativos em que o desempenho \u00e9 fundamental. O SDK C++ para Couchbase garante que voc\u00ea possa criar aplicativos de alto desempenho sem sacrificar a velocidade ou a efici\u00eancia.<\/span><\/p>\n

Integra\u00e7\u00e3o perfeita<\/span><\/h3>\n

O SDK C++ oferece integra\u00e7\u00e3o perfeita com o Couchbase Server, permitindo que os desenvolvedores executem facilmente opera\u00e7\u00f5es como opera\u00e7\u00f5es KV, consultas SQL++ e transa\u00e7\u00f5es. Essa integra\u00e7\u00e3o estreita garante que seus aplicativos possam ser dimensionados com efici\u00eancia, mantendo o alto desempenho.<\/span><\/p>\n

Design moderno de API<\/span><\/h3>\n

O SDK C++ apresenta uma API moderna e idiom\u00e1tica que se alinha aos mais recentes padr\u00f5es C++. Isso o torna n\u00e3o apenas avan\u00e7ado, mas tamb\u00e9m intuitivo para os desenvolvedores de C++, reduzindo a curva de aprendizado e permitindo que voc\u00ea comece a criar aplicativos rapidamente.<\/span><\/p>\n

Principais recursos<\/span><\/h2>\n

Aqui est\u00e3o alguns dos recursos de destaque do SDK C++ para Couchbase:<\/span><\/p>\n

F\u00e1cil gerenciamento de conex\u00f5es<\/span><\/h3>\n

O SDK C++ simplifica <\/span>gerenciamento de conex\u00f5es<\/span><\/a>permitindo que voc\u00ea estabele\u00e7a e gerencie conex\u00f5es com o cluster do Couchbase com o m\u00ednimo de esfor\u00e7o. Isso inclui a manipula\u00e7\u00e3o do pooling de conex\u00f5es, o balanceamento de carga e o failover, garantindo que seu aplicativo permane\u00e7a resiliente e com bom desempenho. Isso significa que o SDK pode ler automaticamente a topologia do seu cluster e fornecer conex\u00f5es cont\u00ednuas durante altera\u00e7\u00f5es na topologia, como redimensionamento ou atualiza\u00e7\u00e3o do cluster. Abaixo est\u00e1 um exemplo de c\u00f3digo C++ para conectar-se ao seu banco de dados couchbase.<\/span><\/p>\n

\/\/ Attempt to connect to the Couchbase cluster\r\nauto [connect_err, cluster] = couchbase::cluster::connect(config.connection_string, options).get();\r\n\r\nif (connect_err) {\r\n    \/\/ Output the error message if connection fails\r\n    std::cout << \"Unable to connect to the cluster. Error code: \" << connect_err.message() << \"\\n\";\r\n} else {\r\n    auto collection = cluster.bucket(config.bucket_name)\r\n                             .scope(config.scope_name)\r\n                             .collection(config.collection_name);\r\n\r\n    \/\/ d something interesting\r\n\r\n    cluster.close().get();\r\n}\r\n<\/pre>\n
Suporte \u00e0 opera\u00e7\u00e3o de chave-valor (KV)<\/span><\/h3>\n
O SDK do C++ suporta nativamente a execu\u00e7\u00e3o de <\/span>opera\u00e7\u00f5es de valor-chave<\/span><\/a>. As opera\u00e7\u00f5es de valor-chave s\u00e3o exclusivas do couchbase e fornecem opera\u00e7\u00f5es CRUD muito r\u00e1pidas para documentos armazenados no couchbase. Abaixo est\u00e1 um exemplo de c\u00f3digo C++ para executar uma KV simples <\/span>obter<\/span> e upsert de um documento.<\/span><\/p>\n
auto collection = cluster.bucket(config.bucket_name)\r\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0.scope(config.scope_name)\r\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0.collection(config.collection_name);\r\n\r\n\/\/ KV- get\r\nauto record = collection.get(document_id);\r\nstd::cout << record.content_as() << \"\\n\";\r\n\r\n\/\/ create a new document\r\nconst std::string document_id{ \"minimal_example\" };\r\nconst tao::json::value basic_doc{\r\n\u00a0\u00a0{ \"a\", 1.0 },\r\n\u00a0\u00a0{ \"b\", 2.0 },\r\n};\r\n\r\n\/\/ KV\u00a0\r\nauto [err, resp] = collection.upsert(document_id, basic_doc, {}).get();\r\nif (err.ec()) {\r\n\u00a0\u00a0std::cout << \"ec: \" << err.message() << \", \";\r\n} else {\r\n\u00a0\u00a0std::cout << \"id: \" << document_id << \", CAS: \" << resp.cas().value() << \"\\n\";\r\n}\r\n\r\ncluster.close().get();<\/pre>\n
Suporte avan\u00e7ado a consultas, pesquisas e pesquisas vetoriais<\/span><\/h3>\n
O SDK C++ oferece suporte a <\/span>Consultas SQL++<\/span><\/a>, <\/span>pesquisa de texto completo<\/span><\/a> (FTS), e <\/span>pesquisa vetorial<\/span><\/a>O SDK \u00e9 uma ferramenta poderosa para executar opera\u00e7\u00f5es de dados complexas. N\u00e3o importa se voc\u00ea precisa executar consultas sofisticadas ou fazer pesquisas de texto completo, o SDK tem tudo o que voc\u00ea precisa.\u00a0<\/span><\/p>\n
Pesquisa de consulta<\/span><\/h4>\n
Abaixo est\u00e1 um trecho de c\u00f3digo para executar um simples <\/span>Consulta SQL++<\/span><\/a> para buscar registros da cole\u00e7\u00e3o de companhias a\u00e9reas:<\/span><\/p>\n
auto scope = cluster.bucket(config.bucket_name).scope(config.scope_name);\r\n\u00a0\u00a0auto [err, resp] = scope.query(\"SELECT * FROM airline LIMIT 10\").get();\r\n\u00a0\u00a0std::cout << \"--- Iterating as JSON objects:\\n\";\r\n\u00a0\u00a0for (auto row : resp.rows_as_json()) {\r\n\u00a0\u00a0\u00a0\u00a0std::cout << \"Airline(id: \" << row[\"airline\"][\"id\"] << \", name: \\\"\" << row[\"airline\"][\"name\"] << \"\\\")\\n\";\r\n\u00a0\u00a0}<\/pre>\n
Pesquisa de texto completo (FTS)<\/span><\/h4>\n
Abaixo est\u00e1 um trecho de c\u00f3digo para executar um <\/span>Consulta FTS<\/span><\/a> para fazer uma pesquisa de texto completo para \"bons restaurantes<\/em>\" o \u00edndice criado na cole\u00e7\u00e3o de refer\u00eancia:<\/span><\/p>\n
auto scope = cluster.bucket(config.bucket_name).scope(config.scope_name);\r\nauto [err, resp] = scope\r\n\u00a0\u00a0.search(\"travel-inventory-landmarks\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0couchbase::search_request(couchbase::query_string_query(\"nice restaurants\")),\r\n\u00a0\u00a0\u00a0\u00a0\u00a0couchbase::search_options{}.fields({ \"content\" }))\r\n\u00a0\u00a0.get();\r\nfor (const auto& row : resp.rows()) {\r\n\u00a0\u00a0auto fields = row.fields_as<couchbase::codec::tao_json_serializer>();\r\n\u00a0\u00a0std::cout << \"score: \" << row.score() << \", id: \\\"\" << row.id() << \"\\\", content: \\\"\" << fields[\"content\"].get_string() << \"\\\"\\n\";\r\n}<\/pre>\n
Pesquisa de vetores<\/span><\/h4>\n
Abaixo est\u00e1 um trecho de c\u00f3digo para executar um <\/span>pesquisa vetorial<\/span><\/a> consulta:<\/span><\/p>\n
auto scope = cluster.bucket(config.bucket_name).scope(config.scope_name);\r\n\r\n\/\/ weights could be retrieved from your llm model or openAI\r\nstd::vector<double> weights{ 0.1, 0.2, 0.3, 0.4 };\r\nauto [err, resp] = scope\r\n\u00a0\u00a0.search(\"travel-inventory-landmarks\",\r\n\u00a0\u00a0\u00a0\u00a0couchbase::search_request(couchbase::vector_search(\r\n\u00a0\u00a0\u00a0\u00a0couchbase::vector_query(field_name, weights))))\r\n\u00a0\u00a0.get();\r\n\r\nfor (const auto& row : resp.rows()) {\r\n\u00a0\u00a0auto fields = row.fields_as<couchbase::codec::tao_json_serializer>();\r\n\u00a0\u00a0std::cout << \"score: \" << row.score() << \", id: \\\"\" << row.id() << \"\\\", content: \\\"\" << fields[\"content\"].get_string() << \"\\\"\\n\";\r\n}<\/pre>\n
Programa\u00e7\u00e3o ass\u00edncrona<\/span><\/h3>\n
O SDK oferece suporte a <\/span>programa\u00e7\u00e3o ass\u00edncrona<\/span><\/a> permitindo que voc\u00ea crie aplicativos responsivos e sem bloqueio. Isso \u00e9 particularmente \u00fatil para aplicativos de alto rendimento em que a manuten\u00e7\u00e3o da capacidade de resposta \u00e9 essencial. Veja a seguir um exemplo de execu\u00e7\u00e3o de uma transa\u00e7\u00e3o em um contexto ass\u00edncrono:<\/span><\/p>\n
std::shared_ptr<async_attempt_context> ctx) -> couchbase::error {\r\n\u00a0\u00a0ctx->get(\r\n\u00a0\u00a0\u00a0\u00a0collection,\r\n\u00a0\u00a0\u00a0\u00a0some_id,\r\n\u00a0\u00a0\u00a0\u00a0\/\/ do something in this transaction\r\n}<\/pre>\n
Transa\u00e7\u00f5es<\/span><\/h3>\n
Esse novo SDK C++ inclui suporte para <\/span>transa\u00e7\u00f5es<\/span><\/a> e substitui nosso suporte a transa\u00e7\u00f5es C++ existente, acrescentando mais recursos e aprimoramentos de desempenho. Abaixo est\u00e1 um exemplo de trecho de c\u00f3digo para criar um contexto de transa\u00e7\u00e3o:<\/span><\/p>\n
std::shared_ptr<couchbase::transactions::attempt_context> ctx) -> couchbase::error {\r\n  ctx.insert(collection, \"doc-a\", nlohmann::json({}));\r\n\u00a0\u00a0couchbase::transactions::transaction_get_result doc_a = ctx->get( collection, \u201cdoc-a\u201d)\r\n}<\/pre>\n
Tratamento robusto de erros<\/span><\/h3>\n
Tratamento de erros<\/span><\/a> \u00e9 crucial em qualquer aplicativo, e o SDK do C++, assim como nossos outros SDKs, oferece recursos abrangentes de tratamento de erros, incluindo novas tentativas para quedas de conex\u00e3o, pooling de conex\u00f5es e mensagens de erro informativas. Isso garante que voc\u00ea possa manipular e se recuperar de erros de forma elegante, aumentando a estabilidade e a confiabilidade dos seus aplicativos.<\/span><\/p>\n
Primeiros passos<\/span><\/h2>\n
Para ajud\u00e1-lo a come\u00e7ar a usar o SDK C++ para Couchbase, preparamos um guia de introdu\u00e7\u00e3o detalhado em nosso site de documenta\u00e7\u00e3o. Aqui est\u00e1 uma vis\u00e3o geral r\u00e1pida de como come\u00e7ar:<\/span><\/p>\n