在CouchDB中,資料庫的資料以文件的形式而不是表格儲存。
要在CouchDB資料庫中建立文件,請開啟Fauxton url:
http://localhost:5984/_utils/
選擇特定的資料庫,假設在資料庫:yiibai_db
上建立文件,先點選yiibai_db
資料庫連結進入資料概覽。 點選新文件(New Document),如下圖所示:
然後就會開啟一個頁面,預設只有一個欄位:_id
,但是可以通點選」Add Field「來新增更多的欄位:
填入所有資料項後,單擊儲存更改索引標籤。現在就成功建立文件。
建立一個文件成功後,詳細資訊如下所示 -
要在CouchDB中建立文件,也可以通過cURL實用程式向伺服器傳送HTTP PUT方法請求。
以下是建立文件的語法。
語法:
curl -X PUT http://localhost:5984/database_name/"id" -d ' { document} '
注意:
-X
用於指定與HTTP伺服器進行通訊的HTTP的自定義請求方法。 在這種情況下使用的是PUT方法。當使用PUT方法時,HTTP請求指定url的內容是用來建立物件名稱。
database_name
指定要在其中建立文件的資料庫的名稱。id
用來指定文件ID。-d
選項用於通過HTTP請求傳送資料/文件。{
name : minsu
age : 24
address : No. 112 ZhongShangRoad GuangZhou
}
範例:
在資料庫yiibai_db
中,建立一個id
為「10010
」的文件。
curl -H 'Content-Type: application/json' -X PUT http://localhost:5984/yiibai_db/"10010" -d'{"name":"minsu", "age":"24" , "address" : "No. 112 ZhongShangRoad GuangZhou" }'
執行結果如下 -
yiibai@ubuntu:~$ curl -H 'Content-Type: application/json' -X PUT http://localhost:5984/yiibai_db/"10010" -d'{"name":"minsu", "age":"24" , "address" : "No. 112 ZhongShangRoad GuangZhou" }'
{"ok":true,"id":"10010","rev":"1-384d2bc91a881c6f9509b974573707bb"}
yiibai@ubuntu:~$
CouchDB對上面建立命令的響應包含3
個欄位:
_rev
值。 如果要更新或刪除文件,CouchDB希望您包含要更改的修訂版本的_rev
欄位。 當CouchDB接受更改時,它將生成一個新的修訂版本號。驗證:
可以使用以下命令驗證文件是否已建立:
curl -X GET http://localhost:5984/yiibai_db/10010
執行上面命令,得到以下結果 -
yiibai@ubuntu:~$ curl -X GET http://localhost:5984/yiibai_db/10010
{"_id":"10010","_rev":"1-384d2bc91a881c6f9509b974573707bb","name":"minsu","age":"24","address":"No. 112 ZhongShangRoad GuangZhou"}
yiibai@ubuntu:~$