宣布 Couchbase 的 C++ SDK 全面上市-C++-PHP中文网

Announcing General Availability of the C++ SDK for Couchbase

我们很高兴地宣布 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 << "Unable to connect to the cluster. Error code: " << connect_err.message() << "\n";
} else {
    auto collection = cluster.bucket(config.bucket_name)
                             .scope(config.scope_name)
                             .collection(config.collection_name);

    // d something interesting

    cluster.close().get();
}

登录后复制

键值（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 << record.content_as() << "\n";

// create a new document
const std::string document_id{ "minimal_example" };
const tao::json::value basic_doc{
  { "a", 1.0 },
  { "b", 2.0 },
};

// KV 
auto [err, resp] = collection.upsert(document_id, basic_doc, {}).get();
if (err.ec()) {
  std::cout << "ec: " << err.message() << ", ";
} else {
  std::cout << "id: " << document_id << ", CAS: " << resp.cas().value() << "\n";
}

cluster.close().get();

登录后复制

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

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 << "--- Iterating as JSON objects:\n";
  for (auto row : resp.rows_as_json()) {
    std::cout << "Airline(id: " << row["airline"]["id"] << ", name: \"" << row["airline"]["name"] << "\")\n";
  }

登录后复制

全文搜索 (FTS)

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

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<couchbase::codec::tao_json_serializer>();
  std::cout << "score: " << row.score() << ", id: \"" << row.id() << "\", content: \"" << fields["content"].get_string() << "\"\n";
}

登录后复制

矢量搜索

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

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

// weights could be retrieved from your llm model or openAI
std::vector<double> 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<couchbase::codec::tao_json_serializer>();
  std::cout << "score: " << row.score() << ", id: \"" << row.id() << "\", content: \"" << fields["content"].get_string() << "\"\n";
}

登录后复制

异步编程

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

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

登录后复制

交易

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

std::shared_ptr<couchbase::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，或通过我们的支持门户联系。