從舊版移轉語意排名程序代碼
如果您的語意排名程式代碼是針對早期預覽 API 撰寫的，本文會識別移轉至較新版本所需的程式碼變更。 語意排名器的重大變更僅限於最近 API 中的查詢邏輯，但如果您的程式代碼是針對初始預覽版本撰寫的，您可能也需要變更語意設定。
重大變更
在 REST API 版本中，語意排名器有兩項重大變更：
searchFields已在 2021-04-30-preview 中取代semanticConfigurationqueryLanguage自 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 至搜尋檔 |
| preview | 2021-04-30-preview | 新增 semanticConfiguration 至建立或更新索引 |
| preview | 2023-07-01-preview | 更新 semanticConfiguration。 從 2023 年 7 月 14 日開始，Microsoft裝載語意模型的更新使語意排名器語言無從驗證，有效地解除委任 queryLanguage 語意排名的屬性。 程式代碼中沒有任何重大變更，但會忽略 屬性。 建議客戶從程式代碼中移除此屬性。 |
| preview | 2023-10-01-preview | 新增 semanticQuery 以傳送只用於重新編製用途的查詢。 |
| 穩定 | 2023-11-01 | 正式推出。 已將變更 semanticConfiguration 介紹至穩定版本。 如果您的程式代碼以這個版本或更新版本為目標，除非您採用新的預覽功能，否則它與較新的 API 版本相容。 |
| preview | 2024-05-01-preview | 沒有變化 |
| 穩定 | 2024-07-01 | 沒有變化 |
| preview | 2024-09-01-preview | 沒有變化 |
| preview | 2024-11-01-preview | 新增查詢重寫。 queryLanguage如果您使用查詢重寫 （預覽），現在需要 屬性。 |
Azure SDK 的變更記錄
Azure SDK 是獨立發行排程。 您應該檢查變更記錄檔，以判斷哪些套件提供語意功能，以及是否已重新命名任何 API。
- 適用於 .NET 的 Azure SDK 變更記錄
- 適用於 Python 的 Azure SDK 變更記錄
- 適用於 Java 的 Azure SDK 變更記錄
- 適用於 JavaScript 的 Azure SDK 變更記錄
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
SemanticDebug排除 和semanticQuery，否則與 2023-10-01-preview 版本相同。
2023-10-01-preview
- 加入
semanticQuery
2023-07-01-preview
- 加入
semanticErrorHandling、semanticMaxWaitInMilliseconds。 - 將許多語意相關欄位新增至回應，例如
SemanticDebug和SemanticErrorMode。 queryLanguage忽略 ，它不再用於語意排名。
從 2023 年 7 月 14 日開始，語意排名器與語言無關。 在預覽版本中，語意排名會將結果與欄位分析器所指定的 不同 querylanguage ， 將結果取消定價。 不過， queryLanguage 屬性仍然適用於 拼字更正 和該功能所支持的語言簡短清單。
2021-04-30-preview
- 語意支援是透過搜尋檔和建立或更新索引預覽 API 呼叫。
- 加入
semanticConfiguration至搜尋索引。 語意設定具有名稱和優先順序欄位清單。 - 新增 ''優先順序的Fields'。
屬性 searchFields 不再用來設定欄位的優先順序。 在所有向前移動的版本中， semanticConfiguration.prioritizedFields 會取代 searchFields 為指定要用於 L2 排名之字段的機制。
2020-06-30-preview
- 語意支援是透過 搜尋文件 預覽 API 呼叫。
- 新增
queryType=semantic至查詢要求。 searchFields調整讓查詢類型為語意，searchFields屬性會決定字段輸入對語意排名器的優先順序。- 將、
answers新增highlightscaptions至查詢回應。
下一步
執行語意查詢來測試您的語意組態移轉。