Azure Cosmos DB SQL API'si için .NET SDK: İndirme ve sürüm notlarıAzure 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

3.0.0.1-Preview3.0.0.1-preview

  • 1 önizlemesi sürüm 3.0.0 genel önizlemesi için .NET SDK'sının.Preview 1 of Version 3.0.0 of the .NET SDK for public preview.
  • Hedef .NET framework 4.6.1+ .NET ve .NET Core 2.0 + destekleyen standardıTarget .NET Standard, which supports .NET framework 4.6.1+ and .NET Core 2.0+
  • Yeni nesne modeli, üst düzey CosmosClient ve yöntemleri ile ilgili CosmosDatabases ve CosmosContainers CosmosItems sınıflar arasında bölün.New object model, with top-level CosmosClient and methods split across relevant CosmosDatabases, CosmosContainers and CosmosItems classes.
  • Akışları için destek.Support for streams.
  • Durum kodu döndürür ve yanıt döndürüldüğünde yalnızca durum sunucudan CosmosResponseMessage güncelleştirildi.Updated CosmosResponseMessage from server to return status code, and only throw exception when no response is returned.

2.5.12.5.1

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

2.4.12.4.1

  • Düzeltmeleri boş sayfalar neden sorgular için yarış durumu izlemeFixes tracing race condition for queries which caused empty pages

2.4.02.4.0

  • LINQ sorguları için Ondalık Duyarlığı boyutu artar.Increased decimal precision size for LINQ queries.
  • Yeni eklenen sınıflarda CompositePath CompositePathSortOrder, SpatialSpec SpatialType ve PartitionKeyDefinitionVersionAdded new classes CompositePath, CompositePathSortOrder, SpatialSpec, SpatialType and PartitionKeyDefinitionVersion
  • DocumentCollection için eklenen TimeToLivePropertyPathAdded TimeToLivePropertyPath to DocumentCollection
  • Eklenen CompositeIndexes ve SpatialIndexes IndexPolicy içinAdded CompositeIndexes and SpatialIndexes to IndexPolicy
  • Eklenen PartitionKeyDefinition sürümüneAdded Version to PartitionKeyDefinition
  • PartitionKey Yok'a eklendiAdded None to PartitionKey

2.3.02.3.0

  • Eklenen IdleTcpConnectionTimeout, OpenTcpConnectionTimeout, MaxRequestsPerTcpConnection ve MaxTcpConnectionsPerEndpoint ConnectionPolicy için.Added IdleTcpConnectionTimeout, OpenTcpConnectionTimeout, MaxRequestsPerTcpConnection and MaxTcpConnectionsPerEndpoint to ConnectionPolicy.

2.2.32.2.3

  • Tanılama geliştirmeleriDiagnostics improvements

2.2.22.2.2

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

  • DocumentDB.Spatial.Sql.dll kaldırılır ve artık Microsoft.Azure.Documents.ServiceInterop.dll dahilRemoved DocumentDB.Spatial.Sql.dll and now included in Microsoft.Azure.Documents.ServiceInterop.dll

2.2.12.2.1

  • Yeniden deneme mantığı için StoredProcedure gelişme yük devretme sırasında çağrıları yürütün.Improvement in retry logic during failover for StoredProcedure execute calls.

  • Yapılan DocumentClientEventSource tekli.Made DocumentClientEventSource singleton.

  • ConnectionPolicy RequestTimeout uygularken değil GatewayAddressCache zaman aşımı düzeltin.Fix GatewayAddressCache timeout not honoring ConnectionPolicy RequestTimeout.

2.2.02.2.0

  • Doğrudan/TCP taşıma tanılama için TransportException, SDK'sının bir iç özel durum türü eklediniz.For direct/TCP transport diagnostics, added TransportException, an internal exception type of the SDK. Bu tür, mevcut olduğunda özel durum iletileri, istemci bağlantısı sorunlarını gidermek için ek bilgi yazdırır.When present in exception messages, this type prints additional information for troubleshooting client connectivity problems.

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

  • Burada üstbilgisi null değerlerle düzgün bir şekilde işlenmemiş olan hata düzeltildi.Fix bug where header with null values were not being handled properly.

  • Koleksiyon önbellek doğrulama geliştirildi.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 geliş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.
  • Burada Item özniteliği LINQ sorguları için select yan tümcesinde değil kabul hata düzeltildi.Fixed bug where JsonProperty attribute in select clause for LINQ queries was not being honored.

1.20.21.20.2

  • Aralıklı olarak sonuçlanan belirli yarış koşulları altında isabet hata düzeltildi "Microsoft.Azure.Documents.NotFoundException: Oturum tutarlılık düzeyi kullanılırken okuma oturumu için giriş Oturum belirteci kullanılabilir değil"hata.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

  • İç değişiklik Microsoft arkadaş derlemeleri için.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

  • DocumentClient Oluşturucusu isteğe bağlı bir parametre olarak JsonSerializerSettings tanıtılması nedeniyle uygulama yeniden derlenmesi 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şturucusuna geçersiz ConsistencyLevel parametreleri ve varsayılan değerleri için ConnectionPolicy izin vermek için son parametre olarak, gerekli JsonSerializerSettings JsonSerializerSettings parametresinde geçerken işaretlenmiş.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

  • Özel bir JsonSerializerSettings örneği oluşturulurken belirtme desteği eklendi DocumentClient.Added support for specifying custom JsonSerializerSettings while instantiating DocumentClient.

1.14.11.14.1

  • X64 etkilenen bir sorun düzeltildi SSE4 yönerge desteği yoktur ve Azure Cosmos DB SQL sorgu çalıştırırken bir SEHException throw makineleri.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 işlevsel olarak aynıdır.Functionally same as 1.13.3. İç bazı değişiklikler yaptınız.Made some internal changes.

1.13.31.13.3

  • 1.13.2 işlevsel olarak aynıdır.Functionally same as 1.13.2. İç bazı değişiklikler yaptınız.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 bir WebException neden olan bir sorunu için düzeltme: 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

  • Gibi bazı bölümler arası sorgular 32-bit ana işlemde başarısız olduğu sorun düzeltildi.Fix for an issue wherein some of the cross-partition queries were failing in the 32-bit host process.
  • Burada görüntülerle oturumu kapsayıcı ağ geçidi modunda başarısız istekler için belirteci ile güncelleştirilmedi bir sorun düzeltildi.Fix for an issue wherein the session container was not being updated with the token for failed requests in Gateway mode.
  • Bazı durumlarda sorguda projeksiyon UDF çağrılarında burada görüntülerle gönderilememesi sorunu düzeltildi.Fix for an issue wherein a query with UDF calls in projection was failing in some cases.
  • İstemci tarafı performans okuma ve yazma istekleri verimini artırmak için düzeltir.Client side performance fixes for increasing the read and write throughput of the requests.

1.11.31.11.3

  • Burada görüntülerle oturumu kapsayıcı başarısız istekler için belirteci ile güncelleştirilmedi bir sorun düzeltildi.Fix for an issue wherein the session container was not being updated with the token for failed requests.
  • Bir 32-bit ana işlem olarak çalışacak şekilde SDK 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, 64-bit ana işleme daha iyi performans için önerilen unutmayın.Note that if you use cross partition queries, 64-bit host processing is recommended for improved performance.
  • Çok sayıda bölüm anahtarı değerlerine IN deyimde sorgularıyla ilgili senaryolar için performansı İyileştirildi.Improved performance for scenarios involving queries with a large number of partition key values in an IN expression.
  • Çeşitli kaynak kotası istatistikleri ResourceResponse belge koleksiyonu PopulateQuotaInfo isteği seçenek ayarlandığında okuma istekleri için de doldurulur.Populated various resource quota stats in the ResourceResponse for document collection read requests when PopulateQuotaInfo request option is set.

1.11.11.11.1

  • İçinde 1.11.0 Createdocumentcollectionıfnotexistsasync API'si için küçük bir performans düzeltme.Minor performance fix for the CreateDocumentCollectionIfNotExistsAsync API introduced in 1.11.0.
  • Performans, yüksek derecede eşzamanlı istek gerektiren senaryolar için SDK'sındaki düzeltin.Performance fix in the SDK for scenarios that involve high degree of concurrent requests.

1.11.01.11.0

  • Yeni sınıflar ve işlemek için yöntemler için destek değişiklik akışını , bir koleksiyonu içindeki belgeler.Support for new classes and methods to process the change feed of documents within a collection.
  • Bölümler arası sorgu devamlılık ve bölümler arası sorgular için bazı performans geliştirmeleri için destek.Support for cross-partition query continuation and some perf improvements for cross-partition queries.
  • Ayrıca Createdatabaseasync ve Createdocumentcollectionıfnotexistsasync yöntemleri.Addition of CreateDatabaseIfNotExistsAsync and CreateDocumentCollectionIfNotExistsAsync methods.
  • Sistem işlevleri için LINQ desteği: IsDefined, IsNull ve IsPrimitive.LINQ support for system functions: IsDefined, IsNull and IsPrimitive.
  • Project.json araç projeleri ile Nuget paketini kullanarak uygulamanın bin klasörüne Microsoft.Azure.Documents.ServiceInterop.dll ve DocumentDB.Spatial.Sql.dll derlemelerin otomatik binplacing düzeltildi.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ı yararlı olabilecek istemci tarafı ETW izlemeleri 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 eklenen doğrudan bağlantı desteği.Added direct connectivity support for partitioned collections.
  • Sınırlanmış eskime durumu tutarlılık düzeyi için performansı İyileştirildi.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 LINQ için destek eklendi StringEnumConverter ve IsoDateTimeConverter UnixDateTimeConverter.Added LINQ support for StringEnumConverter, IsoDateTimeConverter and UnixDateTimeConverter while translating predicates.
  • SDK çeşitli hata düzeltmeleri.Various SDK bug fixes.

1.9.51.9.5

  • Aşağıdaki NotFoundException kaynaklanan bir sorun düzeltildi: Okuma oturum giriş Oturum belirteci için kullanılabilir değil.Fixed an issue that caused the following NotFoundException: The read session is not available for the input session token. Bazı durumlarda coğrafi olarak dağıtılmış bir hesabı okuma-bölgesi için sorgulama bu özel durum oluştu.This exception occurred in some cases when querying for the read-region of a geo-distributed account.
  • Doğrudan erişim için temel alınan akışa bir yanıt sağlar sınıfını ResourceResponse ResponseStream özelliğinde ortaya çıkar.Exposed the ResponseStream property in the ResourceResponse class, which enables direct access to the underlying stream from a response.

1.9.41.9.4

  • Böylece dağıtım (TDD) tabanlı test için örnek karşılık gelen ortak arabirim uygulamak için ResourceResponse, FeedResponse StoredProcedureResponse ve MediaResponse sınıfları değiştirildi.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).
  • Hatalı biçimlendirilmiş bölüm anahtarı üstbilgi verilerin serileştirilmesi için özel bir JsonSerializerSettings nesne kullanırken 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üren sorgular başarısız olmasına neden olan hata ile bir sorun düzeltildi: Şu anda yetkilendirme belirteci 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.
  • Çapraz bölüm üst/sırası-by sorguları gelen özgün SqlParameterCollection kaldırılan 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.
  • Çapraz bölüm ORDER BY ve üst sorguları bölümlenmiş koleksiyonlar için eklenen desteği.Added support for cross partition ORDER BY and TOP queries for partitioned collections.
  • Azure Cosmos DB Nuget paketine başvuru ile bir Azure Cosmos DB projesi başvururken kullanılır eksik başvurular DocumentDB.Spatial.Sql.dll ve Microsoft.Azure.Documents.ServiceInterop.dll 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.
  • Kullanıcı tanımlı işlevler üzerinde LINQ kullanırken farklı türde parametreler kullanma olanağı düzeltildi.Fixed the ability to use parameters of different types when using user-defined functions in LINQ.
  • Burada Upsert çağrıları okuma yazma konumlar yerine konumları yönlendirilmesi genel 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 eklenen yöntemleri IDocumentClient arabirimine: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
    • Seçenekler, parametre olarak alır CreateAttachmentAsync yöntemiCreateAttachmentAsync method that takes options as a parameter
    • CreateOfferQuery yöntemi querySpec bir parametre olarak alır.CreateOfferQuery method that takes querySpec as a parameter.
  • IDocumentClient arabiriminde sunulan korumasız Genel 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.
  • Yeniden deneme sırasında daraltılmış istekler için destek eklendi.Added support for retry on throttled requests. Kullanıcı sayısını yeniden denemeler ve en fazla bekleme zamanı ConnectionPolicy.RetryOptions özelliğini yapılandırarak özelleştirebilirsiniz.User can customize the number of retries and the max wait time by configuring the ConnectionPolicy.RetryOptions property.
  • Tüm DocumentClient özellik ve yöntem imzaları tanımlayan yeni IDocumentClient 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 IOrderedQueryable DocumentClient sınıfındaki yöntemleri oluşturup genişletme yöntemleri de değiştirildi.As part of this change, also changed extension methods that create IQueryable and IOrderedQueryable to methods on the DocumentClient class itself.
  • Belirli Azure Cosmos DB uç noktası URI'si için ServicePoint.ConnectionLimit ayarlamak için ek yapılandırma seçeneği'ni kullanın.Added configuration option to set the ServicePoint.ConnectionLimit for a given Azure Cosmos DB endpoint Uri. ConnectionPolicy.MaxConnectionLimit 50 olarak ayarlandığını varsayılan değeri değiştirmek için kullanın.Use ConnectionPolicy.MaxConnectionLimit to change the default value, which is set to 50.
  • Kullanım dışı IPartitionResolver ve uygulanması.Deprecated IPartitionResolver and its implementation. IPartitionResolver desteği artık kullanımdan kalkmıştır.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

  • RequestOptions parametresi olarak alan ExecuteStoredProcedureAsync yöntemi aşırı URI'ye dayalı 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

  • .NET SDK'sı Nuget paketlenmesi, bir Azure bulut hizmeti çözümün bir parçası olarak paketlemek için 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] Sorgulama Azure Cosmos DB uç noktası oluşturur: 'System.Net.Http.HttpRequestException: Bir akışa içeriği 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

  • Genişletilmiş LINQ, disk belleği, koşullu ifade yeni işleçleri dahil olmak üzere destek ve karşılaştırma aralığı.Expanded LINQ support including new operators for paging, conditional expressions, and range comparison.
    • LINQ seçin üst davranışı etkinleştirmek için işleci AlTake operator to enable SELECT TOP behavior in LINQ
    • CompareTo işleci dize aralığı karşılaştırmaları etkinleştirmek içinCompareTo operator to enable string range comparisons
    • Koşullu (?) ve birleşim işleçlerini (?)Conditional (?) and coalesce operators (??)
  • [Düzeltildi] Modeli projeksiyon ile birleştirilirken üretiliyor nerede bileşeninde bir LINQ Sorgu.[Fixed] ArgumentOutOfRangeException when combining Model projection with Where-In in a LINQ query. #81#81

1.5.11.5.1

  • [Düzeltildi] LINQ sağlayıcısı seçin son deyim değilse, projeksiyon kabul ve SELECT üretilen * yanlış.[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 geliştirmeleriPerformance improvements for all requests
  • LINQ sağlayıcı desteği koşullu, coalesce ve dizeler için CompareTo YöntemiLINQ Provider support for conditional, coalesce, and CompareTo methods for strings
  • [Düzeltildi] LINQ sağlayıcısı--> IEnumerable ve dizi gibi aynı SQL oluşturulacak liste yöntemi uygulama içerir[Fixed] LINQ provider --> Implement Contains method on List to generate the same SQL as on IEnumerable and Array
  • [Düzeltildi] BackoffRetryUtility kullandığı aynı HttpRequestMessage yeniden denemedeki yeni bir tane oluşturmak yerine[Fixed] BackoffRetryUtility uses the same HttpRequestMessage again instead of creating a new one on retry
  • [Eski] UriFactory.CreateCollection--> UriFactory.CreateDocumentCollection kullanmak yerine artık[Obsolete] UriFactory.CreateCollection --> should now use UriFactory.CreateDocumentCollection

1.4.11.4.1

  • [Düzeltildi] Yerelleştirme, nl-NL, vb. gibi kültür bilgisi olmayan tr kullanırken 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şturma ile yardımcı olmak için yeni UriFactory YardımcısıNew UriFactory helper to assist with constructing ID-based resource links
    • Yeni aşırı yüklemeler URI almak için DocumentClient üzerindeNew overloads on DocumentClient to take in URI
  • IsValid() ve LINQ için Jeo-uzamsal IsValidDetailed() eklendiAdded IsValid() and IsValidDetailed() in LINQ for geospatial
  • Gelişmiş LINQ sağlayıcı desteği:LINQ Provider support enhanced:
    • Matematik -Abs, Acos, Asin, Atan, Exp, Floor, günlük, Log10, Pow, hepsini, oturum, Sin, Sqrt, Tan Cos Ceiling KesMath - Abs, Acos, Asin, Atan, Ceiling, Cos, Exp, Floor, Log, Log10, Pow, Round, Sign, Sin, Sqrt, Tan, Truncate
    • Dize -EndsWith, IndexOf, sayısı, ToLower, TrimStart Concat, içerir, Değiştir, ters TrimEnd, StartsWith, SubString, ToUpperString - Concat, Contains, EndsWith, IndexOf, Count, ToLower, TrimStart, Replace, Reverse, TrimEnd, StartsWith, SubString, ToUpper
    • Dizi -Concat, içerir, sayısıArray - Concat, Contains, Count
    • IN işleciIN operator

1.3.01.3.0

  • Dizin oluşturma ilkeleri değiştirmek için destek eklendi.Added support for modifying indexing policies.
    • DocumentClient yeni ReplaceDocumentCollectionAsync yöntemiNew ReplaceDocumentCollectionAsync method in DocumentClient
    • Yeni IndexTransformationProgress özelliğinde ResourceResponse dizin İlkesi değişikliklerinin yüzde ilerlemesini izlemek içinNew IndexTransformationProgress property in ResourceResponse for tracking percent progress of index policy changes
    • DocumentCollection.IndexingPolicy değişebilirDocumentCollection.IndexingPolicy is now mutable
  • Uzamsal dizin oluşturma ve sorgu için destek eklendi.Added support for spatial indexing and query.
    • Serileştirme/uzamsal türler seri durumdan çıkarmak için yeni Microsoft.Azure.Documents.Spatial ad alanı, nokta ve Çokgen gibiNew Microsoft.Azure.Documents.Spatial namespace for serializing/deserializing spatial types like Point and Polygon
    • Cosmos DB'de depolanan GeoJSON veri dizinini oluşturmak için yeni SpatialIndex sınıfıNew SpatialIndex class for indexing GeoJSON data stored in Cosmos DB
  • [Düzeltildi] Bir LINQ ifadesini oluşturulan hatalı SQL sorgusu #38.[Fixed] Incorrect SQL query generated from a LINQ expression #38.

1.2.01.2.0

  • Bir bağımlılık Newtonsoft.Json v5.0.7 üzerinde eklendi.Added a dependency on Newtonsoft.Json v5.0.7.

  • Order By desteklemek için değişiklikler:Made changes to support Order By:

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

    • Order By desteklemek için IndexingPolicyIndexingPolicy to support Order By

      Olası değişiklikPossible breaking change

      Özel bir dizin oluşturma ilkesini bu hükümleri koleksiyonlarla mevcut kodunuz varsa, mevcut kodunuzu yeni IndexingPolicy sınıfı destekleyecek şekilde 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. Ardından, hiçbir özel dizin oluşturma ilkesi varsa, bu değişiklik, 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 kullanarak verileri bölümleme 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.
  • Eklenen GUID LINQ sağlayıcısı destekler.Added GUID support in LINQ provider.
  • Eklenen UDF LINQ destekler.Added UDF support in LINQ.

1.0.01.0.0

  • GA SDK'SIGA SDK

Yayın & sona erme tarihleriRelease & Retirement dates

Microsoft'un sağladığı bildirim en az 12 ay yeni/desteklenen bir sürüme geçiş hafifletmek için bir SDK'yı devre dışı bırakmadan önce.Microsoft provides notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version.

Geçerli SDK'sı yalnızca eklenen yeni özellikler ve işlevsellik ve en iyi duruma getirme, bu nedenle, her zaman en son SDK sürümüne erken mümkün olduğunca 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.

Devre dışı bırakılan bir SDK'sı kullanarak Azure Cosmos DB yapılan tüm isteklere hizmet tarafından reddedilir.Any requests to Azure Cosmos DB using a retired SDK are rejected by the service.


VersionVersion Yayınlanma TarihiRelease Date Sona erme tarihiRetirement Date
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 Aralık 24 Mayıs 2018December 24, 2018 ---
2.2.02.2.0 07 aralık 2018'eDecember 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 ---
1.21.11.21.1 09 Mart 2018March 09, 2018 ---
1.20.21.20.2 21 Şubat 2018February 21, 2018 ---
1.20.11.20.1 05 Şubat 2018February 05, 2018 ---
1.19.11.19.1 16 Kasım 2017November 16, 2017 ---
1.19.01.19.0 10 Kasım 2017November 10, 2017 ---
1.18.11.18.1 07 Kasım 2017November 07, 2017 ---
1.18.01.18.0 17 Ekim 2017October 17, 2017 ---
1.17.01.17.0 10 Ağustos 2017August 10, 2017 ---
1.16.11.16.1 07 Ağustos 2017August 07, 2017 ---
1.16.01.16.0 02 Ağustos 2017August 02, 2017 ---
1.15.01.15.0 30 Haziran 2017June 30, 2017 ---
1.14.11.14.1 23 Mayıs 2017May 23, 2017 ---
1.14.01.14.0 10 Mayıs 2017May 10, 2017 ---
1.13.41.13.4 09 Mayıs 2017May 09, 2017 ---
1.13.31.13.3 06 Mayıs 2017May 06, 2017 ---
1.13.21.13.2 19 Nisan 2017April 19, 2017 ---
1.13.11.13.1 29 Mart 2017March 29, 2017 ---
1.13.01.13.0 24 Mart 2017March 24, 2017 ---
1.12.21.12.2 20 Mart 2017March 20, 2017 ---
1.12.11.12.1 14 Mart 2017March 14, 2017 ---
1.12.01.12.0 15 Şubat 2017February 15, 2017 ---
1.11.41.11.4 06 Şubat 2017February 06, 2017 ---
1.11.31.11.3 26 Ocak 2017January 26, 2017 ---
1.11.11.11.1 21 aralık 2016December 21, 2016 ---
1.11.01.11.0 08 Aralık 2016December 08, 2016 ---
1.10.01.10.0 27 Eylül 2016September 27, 2016 ---
1.9.51.9.5 01 Eylül 2016September 01, 2016 ---
1.9.41.9.4 24 Ağustos 2016August 24, 2016 ---
1.9.31.9.3 15 Ağustos 2016August 15, 2016 ---
1.9.21.9.2 23 Temmuz 2016July 23, 2016 ---
1.8.01.8.0 14 Haziran 2016June 14, 2016 ---
1.7.11.7.1 06 Mayıs 2016May 06, 2016 ---
1.7.01.7.0 26 Nisan 2016April 26, 2016 ---
1.6.31.6.3 08 Nisan 2016April 08, 2016 ---
1.6.21.6.2 29 Mart 2016March 29, 2016 ---
1.5.31.5.3 19 Şubat 2016February 19, 2016 ---
1.5.21.5.2 14 Aralık 2015December 14, 2015 ---
1.5.11.5.1 November 23, 2015November 23, 2015 ---
1.5.01.5.0 05 Ekim 2015October 05, 2015 ---
1.4.11.4.1 25 Ağustos 2015August 25, 2015 ---
1.4.01.4.0 13 Ağustos 2015August 13, 2015 ---
1.3.01.3.0 05 Ağustos 2015August 05, 2015 ---
1.2.01.2.0 06 Temmuz 2015July 06, 2015 ---
1.1.01.1.0 30 Nisan 2015April 30, 2015 ---
1.0.01.0.0 08 Nisan 2015April 08, 2015 ---

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.