CouchDB - Tworzenie dokumentu

Dokumenty to centralna struktura danych CouchDB. Zawartość bazy danych będzie przechowywana w formie Dokumentów zamiast tabel. Możesz tworzyć te dokumenty za pomocą narzędzia cURL dostarczanego przez CouchDB, a także Futon. W tym rozdziale omówiono sposoby tworzenia dokumentów w bazie danych.

Każdy dokument w CouchDB ma unikalny identyfikator. Możesz wybrać własny identyfikator, który powinien mieć postać ciągu. Ogólnie używany jest UUID (Universally Unique IDentifier), czyli liczby losowe, które mają najmniejszą szansę na utworzenie duplikatu. Są one preferowane, aby uniknąć kolizji.

Tworzenie dokumentu za pomocą narzędzia cURL

Możesz utworzyć dokument w CouchDB, wysyłając żądanie HTTP do serwera metodą PUT za pomocą narzędzia cURL. Poniżej znajduje się składnia tworzenia dokumentu.

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

Za pomocą −Xmożemy określić niestandardową metodę żądania HTTP, z której korzystamy podczas komunikacji z serwerem HTTP. W tym przypadku używamy metody PUT. Kiedy używamy metody PUT, zawartość adresu URL określa nazwę obiektu, który tworzymy za pomocą żądania HTTP. Tutaj musimy wysłać następujące -

Nazwa bazy danych, w której tworzymy dokument.
Identyfikator dokumentu.
Dane dokumentu. −dopcja służy do przesłania danych / dokumentu poprzez żądanie HTTP. Podczas pisania dokumentu po prostu wprowadź pary Pole-Wartość oddzielone dwukropkiem, w nawiasach kwiatowych, jak pokazano poniżej -

{
   Name : Raju
   age : 23
   Designation : Designer
}

Przykład

Używając powyższej składni, jeśli chcesz utworzyć dokument o identyfikatorze 001 w bazie danych o nazwie my_database, możesz go utworzyć, jak pokazano poniżej.

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

Odpowiedź CouchDB na to żądanie zawiera trzy pola -

"ok", co wskazuje, że operacja się powiodła.
"id", który przechowuje identyfikator dokumentu i
"rev",oznacza to identyfikator wersji. Za każdym razem, gdy poprawiasz (aktualizujesz lub modyfikujesz) dokument a_revwartość zostanie wygenerowana przez CouchDB. Jeśli chcesz zaktualizować lub usunąć dokument, CouchDB oczekuje, że dołączysz rozszerzenie_revpole wersji, którą chcesz zmienić. Gdy CouchDB zaakceptuje zmianę, wygeneruje nowy numer wersji. Ten mechanizm zapewnia kontrolę współbieżności.

Weryfikacja

Jeśli chcesz wyświetlić utworzony dokument, możesz go pobrać za pomocą dokumentu, jak pokazano poniżej.

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

Tworzenie dokumentu za pomocą Futon

Aby utworzyć dokument, otwórz plik http://127.0.0.1:5984/_utils/ url, aby uzyskać przegląd / indeks strony CouchDB, jak pokazano poniżej.

Wybierz bazę danych, w której chcesz utworzyć dokument. Otwórz stronę Przegląd bazy danych i wybierzNew Document opcja, jak pokazano poniżej.

Po wybraniu pliku New Documentopcja, CouchDB tworzy nowy dokument bazy danych, przypisując mu nowy identyfikator. Możesz edytować wartość id i przypisać własną wartość w postaci ciągu. Na poniższej ilustracji utworzyliśmy nowy dokument o identyfikatorze 001.

Na tej stronie możesz zaobserwować trzy opcje - zapisz dokument, dodaj pole i prześlij załącznik.

Dodaj pole do dokumentu

Aby dodać pole do dokumentu, kliknij Add Fieldopcja. Po utworzeniu bazy danych możesz dodać do niej pole za pomocą tej opcji. Kliknięcie go spowoduje wyświetlenie pary pól tekstowych, a mianowicie:Field, value.Możesz edytować te wartości, klikając je. Edytuj te wartości i wpisz żądaną parę pole-wartość. Kliknij zielony przycisk, aby zapisać te wartości.

Na poniższej ilustracji utworzyliśmy trzy pola Imię, wiek i Oznaczenie pracownika.

Zapisz dokument

Możesz zapisać zmiany wprowadzone w dokumencie, klikając tę opcję. Po zapisaniu nowy identyfikator_rev zostanie wygenerowany, jak pokazano poniżej.