Запрос индекса с помощью ISearchQueryHelper

Для запроса индекса можно использовать интерфейс ISearchQueryHelper . Этот интерфейс реализуется как вспомогательный класс для ISearchCatalogManager (и ISearchCatalogManager2) и получается путем вызова ISearchCatalogManager::GetQueryHelper. Этот интерфейс позволяет:

• Получите строку подключения OLE DB для подключения к базе данных Windows Search.
• Преобразуйте пользовательские запросы расширенного синтаксиса запросов (AQS) в windows Search язык SQL (SQL).
• Укажите ограничения запросов, которые могут быть выражены в SQL, но не в AQS.

Эта тема организована следующим образом:

• начало работы с ISearchQueryHelper
• Использование метода GenerateSqlFromUserQuery
• Работа с идентификаторами языкового стандарта
• Работа со свойствами и столбцами
• Работа с расширением терминов запроса
• Работа с другими методами ISearchQueryHelper
• Связанные темы

начало работы с ISearchQueryHelper

Существует несколько ключевых интерфейсов и методов, о которых следует помнить, прежде чем начать программный запрос к Поиску Windows с помощью интерфейса ISearchQueryHelper . В общих чертах необходимо выполнить следующие действия.

1. Создайте экземпляр 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. Получите экземпляр ISearchCatalogManager с помощью ISearchManager::GetCatalog. Имя системного каталога для Поиска 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. Получите экземпляр ISearchQueryHelper с помощью ISearchCatalogManager::GetQueryHelper.

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

4. После создания экземпляра ISearchQueryHelper можно получить строку подключения, используемую для подключения к соединителю OLE DB индекса 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
   
   

Использование метода GenerateSqlFromUserQuery

Метод ISearchQueryHelper::GenerateSQLFromUserQuery преобразует введенные пользователем данные в строку ЗАПРОСА SQL, которая затем может быть отправлена поставщику OLE DB для Поиска Windows. Этот метод преобразует запрос расширенного синтаксиса запросов (AQS) или естественного синтаксиса запросов (NQS), введенный пользователем, в SQL и позволяет добавлять другие фрагменты SQL при необходимости.

Строка SQL-запроса возвращается в следующей форме:

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> ]
    

Ниже приведен пример строки SQL, возвращаемой из вызова 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"

Работа с идентификаторами языкового стандарта

Языковой стандарт содержимого и ключевое слово языкового стандарта — это идентификаторы языкового стандарта (LCID), которые помогают поисковой системе использовать правильные средства разбиения по словам, определяя язык терминов запроса и язык ключевых слов AQS. Это не всегда одинаковые идентификаторы LCID, так как Поиск Windows предлагается в ряде международных версий, а также включает пакеты многоязыкового пользовательского интерфейса (MUI) для большего числа языков. Языковой стандарт содержимого определяет LCID для языка, в который пользователи вводят поисковый запрос, а языковой стандарт ключевое слово определяет LCID, используемый поисковой системой при анализе ключевых слов расширенного синтаксиса запросов (AQS).

Например, если у вас есть версия "английский—США" без пакетов MUI, языковой стандарт содержимого и ключевое слово языковой стандарт будут иметь значение 1033. Если у вас версия на немецком языке без пакетов MUI, языковой стандарт содержимого и языковой стандарт ключевое слово имеют значение 1031 (gr-gr). Однако если у вас есть версия на английском языке с пакетом MUI на румынском языке, языковой стандарт содержимого — 2072 (ro), а языковой стандарт ключевое слово — 1033 (en-us).

Работа со свойствами и столбцами

Элементы представлены в хранилище свойств в виде строки. Каждая строка содержит несколько столбцов, представляющих свойства для этого элемента. Не все элементы будут иметь значение для заданного свойства. Например, звуковой файл обычно не содержит значения для свойства System.Property.FromName, но может содержать сведения о System.Music.Artist.

С помощью этих методов можно получить доступ к свойству или изменить его с разделителями-запятыми, завершающимися null, строкой Юникода, которая указывает одно или несколько имен столбцов хранилища свойств: "System.Document.Author, System.Document.Title".

Работа с расширением терминов запроса

Этот метод позволяет расширить некоторые термины запроса с помощью символов wild карта, аналогично расширению регулярных выражений. Расширение префикса ищет слова с тем же префиксом (fun/воронка). Если значение не задано, значение по умолчанию — SEARCH_TERM_PREFIX_ALL. Ниже перечислены поддерживаемые значения перечисления SEARCH_TERM_EXPANSION .

• SEARCH_TERM_PREFIX_ALL — развернуты все условия поиска
• SEARCH_TERM_NO_EXPANSION — условия поиска не развернуты

Работа с другими методами ISearchQueryHelper

Многие методы в интерфейсе ISearchQueryHelper используются для задания аргументов запроса или определения возвращаемых свойств.

Связанные темы

Отправка программных запросов к индексу

Использование подходов SQL и AQS для запроса индекса

Запрос индекса с помощью протокола search-ms

Запрос к индексу с помощью синтаксиса SQL Windows Search

Использование расширенного синтаксиса запросов программным способом