Sobre a Consulta de Documentos em uma Coleção

Você pode procurar um ou mais documentos em uma coleção usando uma especificação de filtro ou QBE (Query-by-Example).

QBE é um padrão expresso em JSON. Você o usa para selecionar, em uma coleção, os documentos JSON cujo conteúdo corresponde a ele, o que significa que a condição expressa pelo padrão é avaliada como verdadeira apenas para o conteúdo desses documentos. Para obter mais informações sobre QBEs e como usá-los, consulte Visão Geral de QBEs SODA em Oracle AI Database Introduction to Simple Oracle Document Access (SODA).

Para uma coleção específica, informe a string QBE no editor JSON. Por exemplo, para selecionar documentos em que o nome é Mary, informe {"name":"Mary"} e clique em Executar Consulta, conforme mostrado na Figura 5-2. Os resultados da consulta são exibidos no painel inferior direito.

O editor oferece uma lista abrangente de comandos disponíveis por meio da Paleta de Comandos. Para abrir a Paleta de Comandos, pressione Ctrl+Shift+P. Para obter uma lista de teclas de atalho do teclado, consulte Keyboard Shortcuts.

Um erro na consulta é representado por um ponto vermelho na calha esquerda e uma linha de contrapeso abaixo do texto específico. Ao passar o mouse sobre ele, você verá um pop-up exibindo possíveis correções para resolver o erro.

Você pode definir preferências do editor usando a opção Preferências na lista drop-down do usuário superior direito no cabeçalho. Algumas das opções disponíveis são Tema (Luz, Escuro e Alto contraste escuro), Tamanho da fonte e família, Tamanho da guia, Quebra de palavras, Régua, Números de linha e assim por diante.

Os ícones acima do editor são:

• Formatar dados JSON : Permite recuo e feeds de linha para a string QBE.

• Adicionar Cláusula: Adiciona um modelo formatado da cláusula $orderby ou $patch à string QBE.

• Limpar : Limpa a string QBE atual.

• Histórico : Recupera strings de pesquisa QBE anteriores.

Figura 5-2 String QBE no Editor JSON

Descrição da "Figura 5-2 String QBE no Editor JSON"

A expressão QBE deve ser um objeto JSON válido e pode conter as cláusulas $query e $orderby ou $patch. A expressão QBE será tratada como uma cláusula $query se não houver cláusulas definidas. A partir da cláusula $query, adicione a cláusula $orderby ou $patch mais tarde usando a lista Adicionar Cláusula. O conteúdo é transformado e um modelo para a cláusula $orderby e $patch é fornecido. É necessário definir valores corretos nos modelos. Consulte Using the In-Context Autocomplete Feature no JSON Editor

Por exemplo, esta é uma consulta de filtragem simples:

Descrição da ilustração plain_query.png

Após a cláusula $orderby ser adicionada usando Adicionar Cláusula, você verá a seguinte entrada:

Descrição da ilustração orderby_clause.png

Após a cláusula $patch ser adicionada, a consulta é alterada para:

Descrição da ilustração patch_clause.png

• Usando o Recurso de Preenchimento Automático no Contexto no Editor JSON
  Se você pressionar Ctrl+Space, o editor fornecerá uma lista de opções com reconhecimento de contexto na qual você poderá selecionar e preencher automaticamente no ponto de inserção.

Usando o Recurso In-Context Autocomplete no Editor JSON

Se você pressionar Ctrl+Space, o editor fornecerá uma lista de opções com reconhecimento de contexto na qual você poderá selecionar e preencher automaticamente o ponto de inserção.

Descrição da ilustração json_code_completion.png

Os seguintes tipos de informações são exibidos na lista:

• Cláusulas de comparação do filtro

  Um modelo está disponível para cada cláusula e é inserido na posição do cursor. Por exemplo, quando você seleciona a cláusula $between na lista de preenchimento automático, você vê a seguinte entrada no editor:

  
  Descrição da ilustração filter_clause.png

  em que age é o nome da propriedade e 49 e 70 são valores. Esses são parâmetros que você pode editar e aparecem destacados. Você pode digitar ou usar a ajuda de preenchimento automático para editar o nome da propriedade. Pressione a tecla Tab para ir para o próximo parâmetro.

• Nomes de propriedades de documentos JSON na coleção

  Há duas origens para nomes de propriedades de documentos JSON:

  • Se um índice de pesquisa for criado com suporte para o guia de dados, o guia de dados JSON do dicionário de banco de dados será verificado em busca de nomes de propriedades.

  • Os nomes de propriedades que são coletados de documentos visualizados ou editados são apresentados. É possível que os nomes das propriedades sejam um subconjunto de todo o namespace.

  Com base no tipo de propriedade, o modelo relacionado é inserido e o cursor é posicionado no local esperado para inserção. Veja a seguir uma lista de tipos de propriedade, seus modelos e a posição do cursor correspondente para cada um deles:

  • Objeto

    "ShippingInstructions.Address": {
    <cursor_here>
    }

  • Array

    "LineItems": [<cursor_here>]

  • String

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

  • Número

    "PONumber": 0

  • Booliano

    "site_admin": true

  Quando o cursor estiver entre aspas duplas ("") e o preenchimento automático estiver ativado, somente o nome da propriedade será inserido sem modelos ou aspas duplas adicionais.