Operationer i CouchDB med hjälp av cURL

Gör interaktioner med CouchDB det är väldigt enkelt när vi har tillgång till Futon och genom det grafiska gränssnittet kan vi börja skapa dokument och samlingar, men detta är bara funktionellt när vi har ett grafiskt eller webbgränssnitt. I andra miljöer kommer vi säkert att behöva ett gränssnitt genom en webb-service för att kunna bygga de strukturer som vi kommer att behöva.
Ett mycket enkelt sätt att ansluta på ett "icke-grafiskt" sätt är genom ringla eftersom vi med detta verktyg kan skicka förfrågningar enligt de olika metoderna HTTP vad som stöder CouchDB och vi kan också använda den för andra ändamål än användningen av CouchDB.
Krav
1- Vi behöver ha en funktionell installation av CouchDBFör de första stegen i det här verktyget kan du ange följande länk. Om vi ​​har etablerat administratörsanvändaren måste vi ha ditt användarnamn och lösenord.
2- En internetanslutning är nödvändig för att ladda ner kraven för installationen av ringla.
3- Vi kommer också att behöva ha behörigheter för att installera applikationer, eftersom det inte finns ringla du måste installera det.
Installera cURL på Linux
Om vi ​​använder system baserade på Linux Vad Ubuntu eller LinuxMint Installationen av ringla Det är så enkelt som att helt enkelt använda följande kommando från konsolen:

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

Detta kommer att ge oss alla nödvändiga verktyg för att kunna utföra ringla från vår kommandorad och därmed kunna interagera med CouchDB.
Installation de cURL på Windows
I Windows tyvärr är processen lite mer komplex för att kunna uppnå installationen av ringlaDet är dock inte en omöjlig uppgif.webpt, vi kommer att beskriva de steg som krävs för att uppnå detta mål innan vi interagerar med CouchDB.
1- Installera filerna Visual C ++ 2008 Y 2010 kallad omfördelningsbaraVi kan få dessa gratis och för 32-bitars och 64-bitars plattformar. I vårt fall kommer vi att använda 64-bitars plattformen i följande länk.

FÖRSTORA

2- Nästa akt måste vi installera versionen av OpenSSL motsvarande vårt system, för detta kan vi besöka följande webbplats där vi kommer att få paketet enligt vårt system antingen 64 bitar eller 32 bitar.

3- När vi har installerat förutsättningarna kommer vi nu att ladda ner och installera ringla För att göra detta går vi till följande länk och hämtar det generiska paketet för vår version, som vi har gjort i de föregående stegen, väljer vi 64-bitars paketet för det här fallet.

FÖRSTORA

4- När den tidigare filen har hämtats kommer vi att packa upp den i en mapp och göra motsvarande installation.
5- Slutligen måste vi installera certifikatet SSL, det här steget är mycket viktigt och vi bör inte hoppa över det, för detta går vi till följande webbsida, när vi väl kommer att ladda ner filen cacert.pem och vi ska kopiera det där vi installerar ringla i föregående steg bytte vi slutligen namn till det curl-ca-bundle.crt.
6- Vi öppnar en konsol med cmd och vi går till mappen där vi har ringla och det tidigare certifikatet och vi kör curl.exe --hjälp för att se de olika kommandona som finns. Med detta kommer vi redan att ha ringla installerad på vår dator.
Upprätta vår första anslutning till CouchDB
Eftersom vi har kommunikationsverktyget med tjänsten och i teorin måste vi ha förberett CouchDB, nu ska vi testa att vi kan ansluta, för detta i konsolen där vi har ringla vi kommer att utföra följande:

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

Det första alternativet fungerar för oss Linux och den andra i Windows, eftersom det enda som ändras är .exe i slutet av kommandot och eftersom vi bygger självstudien under Windows kommer vi att behålla den andra för resten av exemplen. Vid körning av föregående instruktion servern CouchDB Du måste svara genom att visa oss ett meddelande med versionen av det.

Detta indikerar att vi redan har tillgång till CouchDB och vi kan börja manipulera de olika samlingar av dokument som vi har eller skapa nya om vi vill.
Skapa en databas
Efter filosofin om tjänster RESTEN elementskapande faller på metoden HTTP PUT, det är därför som vi bara vill skicka en PUT -begäran från om vi vill skapa en databas ringla och därmed kan vi nå målet, för detta kan vi utföra följande:

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

Vad är efter adressen till CouchDB är namnet som vårt Databas detta borde ge oss ett resultat som följande:

Vi har ett problem, eftersom vår installation har en administratörsanvändare, vi kan inte ha fri åtkomst, men detta är inte ett problem, vi måste bara skicka användarnamnet och lösenordet i anslutningen enligt följande:

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

Efter att ha vetat detta kommer vi att fortsätta med att upprepa kommandot med de nödvändiga inställningarna:

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

Nu ser vi att om vi har ett ok -meddelande betyder det att operationen slutfördes korrekt:

Om vi ​​försöker upprepa åtgärden får vi ett felmeddelande sedan CouchDB kommer att verifiera att databasen redan finns:

Om vi ​​vill konsultera innehållet i vår Databas vi måste bara ändra metoden SÄTTA förbi SKAFFA SIG och vi kan validera viktig information om det:

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

Vilket verkligen är värdefullt för att informera oss om vad som händer med vår databas om vi inte är säkra.
Skapa ett dokument i databasen
Nu ska vi gå vidare till den mest intressanta delen av handledningen, eftersom vi har vår databas, vi kommer säkert att vara intresserade av att lagra något i den, för detta måste vi infoga dokument. Dokumenten i CouchDB är sammansatta under strukturen JSON, så det är på detta sätt som vi måste skicka data så att de kan behandlas.
I ringla Vi behöver bara etablera rubriken på den begäran som vi skickar och ange att det är det JSON, då ger vi dig vår rutt Databas som vi har skapat men i det här fallet med metoden POSTAoch slutligen ger vi dig innehållet i vårt nya dokument.
Låt oss se följande kod som tillåter oss lägg till ett dokument till databasen som vi skapade i föregående övning:

curl.exe -H “Innehållstyp: applikation /json” -X POST http: //root:[email protected]:5984/db-test -d \ “{\" title \ ": \" First Document \ "}"

Observera att vi har placerat flyktstänger för de dubbla citaten inuti JSON, detta skulle ge oss ett ok meddelande precis som när vi skapade vår databas:

Om vi ​​har märkt svaret ok så kom det inte ensamt, det gav oss också andra fält inom JSON en motsvarar gå av dokumentet i Databas och en annan till recensionen.
Rådfråga med id
Det sista stycket i föregående exempel tar oss till denna nya övning, som är att konsultera ett dokument av vår Databas, för detta måste vi helt enkelt göra en förfrågan SKAFFA SIG och skicka identifieringsnumret efter namnet på databasen, till exempel:

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

Låt oss komma ihåg det gå är olika i varje lag eftersom det är en hash unika så de måste sätta id som motsvarar deras egen fråga. Detta i slutändan kommer att ge oss följande resultat som vi kan se i följande bild:

Ta bort databasen
Den sista metoden som vi inte har sett är den RADERA, detta som namnet indikerar att det tillåter oss att eliminera resurser, det är mycket kraftfullt eftersom det kommer att extrahera från vår server vad som matchar sökparametern för samma.
Låt oss radera Databas som vi har skapat för att visa hur vi kan använda det, måste vi helt enkelt använda följande kommando:

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

Detta kommer att eliminera Databas Tillsammans med alla dina dokument, så vi måste vara försiktiga när vi använder den här metoden, låt oss se hur resultatet blir:

Om vi ​​upprepar sökningen via SKAFFA SIG På samma sätt som vi använde i den första övningen av handledningen kommer vi att se att vi inte kommer att få ett resultat, helt enkelt CouchDB Den kommer att berätta att den inte kan hitta resursen som vi ser i följande bild:

Med detta avslutar vi denna handledning, vi har sett hur vi kan installera verktyget ringla och med det göra direkta interaktioner med vår server CouchDB, den här typen av hantering hjälper oss att förstå mer om processen bakom denna fantastiska motor Databas, och det visar oss också att vi kan använda konsolen utan att behöva hantera ett visst programmeringsspråk.Gillade du och hjälpte denna handledning?Du kan belöna författaren genom att trycka på den här knappen för att ge honom en positiv poäng