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

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

• Получите строку подключения OLE DB для подключения к базе данных Поиска Windows.
• Преобразование запросов пользователей расширенного синтаксиса запросов (AQS) в язык структурированных запросов Windows (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.

   // 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).

Например, если у вас есть версия English-US без пакетов MUI, языковой стандарт содержимого и языковой стандарт ключевого слова — 1033. Если у вас есть немецкая версия без пакетов MUI, то локаль содержимого и локаль ключевых слов — 1031 (de-DE). Однако если у вас есть английская версия с пакетом MUI для Румынии, языковой стандарт содержимого составляет 2072 (ro), а ключевой язык — 1033 (en-us).

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

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

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

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

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

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

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

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

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

запрос индекса программным способом

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

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

Запрос к индексу с использованием синтаксиса SQL поиска Windows

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