Cómo trabajar con IBM Cloudant Query

Visión general

IBM Cloudant Query es un lenguaje de consulta flexible que permite recuperar documentos de una base de datos que se ajusten a un «selector», es decir, un objeto JSON que define los criterios de búsqueda.

Cómo funciona IBM Cloudant Query

Para utilizar IBM Cloudant Query, debe enviar consultas con formato JSON al punto final _find HTTP de una base de datos. El JSON contiene un selector que define la consulta en sí, junto con metadatos como el orden de clasificación que se utilizará al devolver los documentos. La sintaxis del selector se basa en el lenguaje de consulta MongoDB's y ofrece un amplio conjunto de operadores de consulta que pueden combinarse para realizar consultas complejas.

Empieza a aprender sobre consultas leyendo Sintaxis del selector.

Para garantizar que las consultas devuelvan los resultados rápidamente, las consultas a IBM Cloudant deben estar respaldadas por un índice secundario adecuado. Existen dos tipos de índices:

  1. Índices JSON (type=json, por defecto)- un conjunto de campos nominados del documento combinados para formar el espacio clave del índice. El selector y los parámetros de ordenación de una consulta deben coincidir con las claves de un índice para que éste se utilice al procesar la consulta.
  2. Índices de texto (type=text): conjunto de campos nominales del documento indexados por separado. Uno o varios de los campos indexados pueden combinarse en expresiones selectoras para extraer pequeños fragmentos de datos (hasta 200 documentos por consulta).

IBM Cloudant las consultas pueden actuar sobre toda la base de datos o, en el caso de las bases de datos particionadas, sobre una única partición.

Aprende a crear índices leyendo:

Cuándo utilizar IBM Cloudant Query

IBM Cloudant Query es ideal para:

  • Consultas operativas en las que el selector/clasificador de una consulta coincide con un índice predefinido de type=json.
  • Consultas ad hoc sobre uno o varios campos respaldadas por un índice type=text, para conjuntos de resultados pequeños.
  • Creación de índices parciales, en los que se utiliza un subconjunto de documentos para formar el índice y el selector/clasificador filtra aún más los datos indexados.

Cuándo no utilizar IBM Cloudant Query

Evitar la consulta de:

  • Agregación de datos. Utilice Vistas en su lugar.
  • Búsqueda de texto libre o comodín. Utilice Cloudant Search en su lugar.

Paginación

Utilice la paginación de marcadores para las consultas de sintaxis del selector. Para obtener detalles específicos y ejemplos, consulte el tema de la documentación de la API Paging on selector syntax queries.