CouchDB - Tạo tài liệu

Tài liệu là cấu trúc dữ liệu trung tâm của CouchDB. Nội dung của cơ sở dữ liệu sẽ được lưu trữ dưới dạng Tài liệu thay vì bảng. Bạn có thể tạo các tài liệu này bằng tiện ích cURL do CouchDB, cũng như Futon cung cấp. Chương này trình bày các cách tạo tài liệu trong cơ sở dữ liệu.

Mỗi tài liệu trong CouchDB có một ID duy nhất. Bạn có thể chọn ID của riêng mình ở dạng một chuỗi. Nói chung, UUID (Mã định danh duy nhất phổ biến) được sử dụng, là các số ngẫu nhiên có ít cơ hội tạo trùng lặp nhất. Những thứ này được ưu tiên để tránh va chạm.

Tạo tài liệu bằng cURL Utility

Bạn có thể tạo một tài liệu trong CouchDB bằng cách gửi một yêu cầu HTTP đến máy chủ bằng phương thức PUT thông qua tiện ích cURL. Sau đây là cú pháp để tạo một tài liệu.

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

Sử dụng −X, chúng tôi có thể chỉ định phương thức yêu cầu tùy chỉnh của HTTP mà chúng tôi đang sử dụng trong khi giao tiếp với máy chủ HTTP. Trong trường hợp này, chúng tôi đang sử dụng phương pháp PUT. Khi chúng tôi sử dụng phương thức PUT, nội dung của url chỉ định tên đối tượng mà chúng tôi đang tạo bằng cách sử dụng yêu cầu HTTP. Ở đây chúng tôi phải gửi những thứ sau -

Tên của tên cơ sở dữ liệu mà chúng tôi đang tạo tài liệu.
Id tài liệu.
Dữ liệu của tài liệu. −dtùy chọn được sử dụng để gửi dữ liệu / tài liệu thông qua yêu cầu HTTP. Trong khi viết tài liệu, chỉ cần nhập các cặp Trường-Giá trị của bạn được phân tách bằng dấu hai chấm, trong dấu ngoặc đơn như hình dưới đây

{
   Name : Raju
   age : 23
   Designation : Designer
}

Thí dụ

Sử dụng cú pháp đã cho ở trên nếu bạn muốn tạo tài liệu với id 001 trong cơ sở dữ liệu có tên my_database, bạn có thể tạo nó như hình dưới đây.

$ 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"}

Phản hồi của CouchDB đối với yêu cầu này chứa ba trường:

"ok", cho biết hoạt động đã thành công.
"id", nơi lưu trữ id của tài liệu và
"rev",điều này cho biết id bản sửa đổi. Mỗi khi bạn sửa đổi (cập nhật hoặc sửa đổi) một tài liệu_revgiá trị sẽ được tạo bởi CouchDB. Nếu bạn muốn cập nhật hoặc xóa một tài liệu, CouchDB mong bạn bao gồm_revtrường của bản sửa đổi mà bạn muốn thay đổi. Khi CouchDB chấp nhận thay đổi, nó sẽ tạo ra một số sửa đổi mới. Cơ chế này đảm bảo kiểm soát đồng thời.

xác minh

Nếu bạn muốn xem tài liệu đã tạo, bạn có thể lấy nó bằng cách sử dụng tài liệu như hình dưới đây.

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

Tạo tài liệu bằng Futon

Để tạo tài liệu, hãy mở http://127.0.0.1:5984/_utils/ url để lấy trang Tổng quan / chỉ mục của CouchDB như hình dưới đây.

Chọn cơ sở dữ liệu mà bạn muốn tạo tài liệu. Mở trang Tổng quan của cơ sở dữ liệu và chọnNew Document tùy chọn như hình dưới đây.

Khi bạn chọn New Documenttùy chọn, CouchDB tạo một tài liệu cơ sở dữ liệu mới, gán cho nó một id mới. Bạn có thể chỉnh sửa giá trị của id và có thể gán giá trị của riêng bạn dưới dạng một chuỗi. Trong hình minh họa sau, chúng tôi đã tạo một tài liệu mới với id 001.

Trong trang này, bạn có thể quan sát ba tùy chọn - lưu Tài liệu, Thêm Trường và Tải lên Tệp đính kèm.

Thêm trường vào tài liệu

Để thêm trường vào tài liệu, hãy nhấp vào Add FieldLựa chọn. Sau khi tạo cơ sở dữ liệu, bạn có thể thêm một trường vào nó bằng cách sử dụng tùy chọn này. Nhấp vào nó sẽ giúp bạn có một cặp hộp văn bản, cụ thể làField, value.Bạn có thể chỉnh sửa các giá trị này bằng cách nhấp vào chúng. Chỉnh sửa các giá trị đó và nhập cặp Trường-Giá trị mong muốn của bạn. Nhấp vào nút màu xanh lá cây để lưu các giá trị này.

Trong hình minh họa sau đây, chúng tôi đã tạo ba trường Tên, tuổi và Chức vụ của nhân viên.

Lưu tài liệu

Bạn có thể lưu các thay đổi được thực hiện đối với tài liệu bằng cách nhấp vào tùy chọn này. Sau khi lưu, một id mới_rev sẽ được tạo như hình dưới đây.