CouchDB
CouchDB ist ein OpenSource-Datenbank-System, das über eine REST-Schnittstelle gesteuert wird. Mit PouchDB gibt es eine Replikation im Browser, so dass offline weitergearbeitet werden kann.
Siehe
- den Definitive Guide
- die Suche nach Substrings mittels Indizes
- Design Patterns für PouchDB (gelten im Regelfall auch für CouchDB)
- Gefilterte Replikation zur Vermeidung zu hohen Datentransfervolumens
- PouchDB Authentication (Browser-Seite)
Einrichten eines Administrators
Zu Beginn kann jeder Nutzer in CouchDB alles ändern und lesen. Das nennt man die Admin Party. Diese kann durch Erzeugen eines Administrators zerstört werden.
curl -s -X PUT http://localhost:5984/_node/couchdb@localhost/_config/admins/admin -d '"admin_pw"'
Views
Um eine View "words", die einem Designdokument "_design/myDesignDoc" in der Datenbank "texts", hinterlegt ist, zu nutzen, ruft man sie folgendermaßen auf:
curl -X GET 'http://localhost:5984/texts/_design/myDesignDoc/_view/words?startkey="Man"&endkey="Manz"' | python -m json.tool
Damit erhält man mehrere Datensätze, die zuvor mit der emit()-Funktion erzeugt wurden. Will man nur Treffer für einen bestimmten Schlüssel, ersetzt man die startkey und endkey durch ein einzelnes key=SUCHWORT
.
Will man sich die Ausgangsdokumente gleich mit anzeigen lassen, nimmt man den zusätzlichen Parameter include_docs=true
.[1]
PouchDB
Bei einer Replikation von CouchDB zu PouchDB ist die retry
-Option wichtig, um das Abbrechen der Replikation zu vermeiden. Beispiel:
var localdb=new PouchDB("mylocalDB"); var remoteDB=new PouchDB("http://www.example.com:5984/couchdb/myremoteDB"); localdb.replicate.from(remoteDB,{ retry:true }) .on('complete', function() { status("Replication completed."); }).on('error', function(err) { status("an Error occured: "+err); ergebnis(err); }).on('change', function(change) { counter++; status("Change #"+counter+": "+change); });
Fehlerbehebung
Unter Linux Mint 18 gab es nach dem Upgrade auf Version 2.1.1-1~xenial von CouchDB folgenden Fehler ("internal_server_error"): No DB shards could be opened..
Abhilfe schaffte ein Downgrade auf Version 2.1.0~xenial. Dazu geht man in der Beschreibung des Pakets couchdb
in aptitude
ganz nach unten. Hier werden die möglichen Versionen angezeigt, die dann wie Pakete installiert werden können. Mit der Taste F bei Version 2.1.1-1~xenial kann dann noch verhindert werden, dass bei einer normalen Aktualisierung dieses Paket wieder mitinstalliert wird.
Produkte auf Basis von CouchDB
- Hoodie - Offline-First
- Cloudant-Service von IBM