Como Usar a Sintaxe de Consulta Avançada Programaticamente

Sintaxe de consulta avançada (AQS) é a sintaxe de consulta padrão usada pelo Windows Search para consultar o índice e para refinar e restringir os parâmetros de pesquisa. A AQS é empregada por desenvolvedores para criar consultas de forma programática (e por usuários para restringir seus parâmetros de pesquisa). A AQS canônica foi introduzida no Windows 7 e deve ser usada no Windows 7 e posterior para gerar consultas AQS programaticamente.

Este tópico é organizado da seguinte maneira:

• Sobre a sintaxe de consulta avançada
  • Exemplos
  • Propriedades
• Uso de palavras-chave em idiomas locais
• Sintaxe de consulta avançada canônica no Windows 7
  • Exemplos
  • Operadores de Consulta
  • Valores de consulta
• Restrições de escopo
• Recursos adicionais
• Tópicos relacionados

Sobre a sintaxe de consulta avançada

Uma consulta consiste em consultas básicas conectadas com AND, OR e NOT, conforme mostrado no exemplo de sintaxe a seguir:

<query> ::=
     <basic query>
| ( <query> )
| <query> AND <query>  
| <query> <query>    // Same as <query> AND <query>
| <query> OR <query> 
| NOT <query>

Se uma consulta tiver dois ou mais usos de AND ou OR, eles serão vinculados da esquerda para a direita, independentemente de ser AND ou OR. Ou seja, a consulta "maçã E pera OR ameixa" será interpretada como se estivesse escrita como "(maçã AND pera) OR ameixa", e a consulta "maçã OR pera AND ameixa" será interpretada como se fossem escritos como "(maçã OR pera) AND ameixa". Portanto, se um documento contém a palavra ameixa, mas não contém maçã nem pera, a primeira consulta a retornará, mas a segunda consulta não. Portanto, recomendamos que você use parênteses explícitos para qualquer consulta que misture AND e OR para evitar erros ou interpretações errôneas.

Uma consulta básica procura itens que satisfaçam uma restrição sobre uma propriedade. A única parte obrigatória de uma consulta básica é a restrição ou valor de pesquisa. Se você não especificar uma propriedade, o Windows Search pesquisará todas as propriedades. <restr> representa a restrição de pesquisa.

Os seguintes formulários para uma consulta básica são válidos:

<basic query> ::=
     <prop>:<basic restr>
| <restr>

Uma propriedade é designada por uma palavra-chave como autor ou tamanho, ou por um nome de propriedade canônico como System.DateModified. Os formulários válidos para uma propriedade são os seguintes:

<prop> ::= 
     <canonical property name>
| <property label in UI language>

Um operador indica uma operação como < ou =. Para obter uma lista de operadores válidos, consulte a seção Operadores de consulta posteriormente neste tópico.

Uma restrição básica é uma restrição simples a uma propriedade que pode ser escrita sem parênteses:

<basic restr> ::=
     <value>
| <op><value>
| NOT <basic restr>
| ( <restr> )

Uma restrição é um valor de pesquisa, como um valor numérico ou um valor de cadeia de caracteres, opcionalmente com um operador. Os formulários válidos para uma restrição são os seguintes:

<restr> ::=
    <basic restr>
| <restr> AND <restr>
| <restr> <restr>      // Same as <restr> AND <restr>
| <restr> OR <restr>

Se você não especificar um operador, o Windows Search escolherá o operador mais apropriado para sua consulta:

• Para uma propriedade de cadeia de caracteres, o operador COP_WORD_STARTSWITH $< é assumido.
• Para todas as outras propriedades, o operador COP_EQUAL = é assumido.

Para o uso programático do AQS, recomendamos que você tenha sempre um operador explícito. A forma válida para pesquisar um valor simples ou intervalo de valores é a seguinte:

<value> ::=
    <simplevalue>
| <simplevalue> .. <simplevalue>

Um valor simples pode consistir em qualquer um dos seguintes tipos:

<simplevalue> ::=
  []         // No value, or a null value
| <word>     // A sequence of characters without whitespace
| <number>   // An integer or a floating point number
| <datetime> // A relative date, or an absolute date and/or time
| <Boolean>
| "..."      // A phrase
| <enumeration range>

Exemplos

Uma consulta que busca um documento contendo a fase “último trimestre”, de autoria de Theresa ou Lee, e que foi salvo na pasta MeusDocs, combina três consultas básicas da seguinte forma:

"last quarter" author:(theresa OR lee) folder:MyDocs

As três consultas básicas são:

• "último trimestre"
• author:(theresa OR lee)
• folder:MyDocs

Uma consulta básica que usa sintaxe canônica é:

System.Size:>1kb

Propriedades

As propriedades são referidas por uma palavra-chave, que pode ser um nome de propriedade canônico no Windows 7 e posterior. AQS na UI do Windows pode usar o rótulo em vez do nome da propriedade canônica, como autor em vez de System.Author. No Windows Vista e versões anteriores, era possível usar rótulos em inglês, independentemente do idioma da interface do usuário. No Windows 7 e posterior, o Windows Search reconhece palavras-chave apenas no idioma da interface do usuário padrão atual.

Suporte para propriedades personalizadas

No Windows Vista e versões anteriores, as propriedades personalizadas não estavam disponíveis no AQS. No Windows 7 e posterior, a AQS funciona com propriedades personalizadas registradas no sistema de propriedades. Para obter mais informações sobre como criar propriedades personalizadas, consulte Sistema de propriedades.

Propriedades DateTime no Windows 8

A partir do Windows 8, as propriedades DateTime (como System.DateModified) suportam o formato canônico de data e hora especificado por ISO-8601, incluindo opcionalmente o fuso horário UTC.

• Windows 8 e versões anteriores, data e hora sem fuso horário UTC: YYYY-MM-DDThh:mm:ss

  Este formato especifica uma hora local, independentemente da localidade do usuário ou do sistema.

• Windows 8, data e hora com fuso horário UTC: YYYY-MM-DDThh:mm:ssTZD

  Este formato especifica uma hora no fuso horário UTC especificado.

Uso de palavras-chave em idiomas locais

No Windows 7 e posterior, as palavras-chave mnemônicas funcionam apenas no idioma do sistema, como as palavras-chave em alemão somente em um sistema operacional alemão e as palavras-chave em inglês apenas em um sistema operacional em inglês. System.Author é uma palavra-chave canônica e o valor mnemônico da propriedade System.Author é Autor, por exemplo. A introdução de palavras-chave canônicas compensa o fato de que as palavras-chave mnemônicas em inglês não são mais reconhecidas universalmente em todos os sistemas operacionais, independentemente do idioma, como acontecia no Windows Vista e versões anteriores.

Sintaxe de consulta avançada canônica no Windows 7

A sintaxe canônica foi introduzida para palavras-chave no Windows 7. Um exemplo de consulta com propriedade canônica é System.Message.FromAddress:=me@microsoft.com. Ao codificar consultas em aplicativos em execução no Windows 7 e posterior, você deve usar a sintaxe canônica para gerar consultas AQS programaticamente. Se você não usar sintaxe canônica e seu aplicativo for implementado em um código de idioma ou idioma da interface do usuário diferente do idioma no código do aplicativo, suas consultas não serão interpretadas corretamente.

As convenções para sintaxe de palavras-chave canônicas são as seguintes:

• A sintaxe canônica de uma propriedade é seu nome canônico, como System.Photo.LightSource. Os nomes canônicos não diferenciam maiúsculas de minúsculas.
• A sintaxe canônica para os operadores booleanos consiste nas palavras-chave AND, OR e NOT, todas em letras maiúsculas.
• Os operadores <, >, = e assim por diante não estão localizados e, portanto, também fazem parte da sintaxe canônica.
• Se uma propriedade P tiver valores ou intervalos enumerados denominados N₁ a Nₖ, a sintaxe canônica para o I I-ésimo valor ou intervalo é o nome canônico de P, seguido pelo caractere #, seguido por N_I, conforme ilustrado no exemplo a seguir:
  • System.Photo.LightSource#Daylight, System.Photo.LightSource#StandardA e assim por diante.
• Para um tipo semântico definido T com valores ou intervalos denominados N₁ a Nₖ, a sintaxe canônica para o I-ésimo valor ou intervalo é o nome canônico para T, seguido pelo caractere #, seguido por N_I, conforme ilustrado no exemplo a seguir:
  • System.Devices.LaunchDeviceStageFromExplorer:=System.StructuredQueryType.Boolean#True
• Para valores literais, como palavras ou frases, a sintaxe canônica é igual à sintaxe regular. Exemplos de consultas com valores literais na sintaxe canônica são:
  • System.Author:sanjay
  • System.Keywords:"Animal"
  • System.FileCount:>100

Exemplos

A tabela a seguir mostra alguns exemplos de propriedades canônicas e a sintaxe para usá-las.

Para obter mais informações sobre propriedades canônicas e o sistema de propriedades em geral, consulte Propriedades do sistema. Como alternativa, consulte os arquivos de cabeçalho público.

Operadores de Consulta

Se uma propriedade, p, tiver vários valores para algum item, uma consulta AQS para p:<restr> devolve o item se <restr> for true para pelo menos um dos valores. (<restr> representa uma restrição.)

A sintaxe listada na tabela a seguir consiste em um operador, símbolo de operador, exemplo e descrição de exemplo. O operador e o símbolo podem ser usados ​​em qualquer idioma e incluídos em qualquer consulta. Não utilize os operadores COP_IMPLICIT or COP_APPLICATION_SPECIFIC. Alguns dos operadores possuem símbolos intercambiáveis.

¹ Colchetes vazios ([]) denotam "sem valor".

Para propriedades de cadeia de caracteres, a operação padrão é COP_WORD_STARTS_WITH ou COP_WORD_EQUAL.

Valores de consulta

Exemplos úteis de como os valores de consulta podem ser restringidos estão listados na tabela a seguir.

Restrições de escopo

Os usuários podem limitar o escopo de suas pesquisas a locais de pastas ou armazenamentos de dados específicos. Por exemplo, se você usa várias contas de email e deseja limitar uma consulta ao Microsoft Outlook ou ao Microsoft Outlook Express, você pode usar System.Search.Store:mapi ou System.Search.Store:oe respectivamente. A tabela a seguir mostra alguns exemplos de como restringir uma pesquisa por armazenamento de dados.

Recursos adicionais

• No Windows 7 e posterior, uma opção de menu de atalho pode estar disponível com base no atendimento de uma condição AQS. Para obter mais informações, consulte "Como obter comportamento dinâmico para verbos estáticos usando sintaxe de consulta avançada" em Como criar manipuladores de menu de contexto.
• As consultas AQS podem ser limitadas a tipos específicos de arquivos, conhecidos como tipos de arquivo. Para obter mais informações, consulte Tipos de arquivos e associações. Para documentação de referência de propriedade, consulte System.Kind e System.KindText.

Tópicos relacionados

Consulta do índice de maneira programática

Como Usar Abordagens SQL e AQS para Consultar o Índice

Como Consultar o Índice com ISearchQueryHelper

Como Consultar o Índice com o Protocolo search-ms

Como Consultar o Índice com a Sintaxe SQL do Windows Search