Acerca de la consulta de documentos en una recopilación

Puede buscar uno o más documentos en una recopilación mediante una especificación de filtro o Consulta por ejemplo (QBE).

Un QBE es un patrón expresado en JSON. Se utiliza para seleccionar, de una recopilación, los documentos JSON cuyo contenido coincide con él, lo que significa que la condición expresada por el patrón se evalúa como verdadera para el contenido solo de esos documentos. Para obtener más información sobre los QBE y cómo utilizarlos, consulte Visión general de los QBE de SODA en Introducción a Oracle AI Database Simple Oracle Document Access (SODA).

Para una recopilación específica, introduzca la cadena QBE en el editor de JSON. Por ejemplo, para seleccionar documentos cuyo nombre es Mary, introduzca {"name":"Mary"} y, a continuación, haga clic en Ejecutar consulta, como se muestra en la Figura 5-2. Los resultados de la consulta aparecen en el panel inferior derecho.

El editor ofrece una lista completa de comandos disponibles a través de la paleta de comandos. Para abrir la paleta de comandos, pulse Ctrl+Mayús+P. Para obtener una lista de las teclas de método abreviado del teclado, consulte Métodos abreviados del teclado.

Un error en la consulta se caracteriza por un punto rojo en el canal izquierdo y una línea de squiggle debajo del texto específico. Al pasar el mouse sobre él, aparece una ventana emergente que muestra posibles correcciones para resolver el error.

Puede definir las preferencias del editor mediante la opción Preferences (Preferencias) en la lista desplegable de usuario superior derecha de la cabecera. Algunas de las opciones disponibles son Theme (Light, Dark y High contrast dark), Font size and family, Tab size, Word wrap, Ruler, Line numbers, etc.

Los iconos sobre el editor son:

• Formato de datos JSON : activa la sangría y las fuentes de línea para la cadena QBE.

• Agregar cláusula: agrega una plantilla con formato de la cláusula $orderby o $patch a la cadena QBE.

• Borrar : borra la cadena de QBE actual.

• Historial : recupera cadenas de búsqueda de QBE anteriores.

Figura 5-2 Cadena QBE en Editor JSON

Descripción de la "Figura 5-2 Cadena QBE en Editor JSON"

La expresión QBE debe ser un objeto JSON válido y puede contener cláusulas $query y $orderby o $patch. La expresión QBE se trata como una cláusula $query si no hay cláusulas definidas. A partir de la cláusula $query, agregue la cláusula $orderby o $patch más tarde mediante la lista Agregar cláusula. El contenido se transforma y se proporciona una plantilla para las cláusulas $orderby y $patch. Debe definir los valores correctos en las plantillas. Consulte Uso de la función Autocompletar en contexto en el editor de JSON

Por ejemplo, se trata de una consulta de filtrado simple:

Descripción de la ilustración simple_query.png

Después de agregar la cláusula $orderby mediante la cláusula Add, verá la siguiente entrada:

Descripción de la ilustración orderby_clause.png

Después de agregar la cláusula $patch, la consulta cambia a:

Descripción de la ilustración patch_clause.png

• Uso de la función Autocompletar en contexto en el editor de JSON
  Si pulsa Ctrl+Espacio, el editor le proporciona una lista de opciones adaptada al contexto desde la que puede seleccionar y autocompletar en el punto de inserción.

Uso de la función Autocompletar en contexto en el editor de JSON

Si pulsa Ctrl+Espacio, el editor le proporciona una lista de opciones que tiene en cuenta el contexto, desde la que puede seleccionar y completar automáticamente en el punto de inserción.

Descripción de la ilustración json_code_completion.png

En la lista aparecen los siguientes tipos de información:

• Filtrar cláusulas de comparación

  Hay una plantilla disponible para cada cláusula y se inserta en la posición del cursor. Por ejemplo, al seleccionar la cláusula $between de la lista de finalización automática, verá la siguiente entrada en el editor:

  
  Descripción de la ilustración filter_clause.png

  donde age es el nombre de la propiedad y 49 y 70 son valores. Estos son parámetros que puede editar y aparecen resaltados. Puede escribir o utilizar la ayuda de autocompletar para editar el nombre de la propiedad. Pulse la tecla tabulador para desplazarse hasta el siguiente parámetro.

• Nombres de propiedades de documentos JSON en la recopilación

  Hay dos orígenes para nombres de propiedades de documentos JSON:

  • Si se crea un índice de búsqueda con soporte para la guía de datos, la guía de datos JSON del diccionario de base de datos se explora en busca de nombres de propiedades.

  • Se presentan los nombres de propiedades que se recopilan de los documentos vistos o editados. Es posible que los nombres de propiedad sean un subjuego del espacio de nombres completo.

  Según el tipo de propiedad, se inserta la plantilla relacionada y el cursor se coloca en el lugar esperado para la inserción. A continuación, se muestra una lista de tipos de propiedades, sus plantillas y la posición del cursor correspondiente para cada una:

  • Objecto

    "ShippingInstructions.Address": {
    <cursor_here>
    }

  • Matriz

    "LineItems": [<cursor_here>]

  • Cadena

    "LineItems[*].Part.Description": "<cursor_here>]"

  • Número

    "PONumber": 0

  • Booleano

    "site_admin": true

  Cuando el cursor se encuentra entre comillas dobles ("") y se activa la terminación automática, sólo se inserta el nombre de la propiedad sin plantillas ni comillas dobles adicionales.