Opérations dans CouchDB à l'aide de cURL

Faire des interactions avec CouchDB c'est très facile une fois qu'on a accès à Futon et grâce à l'interface graphique, nous pouvons commencer à créer des documents et des collections, mais cela n'est fonctionnel que lorsque nous avons un accès à une interface graphique ou Web. Dans d'autres environnements, nous aurons sûrement besoin d'une interface via un service Web pour pouvoir construire les structures dont nous aurons besoin.
Un moyen très simple de se connecter de manière « non graphique » consiste à boucle car avec cet outil nous pouvons envoyer des demandes sous les différentes méthodes HTTP ce qui soutient CouchDB et nous pouvons également l'utiliser à d'autres fins que l'utilisation de CouchDB.
Exigences
1- Nous avons besoin d'une installation fonctionnelle de CouchDBPour les premiers pas dans cet outil, vous pouvez entrer le lien suivant, si nous avons établi l'utilisateur administrateur, nous devons avoir votre nom d'utilisateur et votre mot de passe.
2- Une connexion Internet est nécessaire pour télécharger la configuration requise pour l'installation de boucle.
3- Nous aurons également besoin d'avoir des autorisations pour installer des applications, car dans le cas de ne pas avoir boucle vous devez l'installer.
Installer cURL sur Linux
Si nous utilisons des systèmes basés sur Linux Quoi Ubuntu ou alors LinuxMint L'installation de boucle C'est aussi simple que d'utiliser simplement la commande suivante depuis la console :

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

Cela nous donnera tous les outils nécessaires pour pouvoir exécuter boucle depuis notre ligne de commande et ainsi pouvoir interagir avec CouchDB.
Installation de cURL sous Windows
Dans les fenêtres malheureusement le processus est un peu plus complexe pour pouvoir réaliser l'installation de boucleCependant, ce n'est pas une tâche impossible, nous décrirons les étapes nécessaires pour atteindre cet objectif avant d'interagir avec CouchDB.
1- Installer les fichiers Visuel C++ 2008 Oui 2010 appelé redistribuablesNous pouvons les obtenir gratuitement et pour les plates-formes 32 bits et 64 bits. Dans notre cas, nous utiliserons la plate-forme 64 bits dans le lien suivant.

AGRANDIR

2- Prochain acte nous devons installer la version de OpenSSL correspondant à notre système, pour cela, nous pouvons visiter le site Web suivant où nous obtiendrons le package selon notre système soit 64 bits ou 32 bits.

3- Une fois les prérequis installés, nous allons maintenant procéder au téléchargement et à l'installation boucle Pour ce faire, nous irons sur le lien suivant et obtiendrons le package générique pour notre version, comme nous l'avons fait dans les étapes précédentes, nous choisirons le package 64 bits pour ce cas.

AGRANDIR

4- Une fois le fichier précédent obtenu, nous allons le décompresser dans un dossier et faire l'installation correspondante.
5- Enfin il faut installer le certificat SSL, cette étape est très importante et nous ne devons pas la sauter, pour cela nous allons à la page Web suivante, une fois là-bas, nous allons télécharger le fichier cacert.pem et nous allons le copier là où nous l'installons boucle à l'étape précédente, nous l'avons finalement renommé en curl-ca-bundle.crt.
6- On ouvre une console avec cmd et nous allons dans le dossier où nous avons boucle et le certificat précédent et nous exécutons curl.exe --help pour voir les différentes commandes disponibles. Avec cela, nous aurons déjà boucle installé sur notre ordinateur.
Établir notre première connexion avec CouchDB
Puisque nous avons l'outil de communication avec le service et qu'en théorie nous devons avoir préparé CouchDB, maintenant nous allons tester que nous pouvons nous connecter, pour cela dans la console où nous avons boucle nous allons exécuter ce qui suit :

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

La première option fonctionne pour nous Linux et le deuxième en les fenêtres, puisque la seule chose qui change est la .EXE à la fin de la commande et puisque nous construisons le tutoriel sous Windows, nous allons garder le second pour la suite des exemples. Lors de l'exécution de l'instruction précédente, le serveur CouchDB Vous devez répondre en nous montrant un message avec la version de celui-ci.

Cela indique que nous avons déjà accès à CouchDB et nous pouvons commencer à manipuler les différentes collections de documents que nous avons ou en créer de nouvelles si nous le souhaitons.
Créer une base de données
Suivre la philosophie des services DU REPOS la création de l'élément relève de la méthode METTRE HTTP, c'est pourquoi si nous voulons créer une base de données, nous n'avons qu'à envoyer une demande PUT de boucle et ainsi nous pouvons atteindre l'objectif, pour cela nous pouvons exécuter ce qui suit :

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

Qu'y a-t-il après l'adresse de CouchDB est le nom que notre Base de données cela devrait nous donner un résultat comme le suivant :

Nous avons un problème, comme notre installation a un utilisateur administrateur, nous ne pouvons pas avoir un accès libre, mais ce n'est pas un problème, nous n'avons qu'à passer le nom d'utilisateur et le mot de passe dans la connexion comme suit :

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

Après avoir su cela, nous allons répéter la commande avec les paramètres nécessaires :

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

Maintenant, nous voyons que si nous avons un message ok, cela signifie que l'opération s'est terminée correctement :

Si nous essayons de répéter l'action, nous obtiendrons une erreur car CouchDB validera que la base de données existe déjà :

Si nous voulons consulter le contenu de notre Base de données nous devons juste changer la méthode de METTRE pour AVOIR et nous pouvons valider des informations importantes à ce sujet :

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

Ce qui est vraiment précieux pour nous informer de ce qui se passe avec notre base de données au cas où nous ne serions pas sûrs.
Créer un document dans la base de données
Nous allons maintenant passer à la partie la plus intéressante du didacticiel, puisque nous avons notre base de données, nous serons sûrement intéressés à y stocker quelque chose, pour cela nous devons insérer des documents. Les documents en CouchDB sont composés sous la structure JSON, c'est donc de cette manière que nous devons envoyer les données afin qu'elles puissent être traitées.
Dans boucle Il nous suffit d'établir l'en-tête de la demande que nous envoyons et d'indiquer qu'elle est JSON, alors nous vous donnons l'itinéraire de notre Base de données que nous avons créé mais dans ce cas en utilisant la méthode PUBLIER, et enfin nous vous transmettons le contenu de notre nouveau document.
Voyons le code suivant qui nous permet ajouter un document à la base de données que nous avons créée dans l'exercice précédent :

curl.exe -H « Type de contenu : application / json » -X POST http : //root:[email protected]:5984/db-test -d \ « {\" titre \ " : \" Premier document \ "}"

Notez que nous avons placé des barres d'échappement pour les guillemets doubles à l'intérieur du JSON, cela nous donnerait un message ok comme lorsque nous avons créé notre base de données :

Si nous avons remarqué que la réponse d'accord n'est pas venue seule, elle nous a également apporté d'autres domaines au sein de la JSON l'un correspond à aller du document dans le Base de données et un autre à l'examen.
Consulter par identifiant
Le dernier paragraphe de l'exemple précédent nous amène à ce nouvel exercice qui consiste à consulter un document de notre Base de données, pour cela il suffit de faire une demande AVOIR et passez le numéro d'identifiant après le nom de la Base, par exemple :

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

Souvenons-nous que aller sont différents dans chaque équipe puisqu'il s'agit d'un hacher unique donc ils doivent mettre l'identifiant correspondant à leur propre requête. Cela nous donnera à la fin le résultat suivant comme nous pouvons le voir dans l'image suivante:

Supprimer la base de données
La dernière méthode que nous n'avons pas vue est celle de EFFACER, ceci comme son nom l'indique nous permet d'éliminer des ressources, il est très puissant puisqu'il extraira de notre serveur ce qui correspond au paramètre de recherche de celui-ci.
Effacons le Base de données que nous avons créé pour montrer comment nous pouvons l'utiliser, nous devons simplement utiliser la commande suivante :

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

Cela éliminera Base de données Avec tous vos documents, nous devons donc être prudents lors de l'utilisation de cette méthode, voyons comment le résultat est :

Si nous répétons la recherche via AVOIR De la même manière que nous avons utilisé dans le premier exercice du tutoriel nous verrons que nous n'aurons pas de résultat, simplement CouchDB Il nous dira qu'il ne peut pas trouver la ressource comme nous le voyons dans l'image suivante :

Avec cela, nous terminons ce tutoriel, nous avons vu comment nous pouvons installer l'outil boucle et avec lui faire des interactions directes avec notre serveur CouchDB, ce type de manipulation nous aide à mieux comprendre le processus derrière ce grand moteur de Base de données, et cela nous montre également que nous pouvons utiliser la console sans avoir à manipuler un langage de programmation particulier.Avez-vous aimé et aidé ce tutoriel ?Vous pouvez récompenser l'auteur en appuyant sur ce bouton pour lui donner un point positif