Consultando o índice com ISearchQueryHelper

Você pode usar a interface ISearchQueryHelper para consultar o índice. Essa interface é implementada como uma classe auxiliar para ISearchCatalogManager (e ISearchCatalogManager2) e é obtida chamando ISearchCatalogManager::GetQueryHelper. Essa interface permite que você:

• Obtenha uma cadeia de conexão OLE DB para se conectar ao banco de dados da Pesquisa do Windows.
• Converta consultas de usuário do AQS (Advanced Query Syntax) em SQL (Linguagem de Consulta Estruturada) do Windows Search.
• Especifique as restrições de consulta que podem ser expressas no SQL, mas não no AQS.

Este tópico é organizado da seguinte maneira:

• Introdução ao ISearchQueryHelper
• Usando o método GenerateSqlFromUserQuery
• Trabalhando com identificadores de localidade
• Trabalhando com propriedades e colunas
• Trabalhando com a expansão de termos de consulta
• Trabalhando com outros métodos ISearchQueryHelper
• tópicos relacionados

Introdução ao ISearchQueryHelper

Há algumas interfaces e métodos importantes que você deve estar ciente antes de começar a consultar programaticamente o Windows Search usando a interface ISearchQueryHelper . Em um alto nível, você precisa seguir estas etapas:

1. Instancie uma instância ISearchManager .

   // Create ISearchManager instance
   ISearchManager* pSearchManager;
   
   // Use library SearchSDK.lib for CLSID_CSearchManager.
   hr = CoCreateInstance(CLSID_CSearchManager, NULL, CLSCTX_LOCAL_SERVER, IID_PPV_ARGS(&pSearchManager));      
   

2. Obtenha uma instância de ISearchCatalogManager usando ISearchManager::GetCatalog. O nome do catálogo do sistema para a Pesquisa do Windows é SYSTEMINDEX.

   // Create ISearchCatalogManager instance 
   ISearchCatalogManager* pSearchCatalogManager;
   
   // Call ISearchManager::GetCatalog for "SystemIndex" to access the catalog to the ISearchCatalogManager
   hr = pSearchManager->GetCatalog(L"SystemIndex", &pSearchCatalogManager);
   
   

3. Obtenha uma instância de ISearchQueryHelper usando ISearchCatalogManager::GetQueryHelper.

   // Call ISearchCatalogManager::GetQueryHelper to get the ISearchQueryHelper interface
   ISearchQueryHelper* pQueryHelper;
   
   hr = pSearchCatalogManager->GetQueryHelper(&pQueryHelper);
   
   

4. Depois de ter uma instância do ISearchQueryHelper, você poderá obter a string de conexão usada para se conectar ao conector OLE DB do índice do Windows Search.

   // Call get_ConnectionString to get the OLE DB connection string
   LPWSTR pszConnectionString=NULL;
   
   hr = pQueryHelper->get_ConnectionString(&pszConnectionString);
   // NOTE: YOU MUST call CoTaskMemFree() on the string
   
   

Usando o método GenerateSqlFromUserQuery

O método ISearchQueryHelper::GenerateSQLFromUserQuery transforma a entrada do usuário em uma cadeia de caracteres de consulta SQL, que pode ser enviada para o provedor OLE DB para Pesquisa do Windows. Esse método converte a sintaxe de consulta avançada (AQS) ou a consulta NQS (Sintaxe de Consulta Natural) inserida pelo usuário no SQL e permite adicionar outros fragmentos SQL conforme necessário.

A cadeia de caracteres de consulta SQL é retornada no seguinte formulário:

SELECT <QuerySelectColumns> 
FROM <CatalogName that created query helper>
WHERE <Result of interpreting the user query passed into this function according to QuerySyntax>
      [ AND|OR <QueryWhereRestrictions> ]
    

Veja a seguir um exemplo da cadeia de caracteres SQL retornada da chamada GenerateSQLFromUserQuery("comput"):

SELECT "System.ItemUrl" 
FROM "SystemIndex" 
WHERE ((CONTAINS(*,'"comput*"',1033) RANK BY COERCION(Absolute, 1)) OR 
       (FREETEXT(("System.ItemNameDisplay":0.9, *:0.1), 'comput', 1033) AND CONTAINS(*,'"comput"',1033)))
ORDER BY "System.ItemUrl"

Trabalhando com identificadores de localidade

A localidade de conteúdo e a localidade da palavra-chave são LCID (identificadores de localidade) que ajudam o mecanismo de pesquisa a usar os separadores de palavras corretos identificando o idioma dos termos da consulta e o idioma das palavras-chave do AQS. Eles nem sempre são os mesmos LCIDs porque o Windows Search é oferecido em várias versões internacionais e também inclui pacotes MUI (Interface do Usuário Multilíngue) para mais idiomas. A localidade de conteúdo identifica a LCID para o idioma em que os usuários inseriram sua consulta de pesquisa, enquanto a localidade da palavra-chave identifica a LCID que o mecanismo de pesquisa usa ao analisar palavras-chave AQS (Sintaxe de Consulta Avançada).

Por exemplo, se você tiver a versão English-US sem pacotes MUI, a localidade do conteúdo e a localidade da palavra-chave serão 1033. Se você tiver a versão alemã sem pacotes MUI, a localidade do conteúdo e a localidade da palavra-chave serão 1031 (gr-gr). No entanto, se você tiver a versão em inglês com o pacote MUI romeno, a localidade de conteúdo será 2072 (ro) e a localidade da palavra-chave será 1033 (en-us).

Trabalhando com propriedades e colunas

Os itens são representados no repositório de propriedades como uma linha. Cada linha contém várias colunas que representam propriedades para esse item. Nem todos os itens terão um valor para uma determinada propriedade. Por exemplo, um arquivo de áudio normalmente não contém um valor para a propriedade System.Property.FromName, mas pode conter informações sobre o System.Music.Artist.

Com esses métodos, você acessa ou modifica a propriedade com uma cadeia de caracteres Unicode delimitada por vírgulas, terminada em nulo que especifica um ou mais nomes de coluna do repositório de propriedades: "System.Document.Author, System.Document.Title".

Trabalhando com ampliação de termos de consulta

Esse método permite a expansão de alguns termos de consulta com caracteres curinga, semelhante à expansão de expressão regular. A expansão de prefixo procura palavras com o mesmo prefixo (fun/funil). Se não for definido, o valor padrão será SEARCH_TERM_PREFIX_ALL. Os valores suportados pela enumeração SEARCH_TERM_EXPANSION são os seguintes:

• SEARCH_TERM_PREFIX_ALL - Todos os termos de pesquisa são expandidos
• SEARCH_TERM_NO_EXPANSION - Nenhum termo de pesquisa é expandido

Trabalhando com outros métodos do ISearchQueryHelper

Muitos dos métodos na interface ISearchQueryHelper são usados para definir argumentos de consulta ou definir as propriedades retornadas.

Tópicos relacionados

Consultando o índice programaticamente

Usando abordagens SQL e AQS para consultar o índice

Consultando o índice com o protocolo search-ms

Consultando o índice com a sintaxe sql de pesquisa do Windows

Usando a sintaxe de consulta avançada programaticamente