Управление схемой поиска (предварительная версия)
Схема поиска определяет, как содержимое, которое будет приниматься через соединитель Graph, используется в различных интерфейсах Microsoft Graph. Схема определяет структуру сбора содержимого из источника данных, индексации, запроса и извлечения из индекса поиска. Изменив схему поиска, вы можете управлять тем, что пользователи могут искать, как пользователи могут выполнять поиск и как можно представить результаты в конечных точках поиска (Майкрософт).
Схема поиска содержит свойства для обхода, атрибуты поиска, семантические метки и псевдонимы. В следующих разделах будут определены различные составляющие предоставляемых возможностей схемы и управления.
Примечание.
Общие инструкции по настройке соединителя Graph см. в статье Настройка соединителя Graph. Шаги 6 и 7 определяют схему при настройке нового подключения.
Примечание.
Если вы хотите изменить схему поиска SharePoint Online, см. статью Управление схемой поиска в SharePoint.
Свойства для обхода
Для создания индекса поиска необходимо сначала выполнить обход контента. Вы можете сканировать различные источники контента, как указано в коллекции соединителей. Содержимое и метаданные элементов, для которых выполняется обход контента, представлены в виде свойств для обхода (или свойств источника).
Например, в следующей таблице представлены примеры свойств для обхода для системного соединителя рабочих билетов.
| Свойство | Тип |
|---|---|
| ticketId | String |
| title | String |
| createdBy | String |
| assignedTo | String |
| lastEditedDate | DateTime |
| lastEditedBy | String |
| workItemType | String |
| priority | Int64 |
| tags | StringCollection |
| status | String |
| url | String |
| resolved | Boolean |
Примечание.
- Для соединителей, созданных корпорацией Майкрософт, свойства обхода выбраны на шаге 4 статьи Настройка соединителя Graph .
Атрибуты поиска
Свойство Content
Это свойство используется для полнотекстового индексирования содержимого, создания фрагмента страницы результатов поиска, участия в кластере результатов , обнаружения языка, поддержки HTML/текста, ранжирования и релевантности, а также формирования запросов.
При выборе свойства содержимого можно использовать созданное системой свойство ResultSnippet при создании типа результата. Это свойство служит заполнителем для динамических фрагментов, создаваемых из свойства содержимого во время запроса. Если вы используете это свойство в типе результата, в результатах поиска будут созданы фрагменты кода.
Возможность поиска
Если свойство доступно для поиска, его значение добавляется в полнотекстовый индекс. Когда пользователь выполняет поиск, результаты возвращаются в том случае, если поисковый запрос совпадает с одним из полей, доступных для поиска, или его контентом.
Поиск по запросу "design" с отображением результатов соответствия по свойству (title) и контенту.
Возможность запроса
Если свойство поддерживает запросы, вы можете запрашивать его с помощью языка KQL. KQL состоит из одного или нескольких ключевых слов произвольного текста (слов или фраз) или ограничений свойств. Имя свойства должно быть включено в запрос, будучи либо указанным в самом запросе, либо включаемым в запрос программно. Вы можете использовать сопоставление префиксов с помощью оператора подстановочного знака(*).
Примечание.
Сопоставление суффиксов не поддерживается.
Поиск по запросу "search ba*", отображающий результаты, соответствующие этому префиксу.
Поиск по запросу "tags:design" приводит к элементам со словом "дизайн" в свойстве tags.
Возможность извлечения
Если свойство можно извлечь, его значение может возвращаться в результатах поиска. Любое свойство, которое вы хотите добавить в шаблон отображения или вернуть из запроса и показывать в результатах поиска, должно быть извлекаемым. Пометка больших или слишком большого количества свойств как извлекаемых увеличивает задержку поиска. Будьте внимательны и выбирайте нужные свойства.
Набор свойств, доступных для извлечения (title и lastEditedBy), отображаемый в качестве результата.
Возможность уточнения
Если свойство поддерживает уточнение, администратор может настроить его в качестве пользовательского фильтра на странице результатов Поиска (Майкрософт). Свойство refinable не может иметь значение searchable.
Уточнение результатов по tags, свойство с возможностью уточнения.
Примечание.
- Для соединителей, созданных корпорацией Майкрософт, атрибуты поиска выбираются на шаге 7 статьи Настройка соединителя Graph .
Семантические метки
Семантическая метка — это известный тег, опубликованный корпорацией Майкрософт, который можно добавить для свойства в схему. Добавление семантических меток позволяет различным продуктам Майкрософт понимать свойство и обеспечивать более удобное взаимодействие.
Семантические метки предоставляют независимый от домена подход к назначению свойств из различных доменов контента набору известных классов. Они находят применение во множестве различных материалов и обеспечивают автоматическую поддержку таких задач, как:
- Интеграция данных в разнородных интерфейсах
- Создание графов общих знаний (например, Темы)
- Шаблоны по умолчанию для пользовательских интерфейсов
Метки обеспечивают семантическое значение и позволяют интегрировать данные соединителя в возможности Microsoft 365.
| Метка | Описание |
|---|---|
| title | Название элемента, которое вы хотите отображать в поиске и других интерфейсах. |
| url | Целевой URL-адрес элемента в источнике данных. |
| createdBy | Имя человека, создавшего элемент в источнике данных. |
| lastModifiedBy | Имя человека, который последним изменил элемент в источнике данных. |
| authors | Имена всех пользователей, которые совместно работали над элементом в источнике данных. |
| createdDateTime | Дата и время создания элемента в источнике данных. |
| lastModifiedDateTime | Дата и время последнего изменения элемента в источнике данных. |
| fileName | В случае с файлом — имя файла в источнике данных. |
| fileExtension | В случае с файлом — расширение файла в источнике данных. |
| iconUrl | URL-адрес значка. |
Например, свойство lastEditedBy для обхода имеет то же значение, что и метка Microsoft lastModifiedBy.
Важно!
Все свойства, сопоставленные с метками, должны быть доступны для извлечения.
Метка title является самой важной меткой. Обязательно назначьте свойство этой метке, чтобы разрешить своей связи участвовать во взаимодействии с кластером результатов. Неправильное сопоставление меток ухудшает качество поиска. Для некоторых меток нормально отсутствие назначенного свойства.
Примечание.
- Для соединителей, созданных корпорацией Майкрософт, семантические метки выбираются на шаге 6 статьи Настройка соединителя Graph .
Псевдонимы
Псевдонимы — это понятные имена свойств, которые вы назначаете. Они используются в запросах и выборках в фильтрах с уточняемыми свойствами.
Примечание.
- Для соединителей, созданных корпорацией Майкрософт, псевдонимы определены на шаге 7 статьи Настройка соединителя Graph .
Возможности обновления схемы
В этом разделе содержатся сведения о возможностях обновления схемы поиска соединителей Graph, созданных Корпорацией Майкрософт.
Примечание.
Рекомендуется выполнить полный обход контента после обновления, чтобы привести их к последней схеме. Без полного обхода поведение элементов будет несогласованным.
Управление схемой
- В Центр администрирования Microsoft 365 перейдите на страницу Схема в разделе Настройка.
- Щелкните Просмотреть сведения в разделе Схема соединителей графа.
- Выберите подключение, для которого требуется обновить схему, и нажмите кнопку Настроить схему.
- После внесения необходимых изменений в схему щелкните Опубликовать изменения схемы , чтобы опубликовать новую схему.
Добавление свойства для обхода
Вы можете добавить свойство в схему. При добавлении свойства можно включить все необходимые атрибуты поиска.
Добавление нового исходного свойства из списка поддерживаемых свойств соединителем
Важно!
Удалить существующее свойство для опубликованного подключения нельзя. Чтобы удалить свойство, необходимо удалить и повторно создать подключение.
Добавление и удаление возможности поиска
Вы можете добавлять или удалять определенные атрибуты поиска в свойство . Для добавления возможности поиска требуется полный обход контента.
Обновление заметок поиска для свойств для обхода
Важно!
- Из свойства нельзя удалить извлекаемый атрибут поиска.
- Невозможно добавить или удалить атрибут уточняемого поиска в свойстве.
Добавление и удаление семантической метки
Вы можете добавить или обновить сопоставление семантических меток для свойств для обхода.
Обновление семантических меток для свойств для обхода
Добавление и удаление псевдонима
Вы можете добавлять или удалять псевдонимы, а также использовать их для поисковых запросов.
Добавление или удаление псевдонима для свойств для обхода