Azure Cosmos DB .NET SDK v2 SQL API:下載及發行 (舊版)

適用于 :SQL API

連結
SDK 下載 NuGet
API 檔 .NET API 參考檔
樣品 .NET 程式碼範例
開始使用 開始使用 Azure Cosmos DB .NET SDK
Web App 教學課程 使用 Azure 和 DB Cosmos Web 應用程式開發
目前支援的框架 Microsoft .NET Framework 4.5

警告

Azure Cosmos DB .NET SDK v2.x 將于 2024 年 8 月 31 日停用;SDK 和使用 SDK 的所有應用程式會繼續運作;Azure Cosmos DB 只會停止為此 SDK 提供進一步的維護與支援。 我們建議您 移移至 最新版本的 .NET SDK v3 SDK。

注意

如果您使用的是 .NET Framework,請參閱.NET SDK的最新版本 3.x ,其目標為 .NET Standard。

發行歷程記錄

版本歷程記錄會維持在 Azure Cosmos DB .NET SDK 來源資源中。 有關每個版本中修正功能版本和錯誤的詳細清單,請參閱 SDK changelog 檔

由於 Azure Cosmos DB .NET SDK 版本 3 包含更新的功能和改良的績效,因此此 SDK 的 2.x 將于 2024 年 8 月 31 日停用。 您必須在到期日之前將 SDK 更新至版本 3。 我們建議您遵循將DB .NET SDK 版本 3 Cosmos到 Azure 的指示。

2.x.x 版本提供不同的 .NET SDK 子版本。 建議的最低版本為 2.16.2

已知問題

以下是影響建議的最低版本之任何知道 問題的清單

問題 影響 緩解 追蹤連結
當將直接模式與具有多個寫入位置的帳戶一起使用時,SDK 可能無法偵測到何時將區域新加到帳戶。 重新處理帳戶 資訊的背景程式 無法啟動。 如果新區域已新加入帳戶,而該帳戶屬於比目前地區更高的優先順序的 PreferredLocations,則 SDK 不會偵測到新的可用區域。 重新開機應用程式。 https://github.com/Azure/azure-cosmos-dotnet-v2/issues/852

常見問題

如何收到即將停用 SDK 的通知?

Microsoft 將在即將終止支援 SDK 之前提供 12 個月的事先通知,以協助順利轉換至支援的 SDK。 我們會透過各種通訊通道通知您:Azure 入口網站、Azure 更新,以及直接通訊給指派的服務系統管理員。

在 12 個月內,我可以使用即將停用的 Azure Cosmos DB SDK 來撰寫應用程式嗎?

是的,您可以在 12 個月的通知期間使用即將停用的 Azure Cosmos DB SDK 來撰寫、部署及修改應用程式。 建議您在 12 個月的通知期間 ,在 12 個月的通知期間,Cosmos更新支援版本的 Azure 和 DB SDK。

在停用日期之後,使用不受支援 Azure 和 DB SDK Cosmos會發生什麼情況?

停用日期之後,Azure Cosmos DB 將不再進行錯誤修正、新增新功能,或為已停用的 SDK 版本提供支援。 如果您不想升級,Azure 和 DB 服務會繼續提供從已停用版本的 SDK Cosmos要求。

哪些 SDK 版本會提供最新的功能和更新?

新功能和更新只會新增到最新支援的主要 SDK 版本的最新次要版本。 我們建議您一直使用最新版本,以利用新功能、改良功能和錯誤修正。 如果您使用的是舊的、非停用版本的 SDK,您向 Azure Cosmos DB 的要求仍然會運作,但您無法存取任何新功能。

如果截止日期之前無法更新應用程式,該怎麼辦?

建議您儘早升級至最新的 SDK。 將 SDK 標記為停用後,您將有 12 個月來更新您的應用程式。 如果您無法于淘汰日期之前更新,Azure Cosmos DB 會繼續提供從已停用版本的 SDK 所送出的要求,因此您執行的應用程式會繼續運作。 但 Azure Cosmos DB 將不再進行錯誤修正、新增新功能,或為已停用的 SDK 版本提供支援。

如果您有支援計畫且需要技術支援, 請提交 支援票證來聯絡我們。

另請參閱

若要深入瞭解資料庫Cosmos,請參閱Microsoft Azure Cosmos服務頁面。