couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Couchdb Wiki] Update of "ApiVueHttp" by BenoitC
Date Sun, 29 Jun 2008 12:58:38 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification.

The following page has been changed by BenoitC:
http://wiki.apache.org/couchdb/ApiVueHttp

------------------------------------------------------------------------------
  
  Voir ["Vues"] pour plus d'informations.
  
- == Creating Views ==
+ == Créer des vues ==
  
- To create a permanent view, the functions must first be saved into special ''design documents''.
The IDs of design documents must begin with ''_design/'' and have a special views attribute
that have a ''map'' member and an optional ''reduce'' member to hold the view functions. All
the views in one design document are indexed whenever any of them gets queried.
+ Pour créer une vue permanente, les fonctions doivent d'abord être sauvées dans des docummens
spéciaux appelés ''documents design''. L'ID de ces documents doit commmencer par ''_design/''
et ces documents doivent avoir des attributs spécifiques contenant un membre ''map'' et optionnellement
un membre ''reduce'' pour contenir les fonctions de vues. Toutes les vues dans un document
design sont indexées à chaque fois qu'elles sont interrogées.
  
- A design document that defines ''all'', ''by_lastname'', and ''total_purchases'' views might
look like this:
+ Un document design qui définit les vues ''all'', ''by_lastname'', et ''total_purchases''
peut ressembler à cela:
  
  {{{
  {
@@ -45, +45 @@

  }
  }}}
  
- The ''language'' property tells CouchDB the language of the view functions, which it uses
to select the appropriate ViewServer (as specified in your couch.ini file). The default is
to assume Javascript, so this property can be omitted for Javascript views.
+ La propriété ''language'' indique à CouchDB le langage des fonctions de vue, ce qui est
utilisé pour sélectionnner le ServeurDeVue approprié (définit dans le fichier couch.ini).
Par défaut CouchDB utilise Javascript, et cette propriété peut donc être omise pour les
vues Javascript.
  
- == Altering/Changing Views ==
+ == Modifier/Changer les Vues ==
  
- To change a view or multiple view just alter the document (see HttpDocumentApi) they are
stored in and save it as a new revision.
+ Pour changer une vue ou plusieurs vues, modifiez juste le document (voir ApiDocumentHttp)
où elles sont stockées et enregistrez une nouvelle révision.
  
- == Access/Query ==
+ == Accéder/Interroher ==
  
- Once this document is saved into a database, then the ''all'' view can be retrieved at the
URL:
+ Une fois que ce document est enregistré dans la bales, alors la vue ''all'' peut être
récupérée sur l'URL :
  
-   http://localhost:5984/database/_view/company/all
+   http://localhost:5984/ma_bd/_view/company/all
  
- Example:
+ Exemple :
  
  {{{
- GET /some_database/_view/company/all HTTP/1.0
+ GET /ma_bd/_view/company/all HTTP/1.0
  Date: Thu, 17 Aug 2006 05:39:28 +0000GMT
  }}}
  
- And will result in the following response:
+ Ce qui entraine la réponse suivant :
  
  {{{
   HTTP/1.1 200 OK
@@ -108, +108 @@

   }
  }}}
  
- == Ad Hoc Views ==
+ == Vues Ad Hoc ==
  
- One-off queries (eg. views you don't want to save in the CouchDB database) can be done via
the special view ''_temp_view'':
+ Les requêtes temporaires (ex. les vues que vous ne souhaitez pas enregistrer dans CouchDB)
peuvent être réalisées à travers la vue spéciale ''_temp_view'' :
  
  {{{
  POST /some_database/_temp_view  HTTP/1.0
@@ -124, +124 @@

  
  }}}
  
- Could result in the following response:
+ Pouvant entraîner la réponse suivante :
  
  {{{
  {
@@ -139, +139 @@

  }
  }}}
  
- == Querying Options ==
+ == Options de requêtes ==
  
- Columns can be a list of values, there is no set limit to the number of values or amount
of data that columns can hold.
+ Les colonnes peuvent être une suite de valeur, il n'y a pas de limites au nombre de valeurs
ou sur le volume des données que peuvent contenir les colonnes.
  
- The following URL query arguments are allowed:
+ Les options suivantes peuvent être passées à l'URL de la requête :
  
-   * key=keyvalue
+   * key=valeurdeclé
-   * startkey=keyvalue
+   * startkey=valeurdeclé
    * startkey_docid=docid
-   * endkey=keyvalue
+   * endkey=valeurdeclé
-   * count=max rows to return
+   * count=nombre de lignes maximum à retourner
    * update=false
    * descending=true
-   * skip=rows to skip
+   * skip=lignes à passer
  
- ''key'', ''startkey'', and ''endkey'' need to be properly JSON encoded values (for example,
startkey="string" for a string value).
+ ''key'', ''startkey'', et ''endkey''  doivent être des valeurs codées en JSON (par exemple,
startkey="chaine" pour une valeur de chaine(string)).
  
- If you specify ''?count=0'' you don't get any data, but all meta-data for this View. The
number of documents in this View for example. If ''count'' is specified as a negative number,
you will receive that many documents prior to the specified ''startkey''.
+ Si vous spécifiez ''?count=0'', vous ne récupererez pas les données mais les métadonnées
de cette vue. Le nombre de documents dans cette vue par exemple. Si ''count'' est renseigné
avec une valeur négative, vous recevrez autant de documents avant ''startkey''.
  
- The ''skip'' option should only be used with small values, as skipping a large range of
documents this way is inefficient (it scans the index from the startkey and then skips N elements,
but still needs to read all the index values to do that). For efficient paging use ''startkey''
and/or ''startkey_docid''.
+ le paramètre ''skip'' devrait être seulement utilisé pour un petit nombre de valeurs,
passer un grand nombre de documents de cette façon n'est pas efficient (il parcourt l'index
à partir de startkey et passe N documents mais nécessite quand même de lire tout l'index
pour le faire). Pour une pagination éfficiente, utilisez ''startkey'' et/ou ''startkey_docid''.
  
- The ''update'' option can be used for higher performance at the cost of possibly not seeing
the all latest data. If you set the ''update'' option to ''false'', CouchDB will not perform
any refreshing on the view that may be necessary.
+ L'option ''update'' peut être utilisée pour accroître les performances avec la possibilité
de ne pas récupérer les derniers enregistrements. Si vous mettez ''update'' à ''false'',
CouchDB ne mettra pas à jour la vue.
  
- View rows are sorted by the key; specifying ''descending=true'' will reverse their order.
Note that the ''descending'' option is applied before any key filtering, so you may need to
swap the values of the ''startkey'' and ''endkey'' options to get the expected results. The
sorting itself is described in ViewCollation.
+ Les lignes de la vue sont triées par clé, spécifier ''descending=true'' inversera l'ordre.
Attention l'option ''descending'' est appliquée avant tout filtrage des clés, vous pourrez
donc avoir besoin de déplacer les valeurs des options ''startkey'' et ''endkey'' pour récupérer
le résultat attendu. Le tri est décrit dans AssemblageVue.
  
- == Debugging Views ==
+ == Traquer un problème dans les vues ==
  
- When creating views, CouchDB will check the syntax of the submitted JSON, but the view functions
themselves will not be syntax checked by the Javascript interpreter. And if any one of the
view functions has a syntax error, none of the view functions in that design document will
execute. Perhaps test your functions in a temporary view before saving them in the database.
+ Lors de la création des vues, CouchDB vérifie la syntaxe JSON, mais la syntaxe des fonctions
de vue en elles mêmes n'est pas vérifiée par l'interpréteur Javascript. Si l'une des vues
possède des erreurs de syntaxes, aucune des autres fonctions dans le document design ne sera
exécutée. Mais vous pouvez tester vos fonctions dans une vue temporaire avant de les sauver
dans la base.
  
- As of r660140 there is a log function available in the views, which logs to the couch.log.
It can be helpful for debugging but hinders performance, so it should be used sparingly in
production systems.
+ Depuis la révision r660140, une fonction ''log'' est disponible dans les vues, qui enregistre
dans couch.log. Cela peut être utile pendant la résolution de problèmes mais peut coûter
en performances. C'est donc à utiliser avce parcimmonie sur un système en production.
  
  {{{
  {

Mime
View raw message