CouchDB快速入门

2019年10月4日 245次阅读 来源: 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系统
  • 拥有管理权限的用户身份登录到服务器

注意：本教程假设使用的是非root用户，并可以执行root用户权限。请注意，如果您使用非root用户，首次使用sudo执行命令时，系统将要求您输入root用户的密码。

步骤1 – 准备服务器

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

开始更新系统：

$ sudo apt-get update

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

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

注意：-y标志告诉apt-get命令对安装过程中可能出现的所有提示以Yes响应。 如果您喜欢手动响应提示，可以删除此标志。

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

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

警告：在您的服务器上添加一个新的个人包存档(PPA)时，应该非常小心。 因为任何人都可以创建PPA，所以不能保证它是可信赖的，或者它是安全的。 在这种情况下，上述PPA是由Apache CouchDB团队维护的官方PPA。

经过上一步，已经添加了一个新的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

注意：如果没有安装curl程序工具，可以使用sudo apt-get install curl命令进行安装。

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

{"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

注意：请记住用您的用户名替换yiibai_user，将your_server_ip替换为服务器的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配置。 但是，它不会阻止其它创建或访问文档。

就这样，有关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。

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

        原文作者：CouchDB教程
        原文地址: https://www.yiibai.com/couchdb/quick-start.html
        本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
    点赞