Operationen in CouchDB mit cURL

Machen Sie Interaktionen mit CouchDB Es ist ganz einfach, wenn wir Zugang zu haben Futon und über die grafische Oberfläche können wir mit der Erstellung von Dokumenten und Sammlungen beginnen, dies funktioniert jedoch nur, wenn wir über eine grafische oder Weboberfläche verfügen. In anderen Umgebungen benötigen wir sicherlich eine Schnittstelle über a Internetservice um die Strukturen aufzubauen, die wir brauchen.
Eine sehr einfache Möglichkeit, eine "nicht-grafische" Verbindung herzustellen, ist durch cURL da wir mit diesem Tool Anfragen unter den verschiedenen Methoden senden können HTTP was unterstützt CouchDB und wir können es auch für andere Zwecke als die Verwendung von CouchDB.
Anforderungen
1- Wir benötigen eine funktionsfähige Installation von CouchDBFür die ersten Schritte in diesem Tool können Sie den folgenden Link eingeben, wenn wir den Administrator-Benutzer eingerichtet haben, benötigen wir Ihren Benutzernamen und Ihr Passwort.
2- Eine Internetverbindung ist erforderlich, um die Voraussetzungen für die Installation von . herunterzuladen cURL.
3- Wir benötigen auch Berechtigungen zum Installieren von Anwendungen, da im Falle, dass sie nicht vorhanden sind cURL du musst es installieren.
cURL unter Linux installieren
Wenn wir Systeme verwenden, die auf Linux Was Ubuntu oder LinuxMint Die Installation von cURL Es ist so einfach, dass Sie einfach den folgenden Befehl von der Konsole aus verwenden:

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

Dies gibt uns alle notwendigen Werkzeuge, um die Ausführung durchführen zu können cURL von unserer Kommandozeile aus und können so mit CouchDB.
Installation de cURL unter Windows
In Fenster Leider ist der Prozess etwas komplexer, um die Installation von zu erreichen cURLEs ist jedoch keine unmögliche Aufgabe, wir werden die Schritte beschreiben, die erforderlich sind, um dieses Ziel zu erreichen, bevor wir mit interagieren CouchDB.
1- Installieren Sie die Dateien Visual C++ 2008 Ja 2010 namens weitervertreibbarWir können diese kostenlos und für 32-Bit- und 64-Bit-Plattformen erhalten. In unserem Fall verwenden wir im folgenden Link die 64-Bit-Plattform.

VERGRÖSSERN

2- Als nächstes müssen wir die Version von installieren OpenSSL Entsprechend unserem System können wir dazu die folgende Website besuchen, wo wir das Paket gemäß unserem System entweder 64 Bit oder 32 Bit erhalten.

3- Sobald wir die Voraussetzungen installiert haben, werden wir jetzt mit dem Herunterladen und Installieren fortfahren cURL Dazu gehen wir auf den folgenden Link und beziehen das generische Paket für unsere Version, wie wir es in den vorherigen Schritten getan haben, wählen wir für diesen Fall das 64-Bit-Paket.

VERGRÖSSERN

4- Sobald die vorherige Datei abgerufen wurde, entpacken wir sie in einen Ordner und führen die entsprechende Installation durch.
5- Schließlich müssen wir das Zertifikat installieren SSL, dieser Schritt ist sehr wichtig und wir sollten ihn nicht überspringen, dafür gehen wir auf die folgende Webseite, dort werden wir die Datei herunterladen cacert.pem und wir werden es dorthin kopieren, wo wir es installieren cURL Im vorherigen Schritt haben wir es schließlich umbenannt in curl-ca-bundle.crt.
6- Wir öffnen eine Konsole mit cmd und wir gehen zu dem Ordner, in dem wir haben Locken und das vorherige Zertifikat und wir führen aus curl.exe --help um die verschiedenen verfügbaren Befehle anzuzeigen. Damit haben wir schon cURL auf unserem Computer installiert.
Aufbau unserer ersten Verbindung mit CouchDB
Da wir das Kommunikationstool mit dem Service haben und theoretisch müssen wir vorbereitet sein CouchDB, jetzt werden wir testen, ob wir eine Verbindung herstellen können, dafür in der Konsole, wo wir haben Locken wir werden folgendes ausführen:

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

Die erste Option funktioniert für uns Linux und der zweite in Fenster, da sich nur die ändert .exe am Ende des Befehls und da wir das Tutorial unter Windows erstellen, werden wir das zweite für die restlichen Beispiele beibehalten. Beim Ausführen der vorherigen Anweisung wird der Server CouchDB Sie müssen antworten, indem Sie uns eine Nachricht mit der Version davon zeigen.

Dies zeigt an, dass wir bereits Zugriff auf . haben CouchDB und wir können damit beginnen, die verschiedenen Sammlungen von Dokumenten, die wir haben, zu manipulieren oder neue zu erstellen, wenn wir dies wünschen.
Erstellen Sie eine Datenbank
Nach der Philosophie der Dienstleistung SICH AUSRUHEN Elementerstellung fällt auf die Methode HTTP-PUT, deshalb müssen wir, wenn wir eine Datenbank erstellen möchten, nur eine PUT-Anfrage senden von cURL und damit können wir das Ziel erreichen, dafür können wir Folgendes ausführen:

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

Was ist nach der Adresse von CouchDB ist der Name, den unser Datenbank Dies sollte uns ein Ergebnis wie das folgende geben:

Wir haben ein Problem, da unsere Installation einen Administrator-Benutzer hat, können wir keinen freien Zugriff haben, aber das ist kein Problem, wir müssen nur den Benutzernamen und das Passwort in der Verbindung wie folgt übergeben:

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

Nachdem wir dies wissen, wiederholen wir den Befehl mit den erforderlichen Einstellungen:

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

Jetzt sehen wir, dass eine OK-Meldung bedeutet, dass der Vorgang korrekt abgeschlossen wurde:

Wenn wir versuchen, die Aktion zu wiederholen, erhalten wir einen Fehler, da CouchDB überprüft, ob die Datenbank bereits vorhanden ist:

Wenn wir den Inhalt unserer Datenbank wir müssen nur die Methode ändern STELLEN von BEKOMMEN und wir können wichtige Informationen darüber validieren:

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

Das ist wirklich wertvoll, um uns zu informieren, was mit unserer Datenbank passiert, falls wir uns nicht sicher sind.
Erstellen Sie ein Dokument in der Datenbank
Jetzt kommen wir zum interessantesten Teil des Tutorials, da wir unsere Datenbank haben, werden wir sicherlich daran interessiert sein, etwas darin zu speichern, dafür müssen wir Dokumente einfügen. Die Dokumente in CouchDB sind unter der Struktur zusammengesetzt JSON, auf diese Weise müssen wir die Daten übermitteln, damit sie verarbeitet werden können.
In cURL Wir müssen nur den Header der Anfrage, die wir senden, erstellen und angeben, dass dies der Fall ist JSON, dann verraten wir euch die Route unserer Datenbank die wir erstellt haben, aber in diesem Fall mit der Methode POST, und schließlich übergeben wir Ihnen den Inhalt unseres neuen Dokuments.
Sehen wir uns den folgenden Code an, der es uns ermöglicht ein Dokument hinzufügen zu der Datenbank, die wir in der vorherigen Übung erstellt haben:

curl.exe -H "Inhaltstyp: Anwendung / json" -X POST http: //root:[email protected]:5984/db-test -d \ "{\" title \ ": \" First Document \ "}"

Beachten Sie, dass wir Escape-Bars für die doppelten Anführungszeichen innerhalb des JSON, dies würde uns eine OK-Nachricht geben, genau wie beim Erstellen unserer Datenbank:

Wenn wir die Antwort ok bemerkt haben, kam sie nicht allein, sie brachte uns auch andere Felder innerhalb der JSON eins entspricht gehen des Dokuments innerhalb der Datenbank und ein weiteres zur Rezension.
Nach id konsultieren
Der letzte Absatz des vorherigen Beispiels führt uns zu dieser neuen Übung, die darin besteht, ein Dokument von uns zu konsultieren Datenbank, dafür müssen wir einfach eine Anfrage stellen BEKOMMEN und übergeben Sie die Identifikationsnummer nach dem Namen der Datenbank, zum Beispiel:

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

Erinnern wir uns daran gehen sind in jedem Team unterschiedlich, da es ein hash eindeutig, sodass sie die ID entsprechend ihrer eigenen Abfrage eingeben müssen. Dies führt am Ende zu folgendem Ergebnis, wie wir im folgenden Bild sehen können:

Löschen Sie die Datenbank
Die letzte Methode, die wir nicht gesehen haben, ist die von LÖSCHEN, dies, wie der Name schon sagt, ermöglicht es uns, Ressourcen zu eliminieren, es ist sehr mächtig, da es von unserem Server extrahiert, was mit den Suchparametern desselben übereinstimmt.
Lass uns die löschen Datenbank die wir erstellt haben, um zu demonstrieren, wie wir es verwenden können, müssen wir einfach den folgenden Befehl verwenden:

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

Dies wird beseitigen Datenbank Lassen Sie uns zusammen mit all Ihren Dokumenten, also müssen wir bei dieser Methode vorsichtig sein, sehen, wie das Ergebnis ist:

Wenn wir die Suche wiederholen über BEKOMMEN Auf die gleiche Weise wie in der ersten Übung des Tutorials werden wir sehen, dass wir kein Ergebnis haben werden, einfach CouchDB Es wird uns mitteilen, dass es die Ressource nicht finden kann, wie wir in der folgenden Abbildung sehen:

Damit beenden wir dieses Tutorial, wir haben gesehen, wie wir das Tool installieren können cURL und machen damit direkte Interaktionen mit unserem Server CouchDB, diese Art der Handhabung hilft uns, mehr über den Prozess hinter dieser großartigen Engine von . zu verstehen Datenbank, und es zeigt uns auch, dass wir die Konsole verwenden können, ohne mit einer bestimmten Programmiersprache umgehen zu müssen.Hat dir dieses Tutorial gefallen und geholfen?Sie können den Autor belohnen, indem Sie diesen Knopf drücken, um ihm einen positiven Punkt zu geben