Table des matières

Base de données

Voici la référence de l'API HTTP de CouchDB en matière de base de données.

Convention de nommage

Le nom utilisé pour une base de données ne doit comporter que :

Les lettres majuscules ne sont pas autorisées (pour des raisons de compatibilité avec des systèmes de fichiers insensibles à la casse).

Remarque pour le / : Tous les fichiers de bases de données sont stockées dans un seul répertoire du système de fichier. Si le nom de votre base inclus un /, CouchDB créera un sous-répertoire. Ainsi une base nommée “mon-projet/base-1” sera stockée dans le fichier $repertoire-des-bases/mon-projet/base-1.couch ce qui peut être utile si vous avez un grand nombre de bases donc de fichiers dans le répertoire des bases et que le système de fichiers n'aime pas ça.

URL

Chaque base de donnée a une URL, utilisée pour les actions directes, de la forme :

http://votre_serveur:5984/votre-base-de-donnee/

Quand le caractère / est présent dans le nom de la base, il doit être encodé en %2F pour être utilisé dans une URL. Par exemple pour la base “mon-projet/base-1” :

http://votre_serveur:5984/mon-projet%2Fbase-1/

Accéder aux bases de données

La méthode la plus simple pour gérer ses différentes bases de données est l'interface Futon. Celle-ci est accessible via l'URL:

http://votre_serveur:5984/_utils

Vous pouvez par un simple clic créer une base de données et des documents.

L'accès à un document contenu dans une base de données peut être fait ainsi:

http://votre_serveur:5984/votre-base-de-donnee/votre-id-du-document

Créer des bases de données

Autres opérations

Supprimer une base de donnée

Compacter

Voir la page dédiée. (FIXME Ajouter lien)