Présentation

IBM Cloudant Query est un langage de requête flexible qui permet d'extraire d'une base de données les documents correspondant à un « sélecteur » — un objet JSON qui définit les critères de recherche.

Comment fonctionne IBM Cloudant Query

Pour utiliser IBM Cloudant Query, vous envoyez des requêtes au format JSON au point de terminaison _find HTTP d'une base de données. Le JSON contient un sélecteur qui définit la requête elle-même, ainsi que des métadonnées telles que l'ordre de tri à utiliser pour renvoyer les documents. La syntaxe du sélecteur est librement basée sur le langage de requête MongoDB's, offrant un riche ensemble d'opérateurs de requête qui peuvent être combinés pour créer des requêtes complexes.

Commencez à vous familiariser avec les requêtes en lisant la syntaxe des sélecteurs.

Pour s'assurer que les requêtes renvoient rapidement des résultats, les requêtes IBM Cloudant doivent être soutenues par un index secondaire approprié. Il existe deux types d'index :

1. Index JSON (type=json, par défaut)- un ensemble de champs de documents nommés combinés ensemble pour former l'espace-clé de l'index. Le sélecteur et les paramètres de tri d'une requête doivent correspondre aux clés d'un index pour que celui-ci soit utilisé lors du traitement de la requête.
2. Index de texte (type=text)- un ensemble de champs de documents nominés indexés séparément. Un ou plusieurs des champs indexés peuvent être combinés dans des expressions de sélection pour extraire de petites tranches de données (jusqu'à 200 documents par requête).

IBM Cloudant les requêtes peuvent porter sur l'ensemble de la base de données ou, pour les bases de données partitionnées, sur une seule partition.

Apprenez à créer des index en lisant ce qui suit :

• Travailler avec des index JSON.
• Travailler avec des index de texte.
• Index partiels.

Quand utiliser IBM Cloudant Query

IBM Cloudant La requête est idéale pour :

• Requêtes opérationnelles lorsque le sélecteur/tri d'une requête correspond à un index type=json prédéfini.
• Requêtes ad hoc sur un ou plusieurs champs soutenues par un index type=text, pour de petits ensembles de résultats.
• Création d'index partiels, où un sous-ensemble des documents est utilisé pour former l'index et où le sélecteur/tri filtre davantage les données indexées.

Quand ne pas utiliser IBM Cloudant Query

Éviter les requêtes pour :

• Agrégation de données. Utilisez plutôt Views.
• Recherche en texte libre ou par caractères génériques. Utilisez plutôt Cloudant Search.

Pagination

Utiliser la pagination des signets pour les requêtes de syntaxe des sélecteurs. Pour plus de détails et d'exemples, voir la rubrique de la documentation de l'API intitulée Paging on selector syntax queries(pagination sur les requêtes de syntaxe de sélecteur).