Panoramica

IBM Cloudant Query è un linguaggio di interrogazione flessibile che consente di recuperare da un database i documenti che corrispondono a un "selettore", ovvero un oggetto JSON che definisce i criteri di ricerca.

Come funziona IBM Cloudant Query

Per utilizzare IBM Cloudant Query, si inviano query in formato JSON all'endpoint _find HTTP di un database. Il JSON contiene un selettore che definisce la query stessa, insieme a metadati come l'ordine da utilizzare per la restituzione dei documenti. La sintassi dei selettori è basata sul linguaggio di query MongoDB's e offre un ricco insieme di operatori di query che possono essere combinati per creare query complesse.

Iniziate a conoscere le query leggendo la sintassi dei selettori.

Per garantire una rapida restituzione dei risultati, le query di IBM Cloudant devono essere supportate da un indice secondario adeguato. Sono disponibili due tipi di indici:

1. Indici JSON (type=json, l'impostazione predefinita)- un insieme di campi nominati del documento combinati insieme per formare il keyspace dell'indice. I parametri del selettore e dell'ordinamento di una query devono corrispondere alle chiavi di un indice per essere utilizzati durante l'elaborazione della query.
2. Indici di testo (type=text)- un insieme di campi nominati del documento indicizzati separatamente. Uno o più campi indicizzati possono essere combinati in espressioni di selezione per estrarre piccole fette di dati (fino a 200 documenti per query).

IBM Cloudant le query possono agire sull'intero database o, nel caso di database partizionati, su una singola partizione.

Imparate a creare gli indici leggendo:

• Lavorare con gli indici JSON.
• Lavorare con gli indici di testo.
• Indici parziali.

Quando utilizzare IBM Cloudant Query

IBM Cloudant Query è ideale per:

• Query operative in cui il selettore/ordine di una query corrisponde a un indice type=json predefinito.
• Query ad hoc su uno o più campi supportati da un indice type=text, per piccoli insiemi di risultati.
• Creazione di indici parziali, in cui un sottoinsieme dei documenti viene utilizzato per formare l'indice e il selettore/ordinatore filtra ulteriormente i dati indicizzati.

Quando non utilizzare IBM Cloudant Query

Evitare la query per:

• Aggregazione dei dati. Utilizzare invece le viste.
• Ricerca a testo libero o con caratteri jolly. Utilizzate invece Cloudant Search.

Paginazione

Utilizzare la paginazione dei segnalibri per le query con sintassi dei selettori. Per dettagli ed esempi specifici, si veda l'argomento della documentazione API Paging on selector syntax queries.