数据库教程-CouchDB快速入门

跨零代码为大家提供高品质的解决方案,请大家多多来访,跨零不胜感激,在此谢过。

Apache CouchDB数据库,它类似于Redis,Cassandra和MongoDB,也是一个NoSQL数据库。 CouchDB将数据存储为非关系性的JSON文档。 这使得CouchDB的用户可以以与现实世界相似的方式来存储数据。

可以从命令行或一个叫作Futon的Web界面来管理CouchDB。 Futon可用于执行管理任务,如创建和操作CouchDB的数据库,文档和用户等。

本文章的目标

在阅读学习本文完后,您将学会以下知识:

  • 将CouchDB安装在运行Ubuntu 14.04上。
  • 将Futon安装在同一台服务器上
  • 使用安全通道从本地机器访问CouchDB
  • 向CouchDB添加管理员用户
  • 如何使用Futon执行CouchDB的CRUD操作
  • 从命令行执行CouchDB的CRUD操作

先决条件

请准备/完成以下两个先决条件:

  • Ubuntu 14.04系统
  • 拥有管理权限的用户身份登录到服务器

步骤1 – 准备服务器

在安装CouchDB之前,需要确保已经设置好了服务器。

开始更新系统:

$ sudo apt-get update

安装允许管理源存储库的软件:

$ sudo apt-get install software-properties-common -y

添加PPA,以从相应的存储库获取最新的CouchDB版本:

$ sudo add-apt-repository ppa:couchdb/stable -y

经过上一步,已经添加了一个新的PPA,接下来需要更新系统,使其具有最新的包信息:

$ sudo apt-get update

现在可以安装CouchDB和Futon了。

步骤2 – 安装CouchDB

如果之前有在此服务器上安装过CouchDB,请先删除现有版本,使用以下命令:

$ sudo apt-get remove couchdb couchdb-bin couchdb-common -yf

现在安装CouchDB:

$ sudo apt-get install couchdb -y

这将在您服务器上安装CouchDB和Futon。

默认情况下,CouchDB在localhost上并使用端口5984运行,可以通过从命令行运行curl来检索此基本信息:

$ curl localhost:5984

执行上面命令请求,应该得到类似于以下内容:

{"couchdb":"Welcome","uuid":"b9dsf278cfdas743b5fdfsaafd399fas7582e","version":"1.6.1","vendor":{"name":"Ubuntu","version":"14.04"}}

现在可以使用curl -X PUT命令创建一个新的数据库:

curl -X PUT localhost:5984/new_database

执行后返回的响应结果如下 –

{"ok":true}

步骤3 – CouchDB安全保护

默认情况下,安装CouchDB时创建的某些文件和目录属于root用户和组。 这在开发过程中虽然不错,但这可能是生产中的安全风险。

安装CouchDB时,它将创建一个用户和一个名为couchdb的组。 在本节中,我们将把CouchDB文件的所有权和权限更改为couchdb用户和组。

更改所有权控制CouchDB进程可以访问内容,并更改可以访问CouchDB文件和目录的权限控制。

更改所有权和权限之前,先停止CouchDB:

$ sudo stop couchdb

更改/usr/lib/couchdb,/usr/share/couchdb和/etc/couchdb目录, 以及/usr/bin/couchdb可执行文件的所有权,使其所有者为couchdb用户,并且属于couchdb组。

sudo chown -R couchdb:couchdb /usr/lib/couchdb /usr/share/couchdb /etc/couchdb /usr/bin/couchdb

现在,更改了/usr/lib/couchdb,/usr/share/couchdb和/etc/couchdb目录, 以及/usr/bin/couchdb可执行文件的权限,以便couchdb用户和couchdb组可自由访问(到CouchDB安装),而其他用户不可以访问这些文件和目录。

sudo chmod -R 0770 /usr/lib/couchdb /usr/share/couchdb /etc/couchdb /usr/bin/couchdb

现在重新启动CouchDB:

sudo start couchdb

CouchDB现在应该启动并运行,而没有任何属于root用户或root组的文件或目录。

步骤4 – 访问Futon

CouchDB提供了一个基于Web的方便控制面板,它叫作:Futon。从本地服务器访问它,将流量通过SSH连接隧道传输到您的服务器。只有SSH登录到您的服务器的用户才能访问Futon控制面板。

要安全地连接到CouchDB(不用公开),您可以创建从本地端口5984到远程服务器端口5984的SSH隧道。

可以使用以下命令在本地计算机运行,以设置隧道:

$ ssh -L5984:127.0.0.1:5984 yiibai_user@your_server_ip

连接打开时,使用端口5984从Web浏览器访问Futon。访问此URL以显示Futon页面:

http://localhost:5984/_utils

CouchDB快速入门

默认情况下,访问Futon的所有CouchDB用户都具有管理权限。如在右下角所示:

CouchDB快速入门

可以通过点击修复此(Fix this)链接并创建新管理员来更改此内容。

步骤5 – 添加管理员用户

现在已经启动运行CouchDB,可以开始使用它了。

在创建管理员用户之前,所有用户都可以以管理权限访问CouchDB(尽管它们首先需要SSH访问服务器)。

为CouchDB创建管理员帐户是一个很好的做法,以防止意外或未经授权的数据丢失。

要执行此操作,请单击显示在“Futon”的右下角的“修复此(Fix this)”链接。 这将显示一个允许您创建CouchDB管理员用户的屏幕,如下所示:

CouchDB快速入门

输入用户名和密码:

CouchDB快速入门

输入新的CouchDB用户名和密码后,单击创建(Create)按钮然后就创建新的管理员用户。 Futon右下角的消息将通过显示类似于以下内容的消息来确认:

CouchDB快速入门

就这样,有关CouchDB服务器现已完全配置。要了解有关使用数据库的更多信息,请继续阅读。

下面是一条美丽的分割线…


上面是一条美丽的分割线…

从Futon执行CRUD操作

Futon有一个非常简单但有用的用户界面,用来执行基本的CRUD操作(创建,读取,更新和删除)。

在本节中,我们将创建一个名为todos的新数据库,向其中添加一个新文档,然后检索,更新和删除此文档。

创建数据库和文档

CouchDB快速入门

要创建一个名为todos的新数据库,请单击屏幕的左上方的创建数据库(Create Database)链接。 这将出现类似如下对话框:

CouchDB快速入门

输入数据库的名称:todos,然后单击创建按钮。

这将创建一个名为todos的新数据库,并转到可以在新创建的数据库中创建和修改文档的页面。

CouchDB快速入门

创建文档

要创建新文档,请单击页面上的“新建文档(New Document)”链接。

这将打开一个带有新文档的屏幕。 这个文档默认只有_id字段。 如果需要,您可以更改此字段的值,也可以按原样保留。

CouchDB快速入门

单击添加字段(Add Field)链接以向此文档添加新字段。

如上所述,我们添加了两个名为todo和done的字段。 默认情况下,新字段具有空(null)值。可通过双击该值以更改它。

在这个例子中,我们双击了todo和done的值字段,并分别输入了Task 1和false。

输入值后,按ENTER键或点击字段旁边的小绿色复选标记来保存内容(不这样做会使该字段的值为空)。这应该如下所示:

CouchDB快速入门

要保存文档,请单击“保存文档(Save Document)”链接。 保存文档后,您将看到已经添加了_rev字段,如下所示:

CouchDB快速入门

读取文件

单击todos链接(在“概览(Overview)”链接旁边的顶部栏中)查看新创建的文档,现在它是todos数据库中的唯一文档。

CouchDB快速入门

单击表格中的文档(ID)的键(红色部分),以访问文档详细信息页面。

编辑文档

在此页面上,可以编辑和更新文档字段,如下:

CouchDB快速入门

要编辑字段值,可双击对应字段并开始编辑。

您可以删除任何字段(除了_id和_rev字段外),添加新字段,或更改现有字段的值。 在这个例子中,已经将done字段的值从false更改为true,如下所示:

CouchDB快速入门

删除文档

要删除文档,可以单击删除文档链接,该链接将提示您进行确认:

CouchDB快速入门

删除(Delete)按钮进行确认。

Futon将删除文档并跳转到todos数据库页面,该页面中文档现在应为空,确认文档确实已被删除。

CouchDB快速入门

从命令行执行CRUD操作

本节将说明如何使用curl从命令行在CouchDB数据库上执行基本的CRUD(创建,读取,更新和删除)操作。

创建数据库

如果您尚未创建数据库new_database,请按照以下步骤现在来创建。 该命令应从安装CouchDB数据库的服务器上执行:

curl -X PUT http://localhost:5984/new_database -u "admin:password" {"ok":true}

由于之前我们向CouchDB添加了管理员用户,因此现在必须在创建新的数据库时发送管理员用户名和密码。
结果应如下所示:

{"ok":true}

创建文档

我们先来创建一个新的文档,使用以下请求命令:

curl -X POST -d '{"todo":"task 1", "done":false}' http://localhost:5984/new_database -H "Content-Type:application/json"

此命令将在new_database数据库中创建一个新文档。

-X标志表示执行HTTP POST方法请求操作。 由于POST方法请求发送一个JSON文档,所以后面的-H标志将此请求的内容类型设置为application/json。 最后,包含了JSON文档本身,使用-d标志。

此操作的响应结果如下:

{"ok":true,"id":"803da996e1524591ce773d24400004ff","rev":"1-2fc1d70532433c39c9f61480607e3681"}

此响应的部分”ok”:true表示操作成功。 响应包括分别代表文档ID和文档修订的字段id和rev。 需要修改或删除此文档时,才需要这两个字段。

在此示例中,文档ID由CouchDB生成,因为没有提供该命令。 如果需要,可以创建一个具有生成唯一ID的文档。

用指定的ID创建

创建一个ID为random_task的文档:

curl -X POST -d '{"_id":"random_task", "todo":"task 2", "done":false}' http://localhost:5984/new_database -H "Content-Type:application/json"

此命令创建一个ID为random_task的新文档,对此命令的响应如下:

{"ok":true,"id":"random_task","rev":"1-bceeae3c4a9154c87db1649473316e44"}

创建多个文档

除了创建单个文档,还可以批量创建文档。

curl -X POST -d '{"docs": [{"todo":"task 3", "done":false}, {"todo":"task 4", "done":false}]}' http://localhost:5984/new_database/_bulk_docs -H "Content-Type:application/json"

该命令将在POST正文中指定创建两个文档。 与单个文档插入相比,有两个微小的差异:

  1. 在插入单个文档时,POST正文只是一个标准的JSON对象。 在批量插入的情况下,POST正文包含具有文档字段的对象。 该字段保存要插入的文档数组。

  2. 在插入单个文档时,POST请求已发送到指向数据库的URL(http://localhost:5984/new_database)。 但是,对批量插入请求,URL为:URL:http://localhost:5984/new_database/_bulk_docs。

批量插入操作的响应如下:

[{"ok":true,"id":"803da996e1524591ce773d24400007df","rev":"1-778fd61f8f460d0c1df1bb174279489d"},{"ok":true,"id":"803da996e1524591ce773d2440001723","rev":"1-dc9e84861bba58e5cfefeed8f5133636"}]

读取文件

可通过发出HTTP GET命令来从CouchDB数据库检索文档。现在尝试检索上面创建的一个文档:一个叫random_task的文件。

curl -X GET http://localhost:5984/new_database/random_task

请注意,URL包括正在检索的文档的ID(random_task)。如下所示,对此GET请求的响应包含整个文档以及_id和_rev字段,可用于更新或删除此文档。

{"_id":"random_task","_rev":"1-bceeae3c4a9154c87db1649473316e44","todo":"task 2","done":false}

更新文档

在要更新文档时,包含_rev字段很重要。 CouchDB将拒绝任何不包含_rev字段的更新请求。 由于CouchDB更新整个文档,而不仅仅是其中的一部分,所以在更新操作期间,必须在请求正文中发送整个文档。

要更新使用ID为random_task的文档,我们需要发出HTTP PUT请求,如下所示:

curl -X PUT -d '{"_rev":"1-bceeae3c4a9154c87db1649473316e44", "todo":"task 2", "done":true}' http://localhost:5984/new_database/random_task

因为每个_rev值可能不太一样,所以请确保将_rev值替换为上一个输出中接收到的字符串。

这将修改文档并将done字段更新为true。 对此请求的响应如下:

{"ok":true,"id":"random_task","rev":"2-4cc3dfb6e76befd665faf124b36b7f1c"}

从响应中可以看出,该指定文档的rev字段在更新后会发生更改。 任何将来更新或删除此文档的请求现在都必须使用最新的rev值。

删除文档

使用HTTP DELETE请求要指定包含这个新的rev值来删除这个文档,如下所示:

curl -X DELETE http://localhost:5984/new_database/random_task?rev=2-4cc3dfb6e76befd665faf124b36b7f1c

就像上面的GET&PUT请求一样,DELETE请求使用指向文档的URL。但是,它还包括URL中的附加查询参数。 该参数rev应具有删除操作成功的最新_rev值。

在这种特殊情况下,使用上一步中更新操作后返回的值。 对上述请求的响应如下所示。

{"ok":true,"id":"random_task","rev":"3-07d6cde68be2a559497ec263045edc9d"}

重新启动,停止和启动CouchDB服务

启动,停止和重新启动CouchDB服务是非常简单的。下面我们来看看如何从服务器完成这些步骤。

重新启动CouchDB

要重新启动正在运行的CouchDB实例,请执行以下命令:

$ sudo restart couchdb

此命令将重新启动正在运行的CouchDB实例并显示新实例的进程ID。如果没有CouchDB的实例运行,执行该命令会给出一个消息:

$ restart: Unknown instance:

停止CouchDB

要停止运行的CouchDB实例,请执行以下命令:

$ sudo stop couchdb

执行此命令将停止任何正在运行的CouchDB实例,并提供如下所示的确认消息:

$ couchdb stop/waiting

启动CouchDB

要启动CouchDB,请执行以下命令:

$ sudo start couchdb

如果CouchDB尚未运行,则执行此命令将启动CouchDB并提供如下所示的确认消息:

$ couchdb start/running, process 12345

如果有CouchDB实例已经运行,那么执行上面的命令就会产生一个这样的消息:

$ start: Job is already running: couchdb

CouchDB状态

如果想查看CouchDB的状态,可以使用以下命令:

$ sudo status couchdb

如果CouchDB正在运行,则会提供类似于以下内容的消息:

$ couchdb start/running, process 12345

如果CouchDB没有运行,查看状态将提示消息如下:

couchdb stop/waiting

结束

您现在可以在服务器上使用CouchDB的所有功能了,可以使用Futon或命令行从本地机器安全地管理CouchDB。

最后声明:对伸手党,需要注意的是:本教程包教不包会。

  

从零到一,创造未来!跨零综合IT问题解决服务站,欢迎你的到来。Oracle数据库教程 couchdb教程 只为你绽放。

本文固定链接: http://kua0.com/2019/01/26/数据库教程-couchdb快速入门/

为您推荐

发表评论

电子邮件地址不会被公开。 必填项已用*标注