CouchDB - Criando um Documento

Os documentos são a estrutura de dados central do CouchDB. O conteúdo do banco de dados será armazenado na forma de documentos em vez de tabelas. Você pode criar esses documentos usando o utilitário cURL fornecido pelo CouchDB, bem como o Futon. Este capítulo aborda as maneiras de criar um documento em um banco de dados.

Cada documento no CouchDB possui um ID exclusivo. Você pode escolher seu próprio ID, que deve ter a forma de uma string. Geralmente, UUID (Universally Unique IDentifier) é usado, que são números aleatórios que têm menos chance de criar uma duplicata. Estes são preferidos para evitar colisões.

Criando um documento usando o utilitário cURL

Você pode criar um documento no CouchDB enviando uma solicitação HTTP ao servidor usando o método PUT por meio do utilitário cURL. A seguir está a sintaxe para criar um documento.

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

Usando −X, podemos especificar um método de solicitação personalizado de HTTP que estamos usando, enquanto nos comunicamos com o servidor HTTP. Neste caso, estamos usando o método PUT. Quando usamos o método PUT, o conteúdo da url especifica o nome do objeto que estamos criando usando a solicitação HTTP. Aqui temos que enviar o seguinte -

O nome do banco de dados no qual estamos criando o documento.
O ID do documento.
Os dados do documento. −dopção é usada para enviar os dados / documento por meio de solicitação HTTP. Ao escrever um documento, basta inserir seus pares de campo-valor separados por dois pontos, entre colchetes, conforme mostrado abaixo -

{
   Name : Raju
   age : 23
   Designation : Designer
}

Exemplo

Usando a sintaxe fornecida acima, se você deseja criar um documento com id 001 em um banco de dados com nome my_database, você pode criá-lo conforme mostrado abaixo.

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

A resposta do CouchDB a esta solicitação contém três campos -

"ok", indicando que a operação foi bem-sucedida.
"id", que armazena o id do documento e
"rev",isso indica o id de revisão. Cada vez que você revisa (atualiza ou modifica) um documento, um_revvalor será gerado pelo CouchDB. Se você deseja atualizar ou excluir um documento, o CouchDB espera que você inclua o_revcampo da revisão que você deseja alterar. Quando o CouchDB aceitar a mudança, ele gerará um novo número de revisão. Este mecanismo garante o controle da concorrência.

Verificação

Se você deseja visualizar o documento criado, pode obtê-lo usando o documento conforme mostrado abaixo.

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

Criando um documento usando o Futon

Para criar um documento, abra o http://127.0.0.1:5984/_utils/ url para obter uma página de visão geral / índice do CouchDB conforme mostrado abaixo.

Selecione o banco de dados no qual deseja criar o documento. Abra a página Visão geral do banco de dados e selecioneNew Document opção como mostrado abaixo.

Quando você seleciona o New Documentopção, CouchDB cria um novo documento de banco de dados, atribuindo a ele um novo id. Você pode editar o valor do id e atribuir seu próprio valor na forma de uma string. Na ilustração a seguir, criamos um novo documento com um id 001.

Nesta página, você pode observar três opções - salvar Documento, Adicionar Campo e Carregar Anexo.

Adicionar campo ao documento

Para adicionar campo ao documento clique em Add Fieldopção. Depois de criar um banco de dados, você pode adicionar um campo a ele usando esta opção. Clique nele para obter um par de caixas de texto, a saber,Field, value.Você pode editar esses valores clicando neles. Edite esses valores e digite o par Campo-Valor desejado. Clique no botão verde para salvar esses valores.

Na ilustração a seguir, criamos três campos Nome, idade e Designação do funcionário.

Salvar Documento

Você pode salvar as alterações feitas no documento clicando nesta opção. Depois de salvar, um novo id_rev será gerado conforme mostrado abaixo.