{"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\/announcing-general-availability-of-the-cpp-sdk-for-couchbase\/","title":{"rendered":"Announcing General Availability of the C++ SDK for Couchbase"},"content":{"rendered":"

We are thrilled to announce the General Availability (GA) of the <\/span>C++ SDK <\/span><\/a>for Couchbase! This release adds support for native C++ language to our existing comprehensive set of <\/span>SDK libraries<\/span><\/a> in 11 programming languages and marks a significant milestone in our commitment to providing robust, high-performance tools for developers to build modern, scalable applications. In fact, this C++ SDK is the core library behind our existing <\/span>Python<\/span><\/a>, <\/span>NodeJS<\/span><\/a>, <\/span>Ruby<\/span><\/a>, and <\/span>PHP<\/span><\/a> SDKs and strives to provide a consistent, performant and efficient experience across all these programming languages.<\/span><\/p>\n

Why C++ SDK?<\/span><\/h2>\n

C++ remains a vital language for many developers due to its performance, efficiency, and control over system resources. By introducing the C++ SDK, Couchbase empowers developers to leverage these advantages while taking full benefit of Couchbase’s advanced NoSQL capabilities. Here are some key reasons why this release is a game-changer:<\/span><\/p>\n

Performance<\/span><\/h3>\n

C++ is renowned for its speed and low-level memory management, making it ideal for applications where performance is critical. The C++ SDK for Couchbase ensures that you can build high-performance applications without sacrificing speed or efficiency.<\/span><\/p>\n

Seamless Integration<\/span><\/h3>\n

The C++ SDK provides seamless integration with Couchbase Server, enabling developers to easily perform operations such as KV operations, SQL++ queries, and transactions. This tight integration ensures that your applications can scale effectively while maintaining high performance.<\/span><\/p>\n

Modern API Design<\/span><\/h3>\n

The C++ SDK features a modern, idiomatic API that aligns with the latest C++ standards. This makes it not only powerful but also intuitive for C++ developers, reducing the learning curve and allowing you to start building applications quickly.<\/span><\/p>\n

Key Features<\/span><\/h2>\n

Here are some of the standout features of the C++ SDK for Couchbase:<\/span><\/p>\n

Easy Connection Management<\/span><\/h3>\n

The C++ SDK simplifies <\/span>connection management<\/span><\/a>, allowing you to establish and manage connections to your Couchbase cluster with minimal effort. This includes handling connection pooling, load balancing, and failover, ensuring your application remains resilient and performant. This means that the SDK can automatically read the topology of your cluster and provide seamless connections during topology changes such as cluster resizes or cluster upgrades. Below is an example of C++ code to connect to your couchbase database.<\/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
Key-Value (KV) Operation Support<\/span><\/h3>\n
The C++ SDK natively supports performing <\/span>key value operations<\/span><\/a>. Key-value operations are unique to couchbase and provide very fast CRUD operations for documents stored in couchbase. Below is an example of C++ code to run a simple KV <\/span>get<\/span> & upsert of a document.<\/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
Rich Query, Search and Vector Search Support<\/span><\/h3>\n
The C++ SDK supports <\/span>SQL++ queries<\/span><\/a>, <\/span>full-text search<\/span><\/a> (FTS), and <\/span>vector search<\/span><\/a>, providing you with powerful tools to perform complex data operations. Whether you need to run sophisticated queries or perform full-text searches, the SDK has you covered.\u00a0<\/span><\/p>\n
Query Search<\/span><\/h4>\n
Below is a code snippet to execute a simple <\/span>SQL++ query<\/span><\/a> to fetch records from airlines collection:<\/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
Full Text Search (FTS)<\/span><\/h4>\n
Below is a code snippet to execute a <\/span>FTS query<\/span><\/a> to do a full text search for \u201cnice restaurants<\/em>\u201d the index created on the landmark collection:<\/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
Vector Search<\/span><\/h4>\n
Below is a code snippet to execute a <\/span>vector search<\/span><\/a> query:<\/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
Asynchronous Programming<\/span><\/h3>\n
The SDK supports <\/span>asynchronous programming<\/span><\/a> models, enabling you to build responsive, non-blocking applications. This is particularly useful for high-throughput applications where maintaining responsiveness is essential. Here\u2019s an example of running a transaction in a asynchronous context:<\/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
Transactions<\/span><\/h3>\n
This new C++ SDK includes support for <\/span>transactions<\/span><\/a> and replaces our existing C++ transaction support by adding more performance improvements and features. Below is a sample code snippet for create a transaction context:<\/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
Robust Error Handling<\/span><\/h3>\n
Error handling<\/span><\/a> is crucial in any application, and the C++ SDK, just like our other SDKs, provides comprehensive error handling capabilities including retry for connection drops, connection pooling and informative error messages. This ensures that you can gracefully handle and recover from errors, enhancing the stability and reliability of your applications.<\/span><\/p>\n
Getting Started<\/span><\/h2>\n
To help you get started with the C++ SDK for Couchbase, we’ve prepared a detailed getting started guide on our documentation website. Here\u2019s a quick overview of how to begin:<\/span><\/p>\n