{"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\/es\/announcing-general-availability-of-the-cpp-sdk-for-couchbase\/","title":{"rendered":"Disponibilidad general del SDK de C++ para Couchbase"},"content":{"rendered":"

Estamos encantados de anunciar la Disponibilidad General (AG) del <\/span>SDK PARA C <\/span><\/a>\u00a1para Couchbase! Esta versi\u00f3n a\u00f1ade soporte para el lenguaje nativo C++ a nuestro completo conjunto de <\/span>Bibliotecas SDK<\/span><\/a> en 11 lenguajes de programaci\u00f3n y marca un hito importante en nuestro compromiso de ofrecer herramientas s\u00f3lidas y de alto rendimiento para que los desarrolladores creen aplicaciones modernas y escalables. De hecho, este kit de desarrollo de software para C++ es la biblioteca central de nuestro actual kit de desarrollo de software para C++. <\/span>Python<\/span><\/a>, <\/span>NodeJS<\/span><\/a>, <\/span>Ruby<\/span><\/a>y <\/span>PHP<\/span><\/a> SDK y se esfuerza por ofrecer una experiencia coherente, eficaz y eficiente en todos estos lenguajes de programaci\u00f3n.<\/span><\/p>\n

\u00bfPor qu\u00e9 C++ SDK?<\/span><\/h2>\n

C++ sigue siendo un lenguaje vital para muchos desarrolladores debido a su rendimiento, eficiencia y control sobre los recursos del sistema. Con la introducci\u00f3n del SDK de C++, Couchbase permite a los desarrolladores aprovechar estas ventajas y sacar el m\u00e1ximo partido de las avanzadas capacidades NoSQL de Couchbase. Estas son algunas de las razones por las que esta versi\u00f3n cambia las reglas del juego:<\/span><\/p>\n

Rendimiento<\/span><\/h3>\n

C++ es conocido por su velocidad y su gesti\u00f3n de memoria de bajo nivel, lo que lo hace ideal para aplicaciones donde el rendimiento es cr\u00edtico. El SDK de C++ para Couchbase garantiza que puedas crear aplicaciones de alto rendimiento sin sacrificar la velocidad ni la eficiencia.<\/span><\/p>\n

Integraci\u00f3n perfecta<\/span><\/h3>\n

El SDK de C++ proporciona una integraci\u00f3n perfecta con Couchbase Server, permitiendo a los desarrolladores realizar f\u00e1cilmente operaciones como operaciones KV, consultas SQL++ y transacciones. Esta estrecha integraci\u00f3n garantiza que tus aplicaciones puedan escalar eficazmente manteniendo un alto rendimiento.<\/span><\/p>\n

Dise\u00f1o moderno de API<\/span><\/h3>\n

El SDK de C++ presenta una API moderna e idiom\u00e1tica que se ajusta a los \u00faltimos est\u00e1ndares de C++. Esto hace que no solo sea potente, sino tambi\u00e9n intuitivo para los desarrolladores de C++, lo que reduce la curva de aprendizaje y permite empezar a crear aplicaciones r\u00e1pidamente.<\/span><\/p>\n

Caracter\u00edsticas principales<\/span><\/h2>\n

Estas son algunas de las caracter\u00edsticas m\u00e1s destacadas del SDK de C++ para Couchbase:<\/span><\/p>\n

Gesti\u00f3n sencilla de las conexiones<\/span><\/h3>\n

El SDK de C++ simplifica <\/span>gesti\u00f3n de conexiones<\/span><\/a>te permite establecer y gestionar conexiones a tu cl\u00faster de Couchbase con el m\u00ednimo esfuerzo. Esto incluye el manejo de la agrupaci\u00f3n de conexiones, el equilibrio de carga y la conmutaci\u00f3n por error, lo que garantiza que tu aplicaci\u00f3n siga siendo resistente y tenga un buen rendimiento. Esto significa que el SDK puede leer autom\u00e1ticamente la topolog\u00eda de su cl\u00faster y proporcionar conexiones sin problemas durante los cambios de topolog\u00eda, tales como cambios de tama\u00f1o de cl\u00faster o actualizaciones de cl\u00faster. A continuaci\u00f3n se muestra un ejemplo de c\u00f3digo C++ para conectarse a su base de datos 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
Soporte de operaciones clave-valor (KV)<\/span><\/h3>\n
El SDK de C++ soporta de forma nativa la realizaci\u00f3n de <\/span>operaciones clave-valor<\/span><\/a>. Las operaciones clave-valor son exclusivas de couchbase y proporcionan operaciones CRUD muy r\u00e1pidas para documentos almacenados en couchbase. A continuaci\u00f3n se muestra un ejemplo de c\u00f3digo C++ para ejecutar una simple KV <\/span>consiga<\/span> & upsert de un 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
Soporte enriquecido para consultas, b\u00fasquedas y b\u00fasquedas vectoriales<\/span><\/h3>\n
El SDK de C++ admite <\/span>Consultas SQL<\/span><\/a>, <\/span>b\u00fasqueda de texto completo<\/span><\/a> (FTS), y <\/span>b\u00fasqueda vectorial<\/span><\/a>le proporciona potentes herramientas para realizar operaciones de datos complejas. Tanto si necesita ejecutar consultas sofisticadas como realizar b\u00fasquedas de texto completo, el SDK tiene todo lo que necesita.\u00a0<\/span><\/p>\n
B\u00fasqueda de consultas<\/span><\/h4>\n
A continuaci\u00f3n se muestra un fragmento de c\u00f3digo para ejecutar un simple <\/span>Consulta SQL<\/span><\/a> para obtener registros de la colecci\u00f3n de aerol\u00edneas:<\/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
B\u00fasqueda de texto completo (FTS)<\/span><\/h4>\n
A continuaci\u00f3n se muestra un fragmento de c\u00f3digo para ejecutar un <\/span>Consulta FTS<\/span><\/a> para realizar una b\u00fasqueda de texto completo de \"buenos restaurantes<\/em>\" el \u00edndice creado en la colecci\u00f3n de puntos de referencia:<\/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
B\u00fasqueda vectorial<\/span><\/h4>\n
A continuaci\u00f3n se muestra un fragmento de c\u00f3digo para ejecutar un <\/span>b\u00fasqueda vectorial<\/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
Programaci\u00f3n as\u00edncrona<\/span><\/h3>\n
El SDK admite <\/span>programaci\u00f3n as\u00edncrona<\/span><\/a> lo que permite crear aplicaciones con capacidad de respuesta y sin bloqueos. Esto es especialmente \u00fatil para aplicaciones de alto rendimiento en las que es esencial mantener la capacidad de respuesta. He aqu\u00ed un ejemplo de ejecuci\u00f3n de una transacci\u00f3n en un contexto as\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
Transacciones<\/span><\/h3>\n
Este nuevo SDK de C++ incluye compatibilidad con <\/span>transacciones<\/span><\/a> y reemplaza nuestro soporte de transacciones C++ existente a\u00f1adiendo m\u00e1s mejoras de rendimiento y caracter\u00edsticas. A continuaci\u00f3n se muestra un fragmento de c\u00f3digo de ejemplo para crear un contexto de transacci\u00f3n:<\/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
Gesti\u00f3n de errores robusta<\/span><\/h3>\n
Tratamiento de errores<\/span><\/a> es crucial en cualquier aplicaci\u00f3n, y el SDK de C++, al igual que nuestros otros SDK, proporciona funciones completas de gesti\u00f3n de errores, como reintentos en caso de ca\u00edda de la conexi\u00f3n, agrupaci\u00f3n de conexiones y mensajes de error informativos. De este modo, podr\u00e1 gestionar los errores con elegancia y recuperarse de ellos, mejorando la estabilidad y fiabilidad de sus aplicaciones.<\/span><\/p>\n
Primeros pasos<\/span><\/h2>\n
Para ayudarte a empezar con el SDK de C++ para Couchbase, hemos preparado una detallada gu\u00eda de inicio en nuestro sitio web de documentaci\u00f3n. Aqu\u00ed tienes un resumen r\u00e1pido de c\u00f3mo empezar:<\/span><\/p>\n