보강 캐시 구성(미리 보기)

1. 왼쪽에서 인덱서를 선택합니다.

2. 인덱서 추가를 선택하여 새 인덱서 만들기 또는 JSON 편집 모드에서 기존 인덱서 열기

3. 증분 보강을 사용하도록 설정하고, 보강 캐시 스토리지 계정을 설정하고, 인덱서 저장

   

4. 인덱서가 이미 있는 경우 다시 설정합니다.

5. 인덱서 실행 이 일회성 전체 재구성 작업은 캐시를 초기화합니다. 로드된 후에는 후속 실행에 증분 재사용이 적용됩니다.

기존 인덱서 편집하는 경우 GET 인덱서 로 현재 구성을 가져옵니다.

1. 인덱서 만들기 또는 업데이트에 최신 미리 보기 API를 사용합니다.

   PUT https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]?api-version=2026-08-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": []
       }
   

2. 인덱서가 이미 있는 경우 다시 설정합니다.

3. 인덱서 실행 이 일회성 전체 재구성 작업은 캐시를 초기화합니다. 로드된 후에는 후속 실행에 증분 재사용이 적용됩니다.

   POST https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]/run?api-version=2026-08-01-preview
       Content-Type: application/json
       api-key: [YOUR-ADMIN-KEY]
   

이제 인덱서에서 다른 GET 요청을 실행하면 서비스의 응답에 캐시 개체의 속성이 포함됩니다 ID . 문자열은 이 인덱서에서 처리된 각 문서의 캐시된 모든 결과와 중간 상태를 포함하는 컨테이너의 이름에 추가됩니다. ID는 Blob Storage의 캐시 이름을 고유하게 지정하는 데 사용됩니다.

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

캐시된 출력 확인

1. Azure 포털에 로그인하고 Azure Storage 계정을 찾습니다.

2. 스토리지 브라우저를 사용하여 컨테이너 및 테이블을 검토합니다.

   • 컨테이너 이름은 .입니다 ms-az-search-indexercache-<some-alphanumeric-string>.

   • 테이블 이름은 MsAzSearchIndexerCacheIndex<alpha-numeric-string>입니다.

인덱서는 캐시를 만들고 사용합니다. 그 콘텐츠는 사람이 읽을 수 없습니다.

캐시가 작동하는지 확인하려면 기술 세트를 수정하고 인덱서를 실행한 다음 실행 시간 및 문서 수에 대한 전후 메트릭을 비교합니다.

스캔한 문서의 이미지 분석 및 OCR(광학 인식)을 포함하는 기술 세트는 좋은 테스트 사례를 만듭니다. 다운스트림 텍스트 기술 또는 이미지와 관련이 없는 기술을 수정하는 경우 인덱서는 캐시에서 이전에 처리된 이미지 및 OCR 콘텐츠를 검색하고 편집에서 텍스트 관련 변경 내용만 처리할 수 있습니다. 인덱서 실행 횟수에서 더 적은 문서, 짧은 실행 시간 및 더 낮은 비용을 예상할 수 있습니다.

파일 집합cog-search-demo 자습서에는 JPG, PNG, HTML, DOCX, PPTX 및 기타 형식의 14개 파일이 포함되어 있으므로 유용한 테스트 사례입니다. 증분 보강의 개념 증명 테스트를 위해 텍스트 번역 기술에서 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 잘못된 요청 오류가 발생합니다. 오류 메시지는 누락된 종속성을 지정합니다.

다음 단계

기술 세트가 포함된 인덱서에서 증분 보강을 사용할 수 있으므로 인덱스와 지식 저장소 모두에 콘텐츠를 다시 사용할 수 있습니다. 캐시 관리에 대한 자세한 내용은 다음 문서를 참조하세요.