Настройка кэша обогащения

Important

Эта функция предоставляется в общедоступной предварительной версии в соответствии с дополнительными условиями использования. Предварительная версия REST API поддерживает эту функцию.

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

Кэшированное содержимое помещается в службу хранилища Azure с помощью предоставленной строки подключения. Эти объекты создаются при запуске индексатора. Его следует рассматривать как внутренний компонент, управляемый службой поиска, и не следует изменять.

Контейнер с именем ms-az-search-indexercache-<alpha-numeric-string>
Таблицы с именем MsAzSearchIndexerCacheIndex<alpha-numeric-string>

Prerequisites

служба хранилища Azure для хранения кешированных данных обогащения. Учетная запись хранения должна быть общего назначения версии 2.
Для индексирования блобов только, если требуется синхронизированное удаление документа из кэша и индекса при удалении блобов из источника данных, включите политику удаления в индексаторе. Без этой политики удаление документов из кэша не поддерживается.

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

Limitations

Caution

Если вы используете индексатор SharePoint (предварительная версия), следует избегать добавочного обогащения. При определенных обстоятельствах кэш становится недействительным, требуя сброса индексатора и полного перестроения, если вы решите перезагрузить его.

Permissions

Для идентификатора Поиск с использованием ИИ Azure требуется доступ на запись в служба хранилища Azure.

Сотрудник по работе с BLOB-данными хранилища
Сотрудник по работе с данными в таблицах хранилища

Синтаксис строки подключения определяет, используется ли назначаемое системой удостоверение или удостоверение, назначаемое пользователем. Для получения дополнительной информации см. статью «Подключение к хранилищу Azure с помощью управляемого удостоверения».

Установка свойства кэша

Используйте эту процедуру для новых и существующих индексаторов.

В определении индексатора задайте следующие значения cache :

(Обязательно) storageConnectionString укажите строку подключения к службе хранилища Azure.
(Необязательно) enableReprocessing (true по умолчанию). Установите значение false для временного приостановления добавочного обогащения, а позже переключите его обратно на true.

Портал Azure
REST

Слева выберите индексаторы.
Выберите "Добавить индексатор" , чтобы создать индексатор или открыть существующий в режиме редактирования JSON.
Включите инкрементное обогащение, задайте учетную запись для хранения кэша обогащения и сохраните индексатор.
Сбросьте индексатор, если он уже существует.
Запустите индексатор. Это однократное полное перестроение инициализирует кэш. После загрузки добавочное повторное использование применяется к последующим запускам.

Рекомендуется выполнить индексатор GET , если вы редактуете существующий индексатор.

Используйте последнюю предварительную версию API для создания или обновления индексатора.

PUT https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]?api-version=2025-11-01-preview
    Content-Type: application/json
    api-key: [YOUR-ADMIN-KEY]
    {
        "name": "<YOUR-INDEXER-NAME>",
        "targetIndexName": "<YOUR-INDEX-NAME>",
        "dataSourceName": "<YOUR-DATASOURCE-NAME>",
        "skillsetName": "<YOUR-SKILLSET-NAME>",
        "cache": {
            "storageConnectionString": "<YOUR-STORAGE-ACCOUNT-CONNECTION-STRING>",
            "enableReprocessing": true
        },
        "fieldMappings": [],
        "outputFieldMappings": [],
        "parameters": []
    }

Перезапустите индексатор, если он уже существует.
Запустите индексатор. Это однократное полное перестроение инициализирует кэш. После загрузки добавочное повторное использование применяется к последующим запускам.
```
POST https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]/run?api-version=2025-11-01-preview
    Content-Type: application/json
    api-key: [YOUR-ADMIN-KEY]
```

Если вы отправляете другой запрос GET для индексатора, ответ от службы содержит свойство ID в объекте кэша. Строка добавляется к имени контейнера, содержащего все кэшированные результаты и промежуточное состояние каждого документа, обработанного этим индексатором. Идентификатор используется для уникальной идентификации кэша в хранилище объектов Blob.

    "cache": {
        "ID": "<ALPHA-NUMERIC STRING>",
        "enableReprocessing": true,
        "storageConnectionString": "DefaultEndpointsProtocol=https;AccountName=<YOUR-STORAGE-ACCOUNT>;AccountKey=<YOUR-STORAGE-KEY>;EndpointSuffix=core.windows.net"
    }

Проверка кэшированных выходных данных

Войдите на портал Azure и найдите учетную запись хранения Azure.
Используйте браузер хранилища для просмотра контейнеров и таблиц.
- Контейнер имеет имя ms-az-search-indexercache-<some-alphanumeric-string>.
- Имена таблиц следующие: MsAzSearchIndexerCacheIndex<alpha-numeric-string>

Кэш создается и используется индексатором. Его содержимое не доступно для чтения.

Чтобы проверить, работает ли кэш, измените набор навыков и запустите индексатор, а затем сравните метрики выполнения и количества документов до и после.

Наборы компетенций, включающие анализ изображений и оптическое распознавание символов (OCR) отсканированных документов, служат хорошими примерами для тестирования. Если изменить дочерний текстовый навык или любой навык, не связанный с изображением, индексатор может получить ранее обработанные изображения и содержимое OCR из кэша, а также обработать только изменения, касающиеся текста. Вы можете ожидать меньше документов в счетчиках выполнения индексатора, более коротких времени выполнения и более низких затратах.

Набор файлов, используемый в учебных материалах cog-search-demo, является полезным тестовым случаем, так как он содержит 14 файлов различных форматов: JPG, PNG, HTML, DOCX, PPTX и других типов. Измените en на es или другой язык в текстовом навык перевода для тестирования концепции поэтапного обогащения.

Распространенные ошибки

Следующая ошибка возникает, если вы забыли указать версию API предварительной версии в запросе:

"The request is invalid. Details: indexer : A resource without a type name was found, but no expected type was specified. To allow entries without type information, the expected type must also be specified when the model is specified."

Ошибка неправильного запроса 400 также возникает, если отсутствует требование индексатора. Сообщение об ошибке указывает отсутствующие зависимости.

Следующий шаг

Добавочное обогащение применимо к индексаторам, содержащим наборы навыков, предоставляя повторное содержимое для индексов и хранилищ знаний. Следующая ссылка содержит дополнительные сведения об управлении кэшем.

Управление кэшем обогащения

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-02-26