CouchDB - 创建文档

文档是CouchDB的核心数据结构。数据库的内容将以文档的形式存储，而不是表的形式。您可以使用CouchDB提供的cURL实用程序以及Futon来创建这些文档。本章介绍在数据库中创建文档的方法。

CouchDB中的每个文档都有一个唯一的ID。您可以选择您自己的ID，它应该是一个字符串形式。通常使用UUID（Universally Unique IDentifier），它们是随机数，创建重复的可能性最小。建议使用它们来避免冲突。

使用cURL实用程序创建文档

您可以通过使用cURL实用程序通过PUT方法向服务器发送HTTP请求来在CouchDB中创建文档。以下是创建文档的语法。

$ curl -X PUT http://127.0.0.1:5984/database name/"id" -d ' { document} '

使用−X，我们可以指定我们与HTTP服务器通信时使用的HTTP自定义请求方法。在本例中，我们使用PUT方法。当我们使用PUT方法时，url的内容指定了我们使用HTTP请求创建的对象名称。这里我们需要发送以下内容：

我们要创建文档的数据库名称。
文档ID。
文档的数据。−d选项用于通过HTTP请求发送数据/文档。编写文档时，只需在花括号内输入用冒号分隔的字段-值对，如下所示：

{
   Name : Raju
   age : 23
   Designation : Designer
}

示例

使用上面给出的语法，如果您想在名为my_database的数据库中创建一个ID为001的文档，您可以按如下所示创建它。

$ curl -X PUT http://127.0.0.1:5984/my_database/"001" -d
'{ " Name " : " Raju " , " age " :" 23 " , " Designation " : " Designer " }'

{"ok":true,"id":"001","rev":"1-1c2fae390fa5475d9b809301bbf3f25e"}

CouchDB对此请求的响应包含三个字段：

"ok"，表示操作成功。
"id"，存储文档的ID，以及
"rev"，这表示修订ID。每次修改（更新或修改）文档时，CouchDB都会生成一个_rev值。如果您想更新或删除文档，CouchDB希望您包含要更改的修订版的_rev字段。当CouchDB接受更改时，它将生成一个新的修订号。此机制确保并发控制。

验证

如果您想查看已创建的文档，您可以使用如下所示的文档获取它。

$ curl -X GET http://127.0.0.1:5984/my_database/001
{
   "_id": "001",
   "_rev": "1-3fcc78daac7a90803f0a5e383f4f1e1e",
   "Name": "Raju",
   "age": 23,
   "Designation": "Designer"
}