什么是 @pouchbase/core?
@pouchbase/core 是一个 JavaScript 库,旨在为前端和后端应用提供与 Couchbase 数据库系统交互所需的核心功能。Couchbase 是一个分布式 NoSQL 数据库系统,它支持 JSON 文档数据模型和基于键值的键值对数据存储。
@pouchbase/core 提供了许多用于连接和交互 Couchbase 数据库的工具。使用这个库,您可以轻松地执行各种操作,例如存储和检索数据,执行查询和管理索引等。
如何使用 @pouchbase/core?
步骤 1:安装 @pouchbase/core
安装 @pouchbase/core 是非常简单的,只需在您的项目中运行以下命令:
npm install @pouchbase/core
步骤 2:连接到 Couchbase 数据库
首先,您需要连接到您的 Couchbase 数据库。使用以下代码进行连接:
const { Cluster } = require('@pouchbase/core'); const cluster = new Cluster('couchbase://localhost'); const bucket = cluster.bucket('my-bucket'); const coll = bucket.defaultCollection();
此代码将创建一个 Cluster 对象并连接到您的本地 Couchbase 单节点集群。它还选择一个名为 my-bucket 的存储桶,并使用其默认集合。如果您的存储桶和集合名称不同,请相应调整。
步骤 3:使用集合 API 进行 CRUD 操作
Couchbase 数据库使用文档和集合来组织数据。一个文档是一个 JSON 对象,而集合是文档的逻辑容器。要向集合中插入文档,请使用以下代码:
const key = 'user:John'; const value = { name: 'John', email: 'john@example.com' }; coll.upsert(key, value);
此代码将使用缺省集合插入一个键名为 'user:John' 的文档。upsert() 方法既可以进行更新也可以进行创建,因此如果文档不存在,则它将被自动创建。
对文档的检索也非常简单。使用以下代码从集合中获取文档:
const result = await coll.get(key); console.log(result.value);
这个例子选择一个名为 'user:John' 的文档并将其打印到控制台。请注意,get() 方法返回包含文档内容的对象。在这种情况下,它将打印文档的值:{ name: 'John', email: 'john@example.com' }。
更多关于集合 API 的信息,可以查看官方文档。
步骤 4:使用 N1QL 进行查询
Couchbase 还支持使用 N1QL (Couchbase 的 SQL 语言)进行查询。使用以下代码查询数据:
const query = 'SELECT name,email FROM my-bucket WHERE name = $1'; const options = { parameters: ['John'] }; cluster.query(query, options).then(result => { console.log(result.rows); });
此代码将选择 my-bucket 存储桶中名为 'John' 的所有文档,并打印与此条件匹配文档的名称和电子邮件。
结论
@pouchbase/core 是一个功能强大的 JavaScript 库,可以帮助您轻松地与 Couchbase 数据库交互。只需简单地遵循几个步骤,即可使用它的功能存储,检索和查询文档数据。实际上,@pouchbase/core 可以与任何支持 Node.js 的应用程序一起使用,无论是在前端还是后端。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005726a81e8991b448e89ed