Operações em CouchDB usando cURL

Faça interações com CouchDB é muito fácil, uma vez que temos acesso a Futon e através da interface gráfica podemos começar a criar documentos e coleções, porém isso só funciona quando temos acesso à interface gráfica ou web. Em outros ambientes, certamente precisaremos de uma interface por meio de um serviço de internet para sermos capazes de construir as estruturas de que precisaremos.
Uma maneira muito simples de se conectar de uma forma "não gráfica" é através ondulação já que com esta ferramenta podemos enviar solicitações sob os diferentes métodos HTTP o que suporta CouchDB e também podemos usá-lo para outros fins que não o uso de CouchDB.
Requisitos
1- Precisamos ter uma instalação funcional de CouchDBPara os primeiros passos nesta ferramenta você pode entrar no seguinte link, se tivermos estabelecido o usuário administrador, devemos ter seu nome de usuário e senha.
2- Uma conexão com a Internet é necessária para baixar os requisitos para a instalação do ondulação.
3- Também precisaremos ter permissões para instalar aplicativos, pois no caso de não ter ondulação você tem que instalá-lo.
Instalando cURL no Linux
Se estivermos usando sistemas baseados em Linux O que Ubuntu ou LinuxMint A instalação de ondulação É tão simples quanto simplesmente usar o seguinte comando do console:

sudo apt-get updatesudo apt-get install curl libcurl3 libcurl3-dev php5-curl

Isso nos dará todas as ferramentas necessárias para sermos capazes de executar ondulação de nossa linha de comando e, assim, ser capaz de interagir com CouchDB.
Instalação de cURL no Windows
Em janelas infelizmente o processo é um pouco mais complexo para conseguir a instalação de ondulaçãoNo entanto, não é uma tarefa impossível, iremos descrever as etapas necessárias para atingir esse objetivo antes de interagir com CouchDB.
1- Instale os arquivos Visual C ++ 2008 Y 2010 chamado redistribuíveisPodemos obtê-los gratuitamente e para plataformas de 32 e 64 bits. No nosso caso, usaremos a plataforma de 64 bits no link a seguir.

PROLONGAR

2- No próximo ato, devemos instalar a versão do OpenSSL correspondente ao nosso sistema, para isso podemos visitar o seguinte site onde obteremos o pacote de acordo com o nosso sistema 64 bits ou 32 bits.

3- Assim que tivermos os pré-requisitos instalados, agora iremos fazer o download e instalar ondulação Para isso, acessaremos o link a seguir e obteremos o pacote genérico para nossa versão, como já fizemos nas etapas anteriores, escolheremos o pacote de 64 bits para este caso.

PROLONGAR

4- Uma vez obtido o arquivo anterior, vamos descompactá-lo em uma pasta e fazer a instalação correspondente.
5- Finalmente, devemos instalar o certificado SSL, esta etapa é muito importante e não devemos pulá-la, para isso vamos para a seguinte página da web, uma vez lá faremos o download do arquivo cacert.pem e vamos copiá-lo onde instalarmos ondulação na etapa anterior, finalmente o renomeamos para curl-ca-bundle.crt.
6- Abrimos um console com cmd e vamos para a pasta onde temos ondulação e o certificado anterior e nós executamos curl.exe --help para ver os diferentes comandos disponíveis. Com isso já teremos ondulação instalado em nosso computador.
Estabelecendo nossa primeira conexão com CouchDB
Já que temos a ferramenta de comunicação com o serviço e em tese devemos ter preparado CouchDB, agora vamos testar se podemos conectar, para isso no console onde temos ondulação vamos executar o seguinte:

curl http: //127.0.0.1:5984curl.exe http: //127.0.0.1:5984

A primeira opção funciona para nós Linux e o segundo em janelas, uma vez que a única coisa que muda é o .Exe no final do comando e como estamos construindo o tutorial no Windows, vamos manter o segundo para o restante dos exemplos. Ao executar a instrução anterior, o servidor CouchDB Você deve responder mostrando-nos uma mensagem com a versão dele.

Isso indica que já temos acesso a CouchDB e podemos começar a manipular as diferentes coleções de documentos que temos ou criar novas, se desejarmos.
Crie um banco de dados
Seguindo a filosofia de serviços DESCANSO a criação do elemento cai para o método HTTP PUT, é por isso que se quisermos criar um banco de dados, só temos que enviar uma solicitação PUT de ondulação e assim podemos cumprir o objetivo, para isso podemos executar o seguinte:

curl.exe -X PUT http: //127.0.0.1:5984/test-bd

O que vem depois do endereço de CouchDB é o nome que nosso Base de dados isso deve nos dar um resultado como o seguinte:

Estamos com um problema, como nossa instalação possui um usuário administrador, não podemos ter acesso gratuito, mas isso não é um problema, apenas temos que passar o nome de usuário e senha na conexão da seguinte forma:

http: //user:[email protected]:5984/

Depois de sabermos disso, iremos repetir o comando com as configurações necessárias:

curl.exe -X PUT http: //root:[email protected]:5984/db-test

Agora vemos que se tivermos uma mensagem ok, significa que a operação foi concluída corretamente:

Se tentarmos repetir a ação, obteremos um erro, pois CouchDB irá validar se o banco de dados já existe:

Se quisermos consultar o conteúdo do nosso Base de dados nós apenas temos que mudar o método de POR de OBTER e podemos validar informações importantes sobre ele:

curl.exe -X GET http: //root:[email protected]:5984/db-test

O que é realmente valioso para nos informar o que está acontecendo com nosso banco de dados caso não tenhamos certeza.
Crie um documento dentro do banco de dados
Agora vamos passar para a parte mais interessante do tutorial, já que temos nosso Banco de Dados, com certeza estaremos interessados ​​em armazenar algo nele, para isso devemos inserir documentos. Os documentos em CouchDB são compostos sob a estrutura JSON, por isso é assim que devemos enviar os dados para que possam ser processados.
Em ondulação Só temos que estabelecer o cabeçalho da solicitação que estamos enviando e indicar que é JSON, então damos a você a rota de nosso Base de dados que criamos, mas neste caso usando o método PUBLICARe, finalmente, passamos a você o conteúdo do nosso novo documento.
Vamos ver o seguinte código que nos permite adicione um documento ao banco de dados que criamos no exercício anterior:

curl.exe -H “Content-type: application / json” -X POST http: //root:[email protected]:5984/db-test -d \ “{\" title \ ": \" Primeiro Documento \ "}"

Observe que colocamos barras de escape para as aspas duplas dentro do JSON, isso nos daria uma mensagem ok, assim como quando criamos nosso banco de dados:

Se percebemos a resposta ok não veio sozinha, mas também nos trouxe outros campos dentro do JSON um corresponde a ir do documento dentro do Base de dados e outro para a revisão.
Consultar por id
O último parágrafo do exemplo anterior leva-nos a este novo exercício, que consiste em consultar um documento do nosso Base de dados, para isso, simplesmente temos que fazer um pedido OBTER e passe o número do identificador após o nome do Banco de Dados, por exemplo:

curl.exe -X GET http: //root:[email protected]:5984/test-bd/90c25e76138e8341bfa1241a3700098e

Vamos lembrar que ir são diferentes em cada equipe, pois é um cerquilha único, então eles devem colocar o id correspondente à sua própria consulta. Isso no final nos dará o seguinte resultado, como podemos ver na imagem a seguir:

Exclua o banco de dados
O último método que não vimos é o de EXCLUIR, isto como o seu nome indica nos permite eliminar recursos, é muito poderoso já que extrairá do nosso servidor o que corresponda ao parâmetro de pesquisa do mesmo.
Vamos apagar o Base de dados que criamos para demonstrar como podemos usá-lo, simplesmente devemos usar o seguinte comando:

curl.exe -X DELETE http: //root:[email protected]:5984/test-bd

Isso irá eliminar Base de dados Junto com todos os seus documentos, portanto, devemos ter cuidado ao empregar este método, vamos ver como o resultado é:

Se repetirmos a pesquisa via OBTER Da mesma forma que usamos no primeiro exercício do tutorial veremos que não teremos resultado, simplesmente CouchDB Ele nos dirá que não consegue encontrar o recurso, como vemos na imagem a seguir:

Com isso terminamos este tutorial, vimos como podemos instalar a ferramenta ondulação e com isso fazer interações diretas com nosso servidor CouchDB, este tipo de manuseio nos ajuda a entender mais sobre o processo por trás deste grande motor de Base de dados, e também nos mostra que podemos usar o console sem ter que lidar com uma linguagem de programação específica.Gostou e ajudou este tutorial?Você pode recompensar o autor pressionando este botão para dar a ele um ponto positivo