我们很高兴地宣布 Couchbase 的 C SDK 全面可用 (GA)！此版本在我们现有的 11 种编程语言的综合 SDK 库中增加了对本机 C 语言的支持，标志着我们致力于为开发人员提供强大、高性能的工具来构建现代、可扩展的应用程序的承诺的一个重要里程碑。事实上，这个 C SDK 是我们现有的 Python、NodeJS、Ruby 和 PHP SDK 背后的核心库，并致力于在所有这些编程语言中提供一致、高性能和高效的体验。

为什么选择 C ​​SDK？

C 因其性能、效率和对系统资源的控制而仍然是许多开发人员的重要语言。通过引入 C SDK，Couchbase 使开发人员能够利用这些优势，同时充分利用 Couchbase 的高级 NoSQL 功能。以下是此版本改变游戏规则的一些关键原因：

表现

C 以其速度和低级内存管理而闻名，使其成为性能至关重要的应用程序的理想选择。 Couchbase 的 C SDK 确保您可以构建高性能应用程序，而无需牺牲速度或效率。

无缝整合

C SDK提供与Couchbase Server的无缝集成，使开发者能够轻松地进行KV操作、SQL查询、事务等操作。这种紧密集成确保您的应用程序可以有效扩展，同时保持高性能。

现代 API 设计

C SDK 具有符合最新 C 标准的现代、惯用的 API。这使得它对于 C 开发人员来说不仅功能强大而且直观，减少了学习曲线并允许您快速开始构建应用程序。

主要特征

以下是 Couchbase 的 C SDK 的一些突出功能：

轻松连接管理

C SDK 简化了连接管理，使您能够轻松建立和管理与 Couchbase 集群的连接。这包括处理连接池、负载平衡和故障转移，确保您的应用程序保持弹性和性能。这意味着 SDK 可以自动读取集群的拓扑，并在拓扑更改（例如集群大小调整或集群升级）期间提供无缝连接。下面是连接到 couchbase 数据库的 C 代码示例。

// Attempt to connect to the Couchbase cluster
auto [connect_err, cluster] = couchbase::cluster::connect(config.connection_string, options).get();

if (connect_err) {
    // Output the error message if connection fails
    std::cout 




  
  
  键值（KV）操作支持


C SDK 原生支持执行键值操作。键值操作是 couchbase 所独有的，可为 couchbase 中存储的文档提供非常快速的 CRUD 操作。下面是一个 C 代码示例，用于运行文档的简单 KV 获取和更新插入。


auto collection = cluster.bucket(config.bucket_name)
                         .scope(config.scope_name)
                         .collection(config.collection_name);

// KV- get
auto record = collection.get(document_id);
std::cout 




  
  
  丰富的查询、搜索和矢量搜索支持


C SDK支持SQL查询、全文搜索（FTS）和向量搜索，为您提供执行复杂数据操作的强大工具。无论您需要运行复杂的查询还是执行全文搜索，SDK 都能满足您的需求。 


  
  
  查询搜索


下面是执行简单 SQL 查询以从航空公司集合中获取记录的代码片段：


auto scope = cluster.bucket(config.bucket_name).scope(config.scope_name);
  auto [err, resp] = scope.query("SELECT * FROM airline LIMIT 10").get();
  std::cout 




  
  
  全文搜索 (FTS)


下面是执行 FTS 查询的代码片段，以对在地标集合上创建的索引“nicerestaurants”进行全文搜索：


auto scope = cluster.bucket(config.bucket_name).scope(config.scope_name);
auto [err, resp] = scope
  .search("travel-inventory-landmarks",
     couchbase::search_request(couchbase::query_string_query("nice restaurants")),
     couchbase::search_options{}.fields({ "content" }))
  .get();
for (const auto& row : resp.rows()) {
  auto fields = row.fields_as<:codec::tao_json_serializer>();
  std::cout 




  
  
  矢量搜索


下面是执行矢量搜索查询的代码片段：


auto scope = cluster.bucket(config.bucket_name).scope(config.scope_name);

// weights could be retrieved from your llm model or openAI
std::vector weights{ 0.1, 0.2, 0.3, 0.4 };
auto [err, resp] = scope
  .search("travel-inventory-landmarks",
    couchbase::search_request(couchbase::vector_search(
    couchbase::vector_query(field_name, weights))))
  .get();

for (const auto& row : resp.rows()) {
  auto fields = row.fields_as<:codec::tao_json_serializer>();
  std::cout 




  
  
  异步编程


该 SDK 支持异步编程模型，使您能够构建响应式、非阻塞的应用程序。这对于保持响应能力至关重要的高吞吐量应用程序特别有用。这是在异步上下文中运行事务的示例：


std::shared_ptr ctx) -> couchbase::error {
  ctx->get(
    collection,
    some_id,
    // do something in this transaction
}





  
  
  交易


这个新的 C SDK 包括对事务的支持，并通过添加更多性能改进和功能来取代我们现有的 C 事务支持。下面是创建事务上下文的示例代码片段：


std::shared_ptr<:transactions::attempt_context> ctx) -> couchbase::error {
  ctx.insert(collection, "doc-a", nlohmann::json({}));
  couchbase::transactions::transaction_get_result doc_a = ctx->get( collection, “doc-a”)
}





  
  
  强大的错误处理


错误处理在任何应用程序中都至关重要，C SDK 与我们的其他 SDK 一样，提供全面的错误处理功能，包括重试连接丢失、连接池和信息性错误消息。这确保您可以妥善处理错误并从错误中恢复，从而增强应用程序的稳定性和可靠性。


  
  
  入门


为了帮助您开始使用 Couchbase 的 C SDK，我们在我们的文档网站上准备了详细的入门指南。以下是如何开始的快速概述：




安装 SDK : 按照文档中的安装说明在您的开发环境中设置 SDK。

连接到您的集群：连接到您的 Couchbase 集群。
执行 CRUD 操作、运行查询并利用 Couchbase 的强大功能。



  
  
  社区和支持


我们相信社区和开源开发的力量。 Couchbase 的 C SDK 是开源的，我们鼓励您做出贡献、提供反馈并加入对话。如需支持，如果您是我们的企业许可客户，您可以通过支持联系，否则，您可以访问我们的综合文档、加入 Couchbase 论坛或 Couchbase Discord，或通过我们的支持门户联系。


  
  
  进一步阅读


要了解更多信息，请查看我们的文档网站。它更详细地介绍了 API，特别是围绕事务和异步操作，并提供了其他参考资料和示例绑定链接，供您深入挖掘：



Couchbase C SDK 代码示例
Couchbase C SDK 文档
下载并安装 Couchbase C SDK


支持的操作系统列在我们的文档网站上。

编码愉快！

Couchbase 团队

宣布 Couchbase 的 C SDK 全面可用的帖子首先出现在 Couchbase 博客上。