CouchDB - Creazione di un documento
I documenti sono la struttura dati centrale di CouchDB. Il contenuto del database verrà archiviato sotto forma di documenti invece che di tabelle. È possibile creare questi documenti utilizzando l'utilità cURL fornita da CouchDB e Futon. Questo capitolo descrive i modi per creare un documento in un database.
Ogni documento in CouchDB ha un ID univoco. Puoi scegliere il tuo ID che dovrebbe essere sotto forma di stringa. In generale, viene utilizzato UUID (Universally Unique IDentifier), che sono numeri casuali che hanno meno possibilità di creare un duplicato. Questi sono preferiti per evitare collisioni.
Creazione di un documento utilizzando l'utilità cURL
È possibile creare un documento in CouchDB inviando una richiesta HTTP al server utilizzando il metodo PUT tramite l'utilità cURL. Di seguito è riportata la sintassi per creare un documento.
$ curl -X PUT http://127.0.0.1:5984/database name/"id" -d ' { document} 'Utilizzando −X, possiamo specificare un metodo di richiesta personalizzato di HTTP che stiamo utilizzando, durante la comunicazione con il server HTTP. In questo caso, stiamo usando il metodo PUT. Quando usiamo il metodo PUT, il contenuto dell'URL specifica il nome dell'oggetto che stiamo creando utilizzando la richiesta HTTP. Qui dobbiamo inviare quanto segue:
Il nome del nome del database in cui stiamo creando il documento.
L'ID del documento.
I dati del documento. −dopzione viene utilizzata per inviare i dati / documento tramite richiesta HTTP. Durante la scrittura di un documento, inserisci semplicemente le tue coppie campo-valore separate da due punti, tra parentesi di fiori come mostrato di seguito -
{
Name : Raju
age : 23
Designation : Designer
}Esempio
Utilizzando la sintassi sopra indicata se si desidera creare un documento con id 001 in un database con nome my_database, puoi crearlo come mostrato di seguito.
$ 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"}La risposta di CouchDB a questa richiesta contiene tre campi:
"ok", indicando che l'operazione è andata a buon fine.
"id", che memorizza l'ID del documento e
"rev",questo indica l'id della revisione. Ogni volta che rivedi (aggiorni o modifichi) un documento a_revil valore verrà generato da CouchDB. Se desideri aggiornare o eliminare un documento, CouchDB si aspetta che tu includa il file_revcampo della revisione che si desidera modificare. Quando CouchDB accetta la modifica, genererà un nuovo numero di revisione. Questo meccanismo garantisce il controllo della concorrenza.
Verifica
Se desideri visualizzare il documento creato, puoi ottenerlo utilizzando il documento come mostrato di seguito.
$ curl -X GET http://127.0.0.1:5984/my_database/001
{
"_id": "001",
"_rev": "1-3fcc78daac7a90803f0a5e383f4f1e1e",
"Name": "Raju",
"age": 23,
"Designation": "Designer"
}Creazione di un documento utilizzando Futon
Per creare un documento apri il file http://127.0.0.1:5984/_utils/ url per ottenere una pagina Panoramica / indice di CouchDB come mostrato di seguito.
Seleziona il database in cui desideri creare il documento. Apri la pagina Panoramica del database e selezionaNew Document opzione come mostrato di seguito.
Quando selezioni il file New Documentopzione, CouchDB crea un nuovo documento di database, assegnandogli un nuovo id. È possibile modificare il valore dell'id e assegnare il proprio valore sotto forma di stringa. Nella figura seguente, abbiamo creato un nuovo documento con ID 001.
In questa pagina puoi osservare tre opzioni: Salva documento, Aggiungi campo e Carica allegato.
Aggiungi campo al documento
Per aggiungere un campo al documento fare clic su Add Fieldopzione. Dopo aver creato un database, è possibile aggiungervi un campo utilizzando questa opzione. Facendo clic su di esso otterrai un paio di caselle di testo, vale a dire,Field, value.È possibile modificare questi valori facendo clic su di essi. Modifica questi valori e digita la coppia campo-valore desiderata. Fare clic sul pulsante verde per salvare questi valori.
Nella figura seguente, abbiamo creato tre campi Nome, età e, Designazione del dipendente.
Salva documento
È possibile salvare le modifiche apportate al documento facendo clic su questa opzione. Dopo il salvataggio, un nuovo ID_rev verrà generato come mostrato di seguito.
