이전 버전에서 의미 체계 순위 코드 마이그레이션
초기 미리 보기 API에 대해 의미 체계 순위 코드를 작성한 경우 이 문서에서는 최신 API 버전으로 마이그레이션하는 데 필요한 코드 변경 내용을 식별합니다. 의미 체계 순위에 대한 주요 변경 내용은 최근 API의 쿼리 논리로 제한되지만, 코드가 초기 미리 보기 버전에 대해 작성된 경우 의미 체계 구성도 변경해야 할 수 있습니다.
호환성이 손상되는 변경
REST API 버전에서 의미 체계 순위에 대한 두 가지 주요 변경 내용이 있습니다.
searchFields는 2021-04-30-preview로 대체semanticConfiguration되었습니다.queryLanguage는 2023-07-01-preview부터 무시되었지만 2024-11-01-preview에서 쿼리 다시 쓰기를 위해 복원되었습니다.
다른 버전별 업데이트는 새로운 기능과 관련이 있지만 기존 코드를 중단하지 않으므로 변경 내용이 손상되지 않습니다.
Azure SDK를 사용하는 경우 시간이 지남에 따라 여러 API의 이름이 바뀌었습니다. SDK 변경 로그는 세부 정보를 제공합니다.
의미 체계 순위를 제공하는 API 버전
코드에서 REST API 버전 또는 SDK 패키지 버전을 확인하여 의미 체계 순위를 제공하는 버전을 확인합니다. 다음 API 버전에는 의미 체계 순위에 대한 어느 정도의 지원이 있습니다.
| 릴리스 종류 | REST API 버전 | 의미 체계 순위 업데이트 |
|---|---|---|
| 최초의 | 2020-06-30-preview | 문서 검색에 추가 queryType=semantic |
| 미리 보기 | 2021-04-30-preview | 인덱스 만들기 또는 업데이트에 추가 semanticConfiguration |
| 미리 보기 | 2023-07-01-preview | semanticConfiguration를 업데이트합니다. 2023년 7월 14일부터 Microsoft에서 호스팅하는 의미 체계 모델에 대한 업데이트로 의미 체계 순위가 언어에 구애받지 않고 의미 체계 순위에 대한 속성을 효과적으로 해제 queryLanguage 했습니다. 코드에 호환성이 손상되는 변경은 없지만 속성은 무시됩니다. 고객은 코드에서 이 속성을 제거하는 것이 좋습니다. |
| 미리 보기 | 2023-10-01-preview | 재떨이 용도로만 사용되는 쿼리를 보내도록 추가합니다 semanticQuery . |
| stable | 2023-11-01 | 일반 공급. 안정적인 버전으로 semanticConfiguration 진행되는 변경 내용이 도입되었습니다. 코드가 이 버전 이상을 대상으로 하는 경우 새 미리 보기 기능을 채택하지 않는 한 최신 API 버전과 호환됩니다. |
| 미리 보기 | 2024-05-01-preview | 변경 없음 |
| stable | 2024-07-01 | 변경 없음 |
| 미리 보기 | 2024-09-01-preview | 변경 없음 |
| 미리 보기 | 2024-11-01-preview | 쿼리 다시 쓰기를 추가합니다. queryLanguage 이제 쿼리 다시 쓰기(미리 보기)를 사용하는 경우 속성이 필요합니다. |
Azure SDK에 대한 로그 변경
Azure SDK는 독립적인 릴리스 일정에 있습니다. 변경 로그를 확인하여 의미 체계 기능을 제공하는 패키지와 API의 이름이 바뀌었는지 여부를 확인해야 합니다.
2024-11-01-preview
2024-09-01-preview
2024-07-01 안정적인 버전의 의미 체계 순위 구문은 변경되지 않습니다.
2024-07-01
2024-05-01-preview 버전의 의미 체계 순위 구문은 변경되지 않습니다.
이 API 버전을 사용하지 마세요. 최신 API 버전과 호환되지 않는 벡터 쿼리 구문을 구현합니다.
2024-05-01-preview
2024-03-01-preview 버전의 의미 체계 순위 구문은 변경되지 않습니다.
2024-03-01-preview
2023-10-01-preview 버전의 의미 체계 순위 구문은 변경되지 않지만 벡터 쿼리가 도입됩니다. 이제 의미 체계 순위가 하이브리드 및 벡터 쿼리의 응답에 적용됩니다. 필드가 나열된 것으로 가정하여 응답에서 사람이 읽을 수 있는 모든 텍스트 필드에 다시 표시를 적용할 수 있습니다 prioritizedFields.
2023-11-01
- 제외되며
SemanticDebugsemanticQuery, 그렇지 않으면 2023-10-01-preview 버전과 동일합니다.
2023-10-01-preview
semanticQuery를 추가
2023-07-01-preview
- 를
semanticMaxWaitInMilliseconds추가합니다semanticErrorHandling. - 응답에 다양한 의미 체계 관련 필드(예:
SemanticDebug및SemanticErrorMode.)를 추가합니다. - 무시합니다
queryLanguage. 더 이상 의미 체계 순위에 사용되지 않습니다.
2023년 7월 14일부터 의미 체계 순위는 언어에 구애받지 않습니다. 미리 보기 버전에서 의미 체계 순위는 필드 분석기에서 querylanguage 지정한 것과 다른 결과의 우선 순위를 지정하지 않습니다. 그러나 queryLanguage 이 속성은 맞춤법 수정 및 해당 기능에서 지원하는 짧은 언어 목록에 적용할 수 있습니다.
2021-04-30-preview
- 의미 체계 지원은 문서 검색 및 인덱스 만들기 또는 업데이트 미리 보기 API 호출을 통해 지원됩니다.
- 검색 인덱스로 추가합니다
semanticConfiguration. 의미 체계 구성에는 이름과 우선 순위가 지정된 필드 목록이 있습니다. - ''prioritizedFields'를 추가합니다.
이 searchFields 속성은 더 이상 필드의 우선 순위를 지정하는 데 사용되지 않습니다. 앞으로 semanticConfiguration.prioritizedFields 진행되는 모든 버전에서 L2 순위에 사용할 필드를 지정하는 메커니즘으로 바뀝 searchFields 니다.
2020-06-30-preview
- 의미 체계 지원은 검색 문서 미리 보기 API 호출을 통해 제공됩니다.
- 쿼리 요청에 추가합니다
queryType=semantic. searchFields쿼리 형식이 의미 체계인 경우 속성이searchFields의미 체계 순위에 대한 필드 입력의 우선 순위 순서를 결정하도록 조정합니다.- 를
answershighlights추가하고 쿼리 응답에 추가합니다captions.
다음 단계
의미 체계 쿼리를 실행하여 의미 체계 구성 마이그레이션을 테스트합니다.