Skip to content

CouchDB - 创建数据库

数据库是 CouchDB 中的顶级容器,您的 JSON 文档存储于其中。您可以使用 HTTP API(通常通过 cURL 等工具)或 Fauxton(CouchDB 的现代化 Web 界面)来创建数据库。

您可以通过向 CouchDB 实例发送 PUT HTTP 请求来创建数据库。数据库的名称在 URL 路径中指定。为了安全起见,现代 CouchDB 设置应包含管理员用户。以下示例包含身份验证信息。

基本语法如下:

# 语法: curl -X PUT http://<用户>:<密码>@<主机>:<端口>/<数据库名称>
# -u 标志是提供凭据更简洁的方式。
curl -X PUT http://127.0.0.1:5984/new_database -u admin:password

这里,-X PUT 指定了 HTTP 方法。-u admin:password 标志提供了管理员用户的凭据。如果您的 CouchDB 实例未受保护(不建议用于生产环境),您可以省略 -u 标志。

让我们创建一个名为 user_profiles 的数据库:

$ curl -X PUT http://127.0.0.1:5984/user_profiles -u admin:secret
{
"ok": true
}

服务器返回一个包含 "ok": true 的 JSON 对象,表示操作成功。

要验证数据库是否已创建,您可以从 /_all_dbs 端点请求所有数据库的列表。您应该在列表中看到 user_profiles。

$ curl -X GET http://127.0.0.1:5984/_all_dbs -u admin:secret
["_global_changes", "_replicator", "_users", "user_profiles"]

使用 Fauxton(Web 界面)创建数据库

Section titled “使用 Fauxton(Web 界面)创建数据库”

Fauxton 是 CouchDB(2.0 及更高版本)的官方 Web 管理 UI,取代了旧版 Futon。它提供了一种用户友好的方式来管理您的数据库。

请按照以下步骤创建数据库:

  • 打开您的 Web 浏览器并导航到 Fauxton UI,通常在 http://127.0.0.1:5984/_utils/。
  • 如果出现提示,请使用您的管理员凭据登录。
  • 点击左侧导航菜单中的“数据库”图标(看起来像一堆圆筒)。
  • 点击页面右上角的 + Create Database 按钮。
  • 将出现一个对话框。输入您想要的数据库名称,例如 invoices。
  • 对于“分区 (Partitioning)”选项,通常使用“非分区 (Non-partitioned)”即可。分区数据库是用于在大型集群部署中提高性能的高级功能。
  • 点击“创建 (Create)”按钮。您的新数据库现在将出现在列表中。

为数据库使用一致的命名约定是最佳实践。CouchDB 要求名称以小写字母开头,并且只能包含小写字母 (a-z)、数字 (0-9) 以及特殊字符 _、$、(、)、+、- 和 /。