Operacje w CouchDB przy użyciu cURL

Nawiązuj interakcje z CouchDB to bardzo proste, gdy mamy dostęp do Futon a poprzez interfejs graficzny możemy rozpocząć tworzenie dokumentów i zbiorów, jednak działa to tylko wtedy, gdy mamy dostęp do interfejsu graficznego lub internetowego. W innych środowiskach z pewnością będziemy potrzebować interfejsu poprzez a Serwis internetowy aby móc budować struktury, których będziemy potrzebować.
Bardzo prosty sposób na połączenie w „niegraficzny” sposób to przejście kędzior ponieważ za pomocą tego narzędzia możemy wysyłać żądania różnymi metodami HTTP co wspiera CouchDB i możemy go również używać do innych celów niż korzystanie z CouchDB.
Wymagania
1- Potrzebujemy sprawnej instalacji CouchDBW przypadku pierwszych kroków w tym narzędziu możesz wejść w poniższy link, jeśli ustanowiliśmy użytkownika administratora, musimy mieć twoją nazwę użytkownika i hasło.
2- Połączenie internetowe jest niezbędne do pobrania wymagań dotyczących instalacji kędzior.
3- Będziemy potrzebować również uprawnień do instalowania aplikacji, ponieważ w przypadku ich braku kędzior musisz go zainstalować.
Instalowanie cURL w systemie Linux
Jeśli korzystamy z systemów opartych na Linux Co Ubuntu lub LinuxMint Instalacja kędzior To tak proste, jak użycie następującego polecenia z konsoli:

sudo apt-get aktualizacje sudo apt-get zainstaluj curl libcurl3 libcurl3-dev php5-curl

To da nam wszystkie niezbędne narzędzia do wykonania kędzior z naszego wiersza poleceń, a tym samym móc wchodzić w interakcje z CouchDB.
Instalacja de cURL w systemie Windows
w Okna niestety proces jest nieco bardziej złożony, aby można było osiągnąć instalację kędziorNie jest to jednak zadanie niemożliwe, przed przystąpieniem do interakcji opiszemy kroki niezbędne do osiągnięcia tego celu CouchDB.
1- Zainstaluj pliki Wizualny C++ 2008 Tak 2010 zwany redystrybucyjneMożemy je otrzymać za darmo i na platformy 32-bitowe i 64-bitowe. W naszym przypadku użyjemy platformy 64-bitowej w poniższym linku.

POWIĘKSZAĆ

2- Następny akt musimy zainstalować wersję OpenSSL odpowiadający naszemu systemowi, w tym celu możemy odwiedzić następującą stronę internetową, na której otrzymamy pakiet zgodny z naszym systemem 64-bitowym lub 32-bitowym.

3- Po zainstalowaniu wymagań wstępnych zaczniemy pobierać i instalować kędzior Aby to zrobić, przejdziemy do poniższego linku i uzyskamy pakiet ogólny dla naszej wersji, tak jak robiliśmy to w poprzednich krokach, w tym przypadku wybierzemy pakiet 64-bitowy.

POWIĘKSZAĆ

4- Po uzyskaniu poprzedniego pliku rozpakujemy go do folderu i przeprowadzimy odpowiednią instalację.
5- Na koniec musimy zainstalować certyfikat SSL, ten krok jest bardzo ważny i nie powinniśmy go pomijać, w tym celu przechodzimy na następną stronę internetową, gdy tam będziemy pobierać plik cacert.pem i skopiujemy go tam, gdzie zainstalujemy kędzior w poprzednim kroku w końcu zmieniliśmy jego nazwę na curl-ca-bundle.crt.
6- Otwieramy konsolę za pomocą cmd i przechodzimy do folderu, w którym mamy kędzior a poprzedni certyfikat i wykonujemy curl.exe --pomoc aby zobaczyć różne dostępne polecenia. Dzięki temu już będziemy mieli kędzior zainstalowany na naszym komputerze.
Nawiązanie pierwszego połączenia z CouchDB
Skoro mamy narzędzie do komunikacji z serwisem i teoretycznie musieliśmy się przygotować CouchDB, teraz zamierzamy przetestować, że możemy się połączyć, do tego w konsoli, w której mamy kędzior zamierzamy wykonać następujące czynności:

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

Pierwsza opcja działa dla nas Linux a drugi w Okna, ponieważ jedyną rzeczą, która się zmienia, jest .exe na końcu polecenia, a ponieważ budujemy samouczek w systemie Windows, drugi zostanie zachowany przez resztę przykładów. Podczas wykonywania poprzedniej instrukcji serwer CouchDB Musisz odpowiedzieć, pokazując nam wiadomość z wersją.

Oznacza to, że mamy już dostęp do CouchDB i możemy zacząć manipulować różnymi zbiorami dokumentów, które posiadamy lub tworzyć nowe, jeśli chcemy.
Utwórz bazę danych
Podążając za filozofią usług ODPOCZYNEK tworzenie elementu przypada na metodę HTTP PUT, dlatego jeśli chcemy stworzyć Bazę Danych, wystarczy wysłać żądanie PUT z kędzior a tym samym możemy osiągnąć cel, w tym celu możemy wykonać następujące czynności:

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

Co jest po adresie CouchDB to imię, które nasz Baza danych powinno to dać nam wynik podobny do następującego:

Mamy problem, ponieważ nasza instalacja ma administratora, nie możemy mieć wolnego dostępu, ale to nie problem, wystarczy podać nazwę użytkownika i hasło w połączeniu w następujący sposób:

http://użytkownik:hasł[email protected]:5984/

Po zapoznaniu się z tym przystąpimy do powtarzania polecenia z niezbędnymi ustawieniami:

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

Teraz widzimy, że jeśli mamy komunikat ok, oznacza to, że operacja została zakończona poprawnie:

Jeśli spróbujemy powtórzyć czynność, otrzymamy błąd, ponieważ CouchDB sprawdzi, czy Baza danych już istnieje:

Jeśli chcemy zapoznać się z treścią naszego Baza danych musimy tylko zmienić metodę UMIEŚCIĆ za pomocą DOSTWAĆ i możemy zweryfikować ważne informacje na ten temat:

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

Co jest naprawdę cenne, aby poinformować nas, co dzieje się z naszą bazą danych, na wypadek, gdybyśmy nie byli pewni.
Utwórz dokument w bazie danych
Teraz przejdziemy do najciekawszej części samouczka, ponieważ mamy już naszą Bazę Danych, na pewno będziemy zainteresowani przechowywaniem czegoś w niej, do tego musimy wstawić dokumenty. Dokumenty w CouchDB składają się pod strukturę JSON, a więc w ten sposób musimy przesyłać dane, aby można je było przetwarzać.
w kędzior Musimy tylko ustalić nagłówek żądania, które wysyłamy i wskazać, że jest JSON, następnie podajemy trasę naszego Baza danych które stworzyliśmy, ale w tym przypadku za pomocą metody POCZTA, a na koniec przekazujemy Ci treść naszego nowego dokumentu.
Zobaczmy następujący kod, który nam pozwala dodaj dokument do Bazy Danych, którą utworzyliśmy w poprzednim ćwiczeniu:

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

Zauważ, że umieściliśmy znaki escape dla podwójnych cudzysłowów wewnątrz JSON, to dałoby nam komunikat OK, tak jak podczas tworzenia naszej bazy danych:

Jeśli zauważyliśmy odpowiedź ok, nie pojawiła się ona sama, ale przyniosła nam również inne pola w ramach JSON jeden odpowiada iść dokumentu w ramach Baza danych i kolejny do przeglądu.
Skonsultuj się przez id
Ostatni akapit poprzedniego przykładu prowadzi nas do tego nowego ćwiczenia, które polega na zapoznaniu się z dokumentem naszego Baza danych, w tym celu wystarczy złożyć wniosek DOSTWAĆ oraz podać numer identyfikacyjny po nazwie Bazy Danych, na przykład:

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

Pamiętajmy o tym iść są różne w każdym zespole, ponieważ jest to haszysz unikatowe, więc muszą podać identyfikator odpowiadający ich zapytaniu. To w końcu da nam następujący wynik, jak widać na poniższym obrazku:

Usuń bazę danych
Ostatnią metodą, której nie widzieliśmy, jest metoda z KASOWAĆ, jak sama nazwa wskazuje, pozwala nam eliminować zasoby, jest bardzo potężny, ponieważ wydobywa z naszego serwera to, co pasuje do parametru wyszukiwania tego samego.
Wymażmy Baza danych które stworzyliśmy, aby zademonstrować, jak możemy z niego korzystać, musimy po prostu użyć następującego polecenia:

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

To wyeliminuje Baza danych Wraz ze wszystkimi Twoimi dokumentami, a więc musimy być ostrożni przy stosowaniu tej metody, zobaczmy, jaki jest wynik:

Jeśli powtórzymy wyszukiwanie przez DOSTWAĆ W ten sam sposób, w jaki użyliśmy w pierwszym ćwiczeniu samouczka, zobaczymy, że nie będziemy mieli wyniku, po prostu CouchDB Powie nam, że nie może znaleźć zasobu, jak widać na poniższym obrazku:

Na tym kończymy ten samouczek, widzieliśmy, jak możemy zainstalować narzędzie kędzior a dzięki niemu nawiązywać bezpośrednią interakcję z naszym serwerem CouchDB, ten rodzaj obsługi pomaga nam lepiej zrozumieć proces stojący za tym wspaniałym silnikiem Baza danych, a także pokazuje nam, że możemy korzystać z konsoli bez konieczności obsługi konkretnego języka programowania.Podobał Ci się i pomógł ten samouczek?Możesz nagrodzić autora, naciskając ten przycisk, aby dać mu pozytywny punkt