SQL API için Azure Cosmos DB .NET SDK: Notları indir ve serbest bırakAzure Cosmos DB .NET SDK for SQL API: Download and release notes

SDK'sını indirmeSDK download NuGetNuGet
API belgeleriAPI documentation .NET API başvuru belgeleri.NET API reference documentation
ÖrneklerSamples .NET kodu örnekleri.NET code samples
Kullanmaya başlamaGet started Azure Cosmos DB .NET SDK ile çalışmaya başlamaGet started with the Azure Cosmos DB .NET SDK
Web uygulaması ÖğreticisiWeb app tutorial Azure Cosmos DB ile Web uygulaması geliştirmeWeb application development with Azure Cosmos DB
Geçerli desteklenen çerçevesiCurrent supported framework Microsoft .NET Framework 4.5Microsoft .NET Framework 4.5

Sürüm notlarıRelease notes

Not

.NET Framework kullanıyorsanız, lütfen .NET Standard hedefleyen .NET SDK 'sınınen son sürüm 3. x sürümünü inceleyin.If you are using .NET Framework, please see the latest version 3.x of the .NET SDK, which targets .NET Standard.

2.6.02.6.0

  • ConnectionPolicy 'e PortReusePolicy eklendiAdded PortReusePolicy to ConnectionPolicy
  • Ntdll! düzeltildi! Bir UWP uygulamasında SDK kullanıldığında RtlGetVersion TypeLoadException sorunuFixed ntdll!RtlGetVersion TypeLoadException issue when SDK is used in a UWP app

2.5.12.5.1

  • SDK 'nın System .net. http sürümü artık NuGet paketinde tanımlananla eşleşiyor.SDK’s System.Net.Http version now matches what is defined in the NuGet package.
  • Özgün diğeri başarısız olursa, yazma isteklerinin farklı bir bölgeye geri dönüş yapmasına izin verin.Allow write requests to fallback to a different region if the original one fails.
  • Yazma isteği için oturum yeniden deneme ilkesi ekleyin.Add session retry policy for write request.

2.4.12.4.1

  • Boş sayfalara neden olan sorgular için izleme yarış durumunu düzeltirFixes tracing race condition for queries which caused empty pages

2.4.02.4.0

  • LINQ sorguları için artırılmış ondalık duyarlık boyutu.Increased decimal precision size for LINQ queries.
  • Yeni sınıflar CompositePath, CompositePathSortOrder, SpatialSpec, SpatialType ve PartitionKeyDefinitionVersion eklendiAdded new classes CompositePath, CompositePathSortOrder, SpatialSpec, SpatialType and PartitionKeyDefinitionVersion
  • DocumentCollection 'a TimeToLivePropertyPath eklendiAdded TimeToLivePropertyPath to DocumentCollection
  • Indexpolicy 'e Compositeındexes ve Spatıalındexes eklendiAdded CompositeIndexes and SpatialIndexes to IndexPolicy
  • PartitionKeyDefinition 'a eklenen sürümAdded Version to PartitionKeyDefinition
  • PartitionKey 'e None eklendiAdded None to PartitionKey

2.3.02.3.0

  • ConnectionPolicy için ıdletcpconnectiontimeout, OpenTcpConnectionTimeout, MaxRequestsPerTcpConnection ve MaxTcpConnectionsPerEndpoint eklendi.Added IdleTcpConnectionTimeout, OpenTcpConnectionTimeout, MaxRequestsPerTcpConnection and MaxTcpConnectionsPerEndpoint to ConnectionPolicy.

2.2.32.2.3

  • Tanılama geliştirmeleriDiagnostics improvements

2.2.22.2.2

  • "POCOSerializationOnly" ortam değişkeni ayarı eklendi.Added environment variable setting “POCOSerializationOnly”.

  • DocumentDB. uzamsal. Sql. dll kaldırıldı ve artık Microsoft. Azure. Documents. Serviceınterop. dll dosyasına eklendiRemoved DocumentDB.Spatial.Sql.dll and now included in Microsoft.Azure.Documents.ServiceInterop.dll

2.2.12.2.1

  • StoredProcedure yürütme çağrılarına yük devretme sırasında yeniden deneme mantığı geliştirme.Improvement in retry logic during failover for StoredProcedure execute calls.

  • DocumentClientEventSource Singleton yapıldı.Made DocumentClientEventSource singleton.

  • GatewayAddressCache zaman aşımını çözme, ConnectionPolicy RequestTimeout özelliğini karşılamıyor.Fix GatewayAddressCache timeout not honoring ConnectionPolicy RequestTimeout.

2.2.02.2.0

  • Doğrudan/TCP Aktarım tanılaması için SDK 'nın iç özel durum türü TransportException eklenmiştir.For direct/TCP transport diagnostics, added TransportException, an internal exception type of the SDK. Özel durum iletilerinde mevcut olduğunda, bu tür istemci bağlantı sorunlarını gidermek için ek bilgileri yazdırır.When present in exception messages, this type prints additional information for troubleshooting client connectivity problems.

  • HttpClient istekleri (ör. HttpClientHandler) göndermek için kullanılacak bir HTTP işleyici yığını olan bir HttpMessageHandler 'ı alan yeni Oluşturucu aşırı yüklemesi eklendi.Added new constructor overload which takes a HttpMessageHandler, a HTTP handler stack to use for sending HttpClient requests (e.g., HttpClientHandler).

  • Null değerli üstbilginin düzgün işlenmediğinden oluşan hatayı düzeltir.Fix bug where header with null values were not being handled properly.

  • Geliştirilmiş koleksiyon önbelleği doğrulaması.Improved collection cache validation.

2.1.32.1.3

  • Güncelleştirilmiş System.Net.Security 4.3.2 için.Updated System.Net.Security to 4.3.2.

2.1.2'yi2.1.2

  • Tanılama izleme iyileştirmeleriDiagnostic tracing improvements

2.1.12.1.1

  • Çok bölgeli isteği geçici hatalara karşı daha fazla esneklik eklenmiştir.Added more resilience to Multi-region request transient failures.

2.1.02.1.0

  • Eklenen çok bölgeli yazma desteği.Added Multi-region write support.
  • Bölüm sorgu performansı geliştirmelerinin üst ve MaxBufferedItemCount çapraz.Cross partition query performance improvements with TOP and MaxBufferedItemCount.

2.0.02.0.0

  • Eklenen isteği iptal etme desteği.Added request cancellation support.
  • Eklenen SetCurrentLocation için form veya ConnectionPolicy tercih edilen konumlar bölgeye göre otomatik olarak doldurur.Added SetCurrentLocation to ConnectionPolicy, which automatically populates the preferred locations based on the region.
  • Çapraz bölüm Min/Maks ve sorgular tek bir bölüme belge eşleşen filtre hata düzeltildi.Fixed Bug in Cross Partition Queries with Min/Max and a filter that matches no documents on an individual partition.
  • DocumentClient yöntemleri artık IDocumentClient ile eşlik vardır.DocumentClient methods now have parity with IDocumentClient.
  • Kurulan bağlantı sayısını azaltmak için güncelleştirilmiş doğrudan TCP taşıma yığını.Updated direct TCP transport stack to reduce the number of connections established.
  • Windows olmayan istemciler için eklenen destek doğrudan modu TCP için.Added support for Direct Mode TCP for non-Windows clients.

2.0.0-preview22.0.0-preview2

  • Eklenen isteği iptal etme desteği.Added request cancellation support.
  • Eklenen SetCurrentLocation için form veya ConnectionPolicy tercih edilen konumlar bölgeye göre otomatik olarak doldurur.Added SetCurrentLocation to ConnectionPolicy, which automatically populates the preferred locations based on the region.
  • Çapraz bölüm Min/Maks ve sorgular tek bir bölüme belge eşleşen filtre hata düzeltildi.Fixed Bug in Cross Partition Queries with Min/Max and a filter that matches no documents on an individual partition.

2.0.0-Preview2.0.0-preview

  • DocumentClient yöntemleri artık IDocumentClient ile eşlik vardır.DocumentClient methods now have parity with IDocumentClient.
  • Kurulan bağlantı sayısını azaltmak için güncelleştirilmiş doğrudan TCP taşıma yığını.Updated direct TCP transport stack to reduce the number of connections established.
  • Windows olmayan istemciler için eklenen destek doğrudan modu TCP için.Added support for Direct Mode TCP for non-Windows clients.

1.22.01.22.0

  • FeedOptions için ConsistencyLevel özelliği eklendi.Added ConsistencyLevel Property to FeedOptions.
  • Eklenen JsonSerializerSettings RequestOptions ve FeedOptions.Added JsonSerializerSettings to RequestOptions and FeedOptions.
  • Eklenen EnableReadRequestsFallback ConnectionPolicy için.Added EnableReadRequestsFallback to ConnectionPolicy.

1.21.11.21.1

  • Çapraz bölüm sıralama ölçütü sorguları köşe durumlarda sabit KeyNotFoundException için.Fixed KeyNotFoundException for cross partition order by queries in corner cases.
  • LINQ sorguları için select yan tümcesinde JsonProperty özniteliğinin kabul edildiği düzeltilmedi.Fixed bug where JsonProperty attribute in select clause for LINQ queries was not being honored.

1.20.21.20.2

  • Belirli yarış koşullarında oluşan hata düzeltildi, bu durum aralıklı olarak "Microsoft. Azure. Documents. NotFoundException" ile sonuçlanır: Oturum tutarlılığı düzeyi kullanılırken, okuma oturumu, giriş oturumu belirtecinin hataları için kullanılamaz.Fixed bug that is hit under certain race conditions, that results in intermittent "Microsoft.Azure.Documents.NotFoundException: The read session is not available for the input session token" errors when using Session consistency level.

1.20.11.20.1

  • Gerilemesi düzeltildi burada FeedOptions.MaxItemCount = -1 bir System.ArithmeticException oluşturdu: sayfa boyutu negatif ise.Fixed regression where FeedOptions.MaxItemCount = -1 threw an System.ArithmeticException: page size is negative.
  • Yeni bir ToString() işlevini QueryMetrics için eklendi.Added a new ToString() function to QueryMetrics.
  • Bölüm istatistikleri okuma koleksiyonlar üzerinde açık.Exposed partition statistics on reading collections.
  • ChangeFeedOptions için PartitionKey özelliği eklendi.Added PartitionKey property to ChangeFeedOptions.
  • Küçük hata düzeltmeleri.Minor bug fixes.

1.19.11.19.1

  • Belgeler için benzersiz dizinler hakkında DocumentCollection UniqueKeyPolicy özelliğini kullanarak belirtme olanağı ekler.Adds the ability to specify unique indexes for the documents by using UniqueKeyPolicy property on the DocumentCollection.
  • İçinde özel JsonSerializer ayarları bazı sorguları ve saklı yordam yürütme için kabul değil, bir hata düzeltildi.Fixed a bug in which the custom JsonSerializer settings were not being honored for some queries and stored procedure execution.

1.19.01.19.0

  • Azure Cosmos DB API Başvurusu'ndaki Azure documentdb'den bir değişiklik, belgeler, meta veri bilgilerini derlemelerde ve NuGet paketini marka.Branding change from Azure DocumentDB to Azure Cosmos DB in the API Reference documentation, metadata information in assemblies, and the NuGet package.
  • Tanılama bilgileri ve gecikme süresi ile doğrudan bağlantı modunu gönderilen isteklerin yanıtından kullanıma sunar.Expose diagnostic information and latency from the response of requests sent with direct connectivity mode. Özellik adlarını, ResourceResponse sınıfı üzerinde RequestDiagnosticsString ve RequestLatency bulunur.The property names are RequestDiagnosticsString and RequestLatency on ResourceResponse class.
  • Bu SDK sürüm Merkezi'nden Azure Cosmos DB Emulator kullanılabilir en son sürümünü gerektirir. https://aka.ms/cosmosdb-emulator.This SDK version requires the latest version of Azure Cosmos DB Emulator available for download from https://aka.ms/cosmosdb-emulator.

1.18.11.18.1

  • Microsoft arkadaş Derlemeleriyle ilgili dahili değişiklikler.Internal changes for Microsoft friends assemblies.

1.18.01.18.0

  • Birçok güvenilirlik düzeltmeleri ve geliştirmeleri eklendi.Added several reliability fixes and improvements.

1.17.01.17.0

  • Sorgu Sonuçları belirli bir bölüm anahtar aralığı değeri için kapsam için bir FeedOption olarak PartitionKeyRangeId desteği eklendi.Added support for PartitionKeyRangeId as a FeedOption for scoping query results to a specific partition key range value.
  • Bundan sonra değişikliklerin bakmaya başlamak için bir ChangeFeedOption olarak StartTime desteği eklendi.Added support for StartTime as a ChangeFeedOption to start looking for the changes after that time.

1.16.11.16.1

  • Bir yığın taşması özel durumuna neden olabilir JsonSerializable sınıfında bir sorun düzeltildi.Fixed an issue in the JsonSerializable class that may cause a stack overflow exception.

1.16.01.16.0

  • JsonSerializerSettings 'in DocumentClient oluşturucusunda isteğe bağlı bir parametre olarak eklenmesi nedeniyle uygulamanın yeniden derlenmesi için gereken bir sorun düzeltildi.Fixed an issue that required recompiling of the application due to the introduction of JsonSerializerSettings as an optional parameter in the DocumentClient constructor.
  • DocumentClient Oluşturucusu, jsonserializersettings parametresinde geçiş yaparken varsayılan ConnectionPolicy ve en fazla bağlantı parametrelerine izin veren son parametre olarak JsonSerializerSettings 'i zorunlu olarak işaretledi.Marked the DocumentClient constructor obsolete that required JsonSerializerSettings as the last parameter to allow for default values of ConnectionPolicy and ConsistencyLevel parameters when passing in JsonSerializerSettings parameter.

1.15.01.15.0

  • Documentclientörneği oluşturulurken özel JsonSerializerSettings belirtilmesine yönelik destek eklendi.Added support for specifying custom JsonSerializerSettings while instantiating DocumentClient.

1.14.11.14.1

  • SSE4 yönergesini desteklemeyen ve Azure Cosmos DB SQL sorguları çalıştırırken bir şehir özel durumu oluşturan x64 makinelerin etkilendiğine ilişkin bir sorun düzeltildi.Fixed an issue that affected x64 machines that don’t support SSE4 instruction and throw an SEHException when running Azure Cosmos DB SQL queries.

1.14.01.14.0

  • Yeni bir tutarlılık düzeyi için destek eklendi ConsistentPrefix çağrılır.Added support for a new consistency level called ConsistentPrefix.
  • Tek tek bölümler için sorgu ölçümler için destek eklendi.Added support for query metrics for individual partitions.
  • Sorgular için devamlılık belirteci boyutunu sınırlamak için destek eklendi.Added support for limiting the size of the continuation token for queries.
  • Başarısız istekler için ayrıntılı izleme desteği eklendi.Added support for more detailed tracing for failed requests.
  • SDK'ın bazı performans iyileştirmeleri yapıldı.Made some performance improvements in the SDK.

1.13.41.13.4

  • 1.13.3 ile aynı işlev.Functionally same as 1.13.3. Bazı iç değişiklikler yapıldı.Made some internal changes.

1.13.31.13.3

  • 1.13.2 ile aynı işlev.Functionally same as 1.13.2. Bazı iç değişiklikler yapıldı.Made some internal changes.

1.13.21.13.2

  • Toplam sorgularında FeedOptions içinde sağlanan PartitionKey değeri yok sayıldı bir sorun düzeltildi.Fixed an issue that ignored the PartitionKey value provided in FeedOptions for aggregate queries.
  • Bölümler arası sorgu yürütme Order By Orta uçuş sırasında bölüm yönetimi saydam işlemede bir sorun düzeltildi.Fixed an issue in transparent handling of partition management during mid-flight cross-partition Order By query execution.

1.13.11.13.1

  • Bazı zaman uyumsuz API'leri ASP.NET bağlam içinde kullanıldığında kilitlenmeleri neden bir sorun düzeltildi.Fixed an issue which caused deadlocks in some of the async APIs when used inside ASP.NET context.

1.13.01.13.0

  • Belirli koşullar altında otomatik yük devretme karşı daha dayanıklı SDK yapmak için düzeltmeleri.Fixes to make SDK more resilient to automatic failover under certain conditions.

1.12.21.12.2

  • Bazen WebException neden olan bir sorun için çözüm: Uzak ad çözümlenemedi.Fix for an issue that occasionally causes a WebException: The remote name could not be resolved.
  • Doğrudan ReadDocumentAsync API'sine yeni aşırı yüklemeler ekleyerek türü belirtilmiş bir belgeyi okumak için destek eklendi.Added the support for directly reading a typed document by adding new overloads to ReadDocumentAsync API.

1.12.11.12.1

  • Toplama sorguları (sayısı, MIN, MAX, toplam ve ortalama) için LINQ desteği eklendi.Added LINQ support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG).
  • Olay işleyicisi kullanımından kaynaklanan ConnectionPolicy nesne için bir bellek sızıntısı sorunu düzeltildi.Fix for a memory leak issue for the ConnectionPolicy object caused by the use of event handler.
  • ETag kullanıldığında burada görüntülerle UpsertAttachmentAsync çalıştığı olmayan bir sorunu düzeltin.Fix for an issue wherein UpsertAttachmentAsync was not working when ETag was used.
  • Burada görüntülerle sorgu devamlılığı sırası tarafından çapraz bölüm sıralarken dize alanı üzerinde çalıştığı değil bir sorun düzeltildi.Fix for an issue wherein cross partition order-by query continuation was not working when sorting on string field.

1.12.01.12.0

  • Toplama sorguları (sayısı, MIN, MAX, toplam ve ortalama) için destek eklendi.Added support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG). Bkz: toplama Destek.See Aggregation support.
  • Bölümlenmiş koleksiyonlardan 10,100 RU/sn 2500 RU/sn için en düşük aktarım hızını düşürdü.Lowered minimum throughput on partitioned collections from 10,100 RU/s to 2500 RU/s.

1.11.41.11.4

  • 32 bit ana bilgisayar işleminde bazı çapraz bölüm sorgularının başarısız olduğu bir sorunu giderme.Fix for an issue wherein some of the cross-partition queries were failing in the 32-bit host process.
  • Oturum kapsayıcısının Ağ Geçidi modundaki başarısız isteklerin belirteciyle güncelleştirilmemiş bir sorun için çözüm.Fix for an issue wherein the session container was not being updated with the token for failed requests in Gateway mode.
  • Bazı durumlarda projeksiyondaki UDF çağrılarına sahip bir sorgunun başarısız olduğu bir sorun için çözüm.Fix for an issue wherein a query with UDF calls in projection was failing in some cases.
  • İsteklerin okuma ve yazma verimini artırmak için istemci tarafı performans düzeltmeleri.Client side performance fixes for increasing the read and write throughput of the requests.

1.11.31.11.3

  • Oturum kapsayıcısının başarısız istekler için belirteçle güncelleştirilmemiş bir sorun için çözüm.Fix for an issue wherein the session container was not being updated with the token for failed requests.
  • SDK 'nın 32 bitlik bir ana bilgisayar işleminde çalışması için destek eklendi.Added support for the SDK to work in a 32-bit host process. Çapraz bölüm sorguları kullanıyorsanız, gelişmiş performans için 64 bit ana bilgisayar işlemenin önerildiğini unutmayın.Note that if you use cross partition queries, 64-bit host processing is recommended for improved performance.
  • Bir ın ifadesinde çok sayıda bölüm anahtarı değeri olan sorgular içeren senaryolar için iyileştirilmiş performans.Improved performance for scenarios involving queries with a large number of partition key values in an IN expression.
  • Populatequotaınfo istek seçeneği ayarlandığında belge koleksiyonu okuma istekleri için Resourceresıstadaki çeşitli kaynak kotası istatistikleri dolduruldu.Populated various resource quota stats in the ResourceResponse for document collection read requests when PopulateQuotaInfo request option is set.

1.11.11.11.1

  • 1.11.0 ' de tanıtılan CreateDocumentCollectionIfNotExistsAsync API 'sinin düşük performans düzeltmesini.Minor performance fix for the CreateDocumentCollectionIfNotExistsAsync API introduced in 1.11.0.
  • Yüksek derecede eşzamanlı istek içeren senaryolar için SDK 'da performans onarımı.Performance fix in the SDK for scenarios that involve high degree of concurrent requests.

1.11.01.11.0

  • Bir koleksiyon içindeki belgelerin değişiklik akışını işlemeye yönelik yeni sınıflar ve yöntemler için destek.Support for new classes and methods to process the change feed of documents within a collection.
  • Bölümler arası sorgu devamlılığını ve çapraz bölüm sorguları için bazı performans iyileştirmeleri için destek.Support for cross-partition query continuation and some perf improvements for cross-partition queries.
  • CreateDatabaseIfNotExistsAsync ve CreateDocumentCollectionIfNotExistsAsync yöntemlerinin eklenmesi.Addition of CreateDatabaseIfNotExistsAsync and CreateDocumentCollectionIfNotExistsAsync methods.
  • Sistem işlevleri için LINQ desteği: IsDefined, IsNull ve ısilkel.LINQ support for system functions: IsDefined, IsNull and IsPrimitive.
  • NuGet paketini Project. JSON araçları olan projelerle birlikte kullanırken, Microsoft. Azure. Documents. Serviceınterop. dll ve DocumentDB. uzamsal. Sql. dll derlemelerinin uygulamanın bin klasörüne otomatik olarak yerleştirilmesi için çözüm yapın.Fix for automatic binplacing of Microsoft.Azure.Documents.ServiceInterop.dll and DocumentDB.Spatial.Sql.dll assemblies to application’s bin folder when using the Nuget package with projects that have project.json tooling.
  • Hata ayıklama senaryolarında yararlı olabilecek istemci tarafı ETW izlemelerini yayma desteği.Support for emitting client side ETW traces which could be helpful in debugging scenarios.

1.10.01.10.0

  • Bölümlenmiş koleksiyonlar için doğrudan bağlantı desteği eklendi.Added direct connectivity support for partitioned collections.
  • Sınırlanmış Stalet tutarlılığı düzeyi için iyileştirilmiş performans.Improved performance for the Bounded Staleness consistency level.
  • Eklenen Çokgen ve dizin oluşturma ilkesi şirketin coğrafı uzamsal sorgular için koleksiyon belirtirken LineString veri türleri.Added Polygon and LineString DataTypes while specifying collection indexing policy for geo-fencing spatial queries.
  • Koşullar çevrilirken StringEnumConverter, IsoDateTimeConverter ve UnixDateTimeConverter için LINQ desteği eklendi.Added LINQ support for StringEnumConverter, IsoDateTimeConverter and UnixDateTimeConverter while translating predicates.
  • Çeşitli SDK hata düzeltmeleri.Various SDK bug fixes.

1.9.51.9.5

  • Aşağıdaki NotFoundException neden olan bir sorun düzeltildi: Giriş oturum belirteci için oku oturumu kullanılamaz.Fixed an issue that caused the following NotFoundException: The read session is not available for the input session token. Bu özel durum, coğrafi olarak dağıtılmış bir hesabın okuma bölgesi sorgulanırken bazı durumlarda meydana geldi.This exception occurred in some cases when querying for the read-region of a geo-distributed account.
  • Bir yanıttan temeldeki akışa doğrudan erişim sağlayan Resourceresıse sınıfında ResponseStream özelliği kullanıma sunuldu.Exposed the ResponseStream property in the ResourceResponse class, which enables direct access to the underlying stream from a response.

1.9.41.9.4

  • Resourceresrar, FeedResponse, StoredProcedureResponse ve Mediaresrarclasses ' ı, test odaklı dağıtım (TDD) için mocize erişebilmeleri için karşılık gelen ortak arabirimi uygulayacak şekilde değiştirdi.Modified the ResourceResponse, FeedResponse, StoredProcedureResponse and MediaResponse classes to implement the corresponding public interface so that they can be mocked for test driven deployment (TDD).
  • Verileri seri hale getirmek için özel bir JsonSerializerSettings nesnesi kullanılırken hatalı biçimlendirilmiş bölüm anahtarı başlığına neden olan bir sorun düzeltildi.Fixed an issue that caused a malformed partition key header when using a custom JsonSerializerSettings object for serializing data.

1.9.31.9.3

  • Uzun süre çalışan sorguların hata vererek başarısız olmasına neden olan bir sorun düzeltildi: Yetkilendirme belirteci geçerli zamanda geçerli değil.Fixed an issue that caused long running queries to fail with error: Authorization token is not valid at the current time.
  • Özgün SqlParameterCollection 'ı, kesit üst/sıra sorgularının içinden kaldıran bir sorun düzeltildi.Fixed an issue that removed the original SqlParameterCollection from cross partition top/order-by queries.

1.9.21.9.2

  • Bölümlenmiş koleksiyonlar için paralel sorgular için destek eklendi.Added support for parallel queries for partitioned collections.
  • Bölümler arası SıRALAMA için ve bölümlenmiş koleksiyonlar için üst sorgulara yönelik destek eklendi.Added support for cross partition ORDER BY and TOP queries for partitioned collections.
  • Azure Cosmos DB NuGet paketine yönelik bir başvuruya sahip bir Azure Cosmos DB projesine başvururken gerekli olan DocumentDB. uzamsal. Sql. dll ve Microsoft. Azure. Documents. Serviceınterop. dll için eksik başvurular düzeltildi.Fixed the missing references to DocumentDB.Spatial.Sql.dll and Microsoft.Azure.Documents.ServiceInterop.dll that are required when referencing an Azure Cosmos DB project with a reference to the Azure Cosmos DB Nuget package.
  • LINQ içinde Kullanıcı tanımlı işlevler kullanılırken farklı türlerin parametrelerini kullanma özelliği düzeltildi.Fixed the ability to use parameters of different types when using user-defined functions in LINQ.
  • Dünya dışı çağrıların yazma konumları yerine okuma konumlarına yönlendirildiği küresel olarak çoğaltılan hesaplar için bir hata düzeltildi.Fixed a bug for globally replicated accounts where Upsert calls were being directed to read locations instead of write locations.
  • Eksik olan ıdocumentclient arabirimine Yöntemler eklendi:Added methods to the IDocumentClient interface that were missing:
    • MediaStream ve seçenekleri parametre olarak alan UpsertAttachmentAsync yöntemiUpsertAttachmentAsync method that takes mediaStream and options as parameters
    • Parametre olarak seçenekleri alan CreateAttachmentAsync yöntemiCreateAttachmentAsync method that takes options as a parameter
    • QuerySpec 'i parametre olarak alan CreateOfferQuery yöntemi.CreateOfferQuery method that takes querySpec as a parameter.
  • Idocumentclient arabiriminde kullanıma sunulan korumasız ortak sınıflar.Unsealed public classes that are exposed in the IDocumentClient interface.

1.8.01.8.0

  • Çoklu bölge veritabanı hesapları için destek eklendi.Added the support for multi-region database accounts.
  • Kısıtlanmış isteklerde yeniden deneme desteği eklendi.Added support for retry on throttled requests. Kullanıcı, ConnectionPolicy. RetryOptions özelliğini yapılandırarak yeniden deneme sayısını ve en uzun bekleme süresini özelleştirebilir.User can customize the number of retries and the max wait time by configuring the ConnectionPolicy.RetryOptions property.
  • Tüm DocumentClient özelliklerinin ve yöntemlerinin imzalarını tanımlayan yeni bir ıdocumentclient arabirimi eklendi.Added a new IDocumentClient interface that defines the signatures of all DocumentClient properties and methods. Bu değişikliğin bir parçası olarak, IQueryable ve IOrderedQueryable oluşturan genişletme yöntemleri de DocumentClient sınıfının yöntemlerine değişti.As part of this change, also changed extension methods that create IQueryable and IOrderedQueryable to methods on the DocumentClient class itself.
  • Belirli bir Azure Cosmos DB uç noktası URI 'Si için ServicePoint. ConnectionLimit ayarlamak üzere yapılandırma seçeneği eklendi.Added configuration option to set the ServicePoint.ConnectionLimit for a given Azure Cosmos DB endpoint Uri. 50 olarak ayarlanan varsayılan değeri değiştirmek için ConnectionPolicy. MaxConnectionLimit komutunu kullanın.Use ConnectionPolicy.MaxConnectionLimit to change the default value, which is set to 50.
  • Kullanım dışı bırakılmış IPartitionResolver ve uygulaması.Deprecated IPartitionResolver and its implementation. IPartitionResolver desteği artık kullanılmıyor.Support for IPartitionResolver is now obsolete. Daha yüksek depolama ve aktarım hızı için bölümlenmiş koleksiyonlar kullanmanız önerilir.It's recommended that you use Partitioned Collections for higher storage and throughput.

1.7.11.7.1

  • Bir parametre olarak RequestOptions alan URI tabanlı ExecuteStoredProcedureAsync metoduna aşırı yükleme eklendi.Added an overload to Uri based ExecuteStoredProcedureAsync method that takes RequestOptions as a parameter.

1.7.01.7.0

  • Belgeler için eklenen zaman canlı (TTL) desteği.Added time to live (TTL) support for documents.

1.6.31.6.3

  • Azure bulut hizmeti çözümünün bir parçası olarak paketlenmesi için .NET SDK 'nın NuGet paketinizdeki bir hata düzeltildi.Fixed a bug in Nuget packaging of .NET SDK for packaging it as part of an Azure Cloud Service solution.

1.6.21.6.2

1.5.31.5.3

  • [Düzeltildi] Azure Cosmos DB uç noktası sorgulaması: ' System .net. http. HttpRequestException: İçerik bir akışa kopyalanırken hata oluştu '.[Fixed] Querying Azure Cosmos DB endpoint throws: 'System.Net.Http.HttpRequestException: Error while copying content to a stream'.

1.5.21.5.2

  • Sayfalama, Koşullu ifadeler ve Aralık karşılaştırması için yeni işleçler dahil olmak üzere genişletilmiş LINQ desteği.Expanded LINQ support including new operators for paging, conditional expressions, and range comparison.
    • LINQ 'te en ıyı davranışı seçme özelliğini etkinleştirmek için işleç alTake operator to enable SELECT TOP behavior in LINQ
    • Dize aralığı karşılaştırmaları etkinleştirmek için CompareTo işleciCompareTo operator to enable string range comparisons
    • Koşullu (?) ve birleşim işleçleri (??)Conditional (?) and coalesce operators (??)
  • [Düzeltildi] Bir LINQ sorgusunda model projeksiyonunu birleştiren ArgumentOutOfRangeException.[Fixed] ArgumentOutOfRangeException when combining Model projection with Where-In in a LINQ query. #81#81

1.5.11.5.1

  • [Düzeltildi] Select, son ifade değilse, LINQ sağlayıcısı projeksiyonu kabul etmez ve SELECT * yanlış seçeneğini belirleyin.[Fixed] If Select is not the last expression the LINQ Provider assumed no projection and produced SELECT * incorrectly. #58#58

1.5.01.5.0

  • Uygulanan upsert, eklenen UpsertXXXAsync yöntemleriImplemented Upsert, Added UpsertXXXAsync methods
  • Tüm istekler için performans iyileştirmeleriPerformance improvements for all requests
  • Dizeler için koşullu, birleşim ve CompareTo yöntemlerine yönelik LINQ sağlayıcı desteğiLINQ Provider support for conditional, coalesce, and CompareTo methods for strings
  • [Düzeltildi] LINQ sağlayıcısı--> IEnumerable ve Array üzerinde aynı SQL ile oluşturmak için listedeki yöntemi Içerir[Fixed] LINQ provider --> Implement Contains method on List to generate the same SQL as on IEnumerable and Array
  • [Düzeltildi] BackoffRetryUtility yeniden deneme sırasında yeni bir tane oluşturmak yerine aynı HttpRequestMessage 'i kullanır[Fixed] BackoffRetryUtility uses the same HttpRequestMessage again instead of creating a new one on retry
  • [Geçersiz] UriFactory. CreateCollection--> Şimdi UriFactory. CreateDocumentCollection kullanması gerekir[Obsolete] UriFactory.CreateCollection --> should now use UriFactory.CreateDocumentCollection

1.4.11.4.1

  • [Düzeltildi] NL-NL vb. gibi kültür olmayan bilgiler kullanılırken yerelleştirme sorunları.[Fixed] Localization issues when using non en culture info such as nl-NL, etc.

1.4.01.4.0

  • KIMLIK tabanlı yönlendirme eklendiAdded ID-based routing
    • KIMLIK tabanlı kaynak bağlantıları oluşturmayla ilgili yardım almak için yeni UriFactory YardımcısıNew UriFactory helper to assist with constructing ID-based resource links
    • DocumentClient 'ta URI içinde gerçekleştirilecek yeni aşırı yüklemelerNew overloads on DocumentClient to take in URI
  • Jeo-uzamsal için LINQ içinde IsValid () ve ıvaliddetailed () eklendiAdded IsValid() and IsValidDetailed() in LINQ for geospatial
  • LINQ sağlayıcısı desteği geliştirildi:LINQ Provider support enhanced:
    • Math -ABS, acos, asin, atan, tavan, cos, exp, Floor, log, log10, Pow, yuvarlak, Sign, sin, sqrt, tan, TruncateMath - Abs, Acos, Asin, Atan, Ceiling, Cos, Exp, Floor, Log, Log10, Pow, Round, Sign, Sin, Sqrt, Tan, Truncate
    • Dize -Concat, Contains, EndsWith, IndexOf, Count, ToLower, kırma, Replace, Reverse, TrimEnd, StartsWith, SUBSTRING, ToUpperString - Concat, Contains, EndsWith, IndexOf, Count, ToLower, TrimStart, Replace, Reverse, TrimEnd, StartsWith, SubString, ToUpper
    • Dizi -Concat, Contains, CountArray - Concat, Contains, Count
    • In işleciIN operator

1.3.01.3.0

  • Dizin oluşturma ilkelerini değiştirme desteği eklendi.Added support for modifying indexing policies.
    • DocumentClient 'da yeni ReplaceDocumentCollectionAsync yöntemiNew ReplaceDocumentCollectionAsync method in DocumentClient
    • Kaynak İlkesi değişikliklerinin tamamlanma yüzdesini izlemek için<resourcereslationt ' de yeni ındexdönüşümtionprogress özelliği >New IndexTransformationProgress property in ResourceResponse<T> for tracking percent progress of index policy changes
    • DocumentCollection. ındexingpolicy artık değişebilirDocumentCollection.IndexingPolicy is now mutable
  • Uzamsal dizin oluşturma ve sorgu için destek eklendi.Added support for spatial indexing and query.
    • Nokta ve çokgen gibi uzamsal türleri serileştirmek/seri durumdan çıkarmak için yeni Microsoft. Azure. Documents. uzamsal ad alanıNew Microsoft.Azure.Documents.Spatial namespace for serializing/deserializing spatial types like Point and Polygon
    • Cosmos DB depolanan GeoJSON verilerinin dizinini oluşturmak için yeni Spatialındex sınıfıNew SpatialIndex class for indexing GeoJSON data stored in Cosmos DB
  • [Düzeltildi] Bir LINQ ifadesinden #38yanlış SQL sorgusu oluşturuldu.[Fixed] Incorrect SQL query generated from a LINQ expression #38.

1.2.01.2.0

  • Newtonsoft. JSON v 5.0.7 üzerine bir bağımlılık ekledi.Added a dependency on Newtonsoft.Json v5.0.7.

  • Aşağıdakileri yaparak sıralamayı desteklemek için değişiklikler yapıldı:Made changes to support Order By:

    • OrderBy () veya OrderByDescending () için LINQ sağlayıcı desteğiLINQ provider support for OrderBy() or OrderByDescending()

    • Sıralamayı desteklemek için ındexingpolicyIndexingPolicy to support Order By

      Olası Son değişiklikPossible breaking change

      Özel bir dizin oluşturma ilkesiyle koleksiyonlar sağlayan mevcut kodunuz varsa, yeni ındexingpolicy sınıfını desteklemek için mevcut kodunuzun güncelleştirilmesi gerekir.If you have existing code that provisions collections with a custom indexing policy, then your existing code needs to be updated to support the new IndexingPolicy class. Özel bir dizin oluşturma ilkeniz yoksa, bu değişiklik sizi etkilemez.If you have no custom indexing policy, then this change does not affect you.

1.1.01.1.0

  • Yeni HashPartitionResolver ve RangePartitionResolver sınıfları ve IPartitionResolver kullanılarak bölümlendirme verileri için destek eklendi.Added support for partitioning data by using the new HashPartitionResolver and RangePartitionResolver classes and the IPartitionResolver.
  • DataContract serileştirme eklendi.Added DataContract serialization.
  • LINQ sağlayıcısında GUID desteği eklendi.Added GUID support in LINQ provider.
  • LINQ 'te UDF desteği eklendi.Added UDF support in LINQ.

1.0.01.0.0

  • GA SDK'SIGA SDK

Yayın & kullanımdan kaldırma tarihleriRelease & Retirement dates

Microsoft, daha yeni/desteklenen bir sürüme geçişi düzgünleştirmek için SDK 'nın devre dışı bırakılmasının ardından en az 12 ay önce bildirim sağlar.Microsoft provides notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version.

Yeni özellikler ve işlevler ve iyileştirmeler yalnızca geçerli SDK 'ya eklenir, bu nedenle en son SDK sürümüne her zaman olabildiğince erken yükseltmeniz önerilir.New features and functionality and optimizations are only added to the current SDK, as such it is recommended that you always upgrade to the latest SDK version as early as possible.

Kullanımdan kaldırılan bir SDK kullanarak Azure Cosmos DB yönelik istekler hizmet tarafından reddedilir.Any requests to Azure Cosmos DB using a retired SDK are rejected by the service.

Uyarı

SQL API için .NET SDK 'sının tüm 1. x sürümleri 30 Ağustos 2020tarihinde kullanımdan kaldırılacaktır.All versions 1.x of the .NET SDK for SQL API will be retired on August 30, 2020.


VersionVersion Yayınlanma TarihiRelease Date Sona erme tarihiRetirement Date
2.6.02.6.0 30 Ağustos 2019August 30, 2019 ---
2.5.12.5.1 02 Temmuz 2019July 02, 2019 ---
2.4.12.4.1 20 Haziran 2019June 20, 2019 ---
2.4.02.4.0 05 Mayıs 2019May 05, 2019 ---
2.3.02.3.0 04 Nisan 2019April 04, 2019 ---
2.2.32.2.3 11 Şubat 2019February 11, 2019 ---
2.2.22.2.2 06 Şubat 2019February 06, 2019 ---
2.2.12.2.1 24 Aralık 2018December 24, 2018 ---
2.2.02.2.0 07 Aralık 2018December 07, 2018 ---
2.1.32.1.3 15 Ekim 2018October 15, 2018 ---
2.1.2'yi2.1.2 04 Ekim 2018October 04, 2018 ---
2.1.12.1.1 27 Eylül 2018'denSeptember 27, 2018 ---
2.1.02.1.0 21 Eylül 2018September 21, 2018 ---
2.0.02.0.0 07 Eylül 2018'denSeptember 07, 2018 ---
1.22.01.22.0 19 Nisan 2018April 19, 2018 30 Ağustos 2020August 30, 2020
1.21.11.21.1 09 Mart 2018March 09, 2018 30 Ağustos 2020August 30, 2020
1.20.21.20.2 21 Şubat 2018February 21, 2018 30 Ağustos 2020August 30, 2020
1.20.11.20.1 05 Şubat 2018February 05, 2018 30 Ağustos 2020August 30, 2020
1.19.11.19.1 16 Kasım 2017November 16, 2017 30 Ağustos 2020August 30, 2020
1.19.01.19.0 10 Kasım 2017November 10, 2017 30 Ağustos 2020August 30, 2020
1.18.11.18.1 Kasım 07, 2017November 07, 2017 30 Ağustos 2020August 30, 2020
1.18.01.18.0 17 Ekim 2017October 17, 2017 30 Ağustos 2020August 30, 2020
1.17.01.17.0 10 Ağustos 2017August 10, 2017 30 Ağustos 2020August 30, 2020
1.16.11.16.1 07 Ağustos 2017August 07, 2017 30 Ağustos 2020August 30, 2020
1.16.01.16.0 02 Ağustos 2017August 02, 2017 30 Ağustos 2020August 30, 2020
1.15.01.15.0 30 Haziran 2017June 30, 2017 30 Ağustos 2020August 30, 2020
1.14.11.14.1 23 Mayıs 2017May 23, 2017 30 Ağustos 2020August 30, 2020
1.14.01.14.0 10 Mayıs 2017May 10, 2017 30 Ağustos 2020August 30, 2020
1.13.41.13.4 09 Mayıs 2017May 09, 2017 30 Ağustos 2020August 30, 2020
1.13.31.13.3 06 Mayıs 2017May 06, 2017 30 Ağustos 2020August 30, 2020
1.13.21.13.2 19 Nisan 2017April 19, 2017 30 Ağustos 2020August 30, 2020
1.13.11.13.1 29 Mart 2017March 29, 2017 30 Ağustos 2020August 30, 2020
1.13.01.13.0 24 Mart 2017March 24, 2017 30 Ağustos 2020August 30, 2020
1.12.21.12.2 20 Mart 2017March 20, 2017 30 Ağustos 2020August 30, 2020
1.12.11.12.1 14 Mart 2017March 14, 2017 30 Ağustos 2020August 30, 2020
1.12.01.12.0 15 Şubat 2017February 15, 2017 30 Ağustos 2020August 30, 2020
1.11.41.11.4 06 Şubat 2017February 06, 2017 30 Ağustos 2020August 30, 2020
1.11.31.11.3 26 Ocak 2017January 26, 2017 30 Ağustos 2020August 30, 2020
1.11.11.11.1 21 aralık 2016December 21, 2016 30 Ağustos 2020August 30, 2020
1.11.01.11.0 08 Aralık 2016December 08, 2016 30 Ağustos 2020August 30, 2020
1.10.01.10.0 27 Eylül 2016September 27, 2016 30 Ağustos 2020August 30, 2020
1.9.51.9.5 01 Eylül 2016September 01, 2016 30 Ağustos 2020August 30, 2020
1.9.41.9.4 24 Ağustos 2016August 24, 2016 30 Ağustos 2020August 30, 2020
1.9.31.9.3 15 Ağustos 2016August 15, 2016 30 Ağustos 2020August 30, 2020
1.9.21.9.2 23 Temmuz 2016July 23, 2016 30 Ağustos 2020August 30, 2020
1.8.01.8.0 14 Haziran 2016June 14, 2016 30 Ağustos 2020August 30, 2020
1.7.11.7.1 06 Mayıs 2016May 06, 2016 30 Ağustos 2020August 30, 2020
1.7.01.7.0 26 Nisan 2016April 26, 2016 30 Ağustos 2020August 30, 2020
1.6.31.6.3 08 Nisan 2016April 08, 2016 30 Ağustos 2020August 30, 2020
1.6.21.6.2 29 Mart 2016March 29, 2016 30 Ağustos 2020August 30, 2020
1.5.31.5.3 19 Şubat 2016February 19, 2016 30 Ağustos 2020August 30, 2020
1.5.21.5.2 14 Aralık 2015December 14, 2015 30 Ağustos 2020August 30, 2020
1.5.11.5.1 23 Kasım 2015November 23, 2015 30 Ağustos 2020August 30, 2020
1.5.01.5.0 05 Ekim 2015October 05, 2015 30 Ağustos 2020August 30, 2020
1.4.11.4.1 25 Ağustos 2015August 25, 2015 30 Ağustos 2020August 30, 2020
1.4.01.4.0 13 Ağustos 2015August 13, 2015 30 Ağustos 2020August 30, 2020
1.3.01.3.0 05 Ağustos 2015August 05, 2015 30 Ağustos 2020August 30, 2020
1.2.01.2.0 06 Temmuz 2015July 06, 2015 30 Ağustos 2020August 30, 2020
1.1.01.1.0 30 Nisan 2015April 30, 2015 30 Ağustos 2020August 30, 2020
1.0.01.0.0 08 Nisan 2015April 08, 2015 30 Ağustos 2020August 30, 2020

SSSFAQ

1. Müşteriler, retiring SDK'sının nasıl bildirilecek?1. How will customers be notified of the retiring SDK?

Microsoft, desteklenen bir SDK'sı için sorunsuz bir geçiş kolaylaştırmak için 12 aylık sağladığımız ön bildirimi desteğin sona ermesi için retiring SDK'sının sağlayacaktır.Microsoft will provide 12 month advance notification to the end of support of the retiring SDK in order to facilitate a smooth transition to a supported SDK. Ayrıca, müşteriler çeşitli iletişim kanalları – Azure Yönetim Portalı, Geliştirici Merkezi aracılığıyla Web günlüğü gönderisinde bildirilir ve doğrudan iletişim için atanan hizmet yöneticileri.Further, customers will be notified through various communication channels – Azure Management Portal, Developer Center, blog post, and direct communication to assigned service administrators.

2. Müşterilere 12 aylık dönem boyunca bir "yüklenecek" devre dışı bırakılan Azure Cosmos DB SDK'sını kullanarak uygulamaları yazabilirsiniz?2. Can customers author applications using a "to-be" retired Azure Cosmos DB SDK during the 12 month period?

Evet, müşteriler yazar, dağıtmak ve 12 aylık yetkisiz kullanım süresi sırasında "yüklenecek" devre dışı bırakılan Azure Cosmos DB SDK'sını kullanan uygulamaları değiştirmek için tam erişim gerekir.Yes, customers will have full access to author, deploy and modify applications using the "to-be" retired Azure Cosmos DB SDK during the 12 month grace period. Yetkisiz kullanım süresi 12 ay, müşteriler desteklenen Azure Cosmos DB SDK sürümü daha yeni uygun şekilde geçirmek için önerilir.During the 12 month grace period, customers are advised to migrate to a newer supported version of Azure Cosmos DB SDK as appropriate.

3. Müşteriler yazabilir ve 12 aylık bildirim sonunda devre dışı bırakılan bir Azure Cosmos DB SDK kullanan uygulamaları değiştirmek mi?3. Can customers author and modify applications using a retired Azure Cosmos DB SDK after the 12 month notification period?

12 aylık bildirim süresinden sonra SDK'sı kullanımdan kaldırılacaktır.After the 12 month notification period, the SDK will be retired. Azure Cosmos DB platformu tarafından herhangi bir Azure Cosmos DB erişimi devre dışı bırakılan bir SDK'sını kullanarak bir uygulama tarafından izin verilmez.Any access to Azure Cosmos DB by an applications using a retired SDK will not be permitted by the Azure Cosmos DB platform. Ayrıca, Microsoft müşteri desteği devre dışı bırakılan SDK'sı üzerinde sağlamaz.Further, Microsoft will not provide customer support on the retired SDK.

4. Müşterinin ne desteklenmeyen bir Azure Cosmos DB SDK sürümü kullanan uygulamaları çalıştıran?4. What happens to Customer’s running applications that are using unsupported Azure Cosmos DB SDK version?

Devre dışı bırakılan bir SDK sürümü ile Azure Cosmos DB hizmetine bağlanmak için yapılan tüm denemeleri reddedilir.Any attempts made to connect to the Azure Cosmos DB service with a retired SDK version will be rejected.

5. Yeni özellikler ve İşlevler için tüm olmayan kullanımdan kaldırılacak SDKs uygulanır?5. Will new features and functionality be applied to all non-retired SDKs?

Yeni özellikler ve işlevler yalnızca yeni sürümlere eklenecektir.New features and functionality will only be added to new versions. SDK'ın eski, olmayan-kullanımdan kaldırıldı, bir sürümünü kullanıyorsanız, isteklerinizi Azure Cosmos DB için önceki gibi çalışmaya devam eder ancak tüm yeni özelliklere erişebilir değil.If you are using an old, non-retired, version of the SDK your requests to Azure Cosmos DB will still function as previous but you will not have access to any new capabilities.

6. Uygulamamı bir sonlandırma tarihinden önce güncelleştiremiyorsanız ne yapmalıyım?6. What should I do if I cannot update my application before a cut-off date?

Son SDK'ın mümkün olduğunca erken yükseltmenizi öneririz.We recommend that you upgrade to the latest SDK as early as possible. Bir SDK'yı devre dışı bırakılması için etiketlendikten 12 ay uygulamanızı güncelleştirmeniz gerekir.Once an SDK has been tagged for retirement you will have 12 months to update your application. Herhangi bir nedenle, olamaz, bu zaman çerçevesi içinde uygulama güncelleştirmesi tamamlamanız ve ardından iletişim kurun, Cosmos DB takım ve kesme tarihinden önce bunların Yardım isteyin.If, for whatever reason, you cannot complete your application update within this timeframe then please contact the Cosmos DB Team and request their assistance before the cutoff date.

Ayrıca bkz.See also

Cosmos DB hakkında daha fazla bilgi için bkz: Microsoft Azure Cosmos DB hizmeti sayfası.To learn more about Cosmos DB, see Microsoft Azure Cosmos DB service page.