SDK do .NET do Azure Cosmos DB para a API do SQL: Downloads e notas sobre a versãoAzure Cosmos DB .NET SDK for SQL API: Download and release notes

Baixe o SDKSDK download NuGetNuGet
Documentação da APIAPI documentation Documentação de referência de API .NET.NET API reference documentation
ExemplosSamples Exemplos de código .NET.NET code samples
IntroduçãoGet started Introdução ao SDK do .NET do Azure Cosmos DBGet started with the Azure Cosmos DB .NET SDK
Tutorial do aplicativo WebWeb app tutorial Desenvolvimento de aplicativos Web com o Azure Cosmos DBWeb application development with Azure Cosmos DB
Framework atualmente com suporteCurrent supported framework Microsoft .NET Framework 4.5Microsoft .NET Framework 4.5

Notas de versãoRelease notes

3.0.0.1-preview3.0.0.1-preview

  • Versão prévia 1 da Versão 3.0.0 do SDK .NET para visualização pública.Preview 1 of Version 3.0.0 of the .NET SDK for public preview.
  • O destino é .NET Standard, que dá suporte para .NET Framework 4.6.1+ e .NET Core 2.0+Target .NET Standard, which supports .NET framework 4.6.1+ and .NET Core 2.0+
  • Novo modelo de objeto, com CosmosClient de nível superior e métodos divididos entre as classes CosmosDatabases, CosmosContainers e CosmosItems.New object model, with top-level CosmosClient and methods split across relevant CosmosDatabases, CosmosContainers and CosmosItems classes.
  • Suporte para fluxos.Support for streams.
  • Atualizado CosmosResponseMessage do servidor para retornar o código de status e somente gerar exceção quando nenhuma resposta for retornada.Updated CosmosResponseMessage from server to return status code, and only throw exception when no response is returned.

2.5.12.5.1

  • Versão de HTTP do SDK agora coincide com o que é definido no pacote NuGet.SDK’s System.Net.Http version now matches what is defined in the NuGet package.
  • Permitir solicitações de gravação para fallback para uma região diferente se o original um falhar.Allow write requests to fallback to a different region if the original one fails.
  • Adicione política de repetição de sessão para a solicitação de gravação.Add session retry policy for write request.

2.4.12.4.1

  • Correções de rastreamento de condição de corrida para consultas que fazia com que páginas vaziasFixes tracing race condition for queries which caused empty pages

2.4.02.4.0

  • Aumentou o tamanho de precisão decimal para consultas LINQ.Increased decimal precision size for LINQ queries.
  • Classes adicionadas novas CompositePath, CompositePathSortOrder, SpatialSpec, SpatialType e PartitionKeyDefinitionVersionAdded new classes CompositePath, CompositePathSortOrder, SpatialSpec, SpatialType and PartitionKeyDefinitionVersion
  • Adicionado TimeToLivePropertyPath para DocumentCollectionAdded TimeToLivePropertyPath to DocumentCollection
  • Adicionado CompositeIndexes e SpatialIndexes para IndexPolicyAdded CompositeIndexes and SpatialIndexes to IndexPolicy
  • Versão adicionada para PartitionKeyDefinitionAdded Version to PartitionKeyDefinition
  • Adicionado nenhum para a PartitionKeyAdded None to PartitionKey

2.3.02.3.0

  • Adicionado IdleTcpConnectionTimeout, OpenTcpConnectionTimeout, MaxRequestsPerTcpConnection e MaxTcpConnectionsPerEndpoint para ConnectionPolicy.Added IdleTcpConnectionTimeout, OpenTcpConnectionTimeout, MaxRequestsPerTcpConnection and MaxTcpConnectionsPerEndpoint to ConnectionPolicy.

2.2.32.2.3

  • Aprimoramentos de diagnósticoDiagnostics improvements

2.2.22.2.2

  • A configuração de variável de ambiente "POCOSerializationOnly" foi adicionada.Added environment variable setting “POCOSerializationOnly”.

  • DocumentDB.Spatial.Sql.dll foi excluído e, agora, foi incluído em Microsoft.Azure.Documents.ServiceInterop.dllRemoved DocumentDB.Spatial.Sql.dll and now included in Microsoft.Azure.Documents.ServiceInterop.dll

2.2.12.2.1

  • Melhoria na lógica de repetição durante o failover para chamadas de execução de StoredProcedure.Improvement in retry logic during failover for StoredProcedure execute calls.

  • DocumentClientEventSource foi transformado em singleton.Made DocumentClientEventSource singleton.

  • O tempo limite de GatewayAddressCache que não estava respeitando o RequestTimeout de ConnectionPolicy foi corrigido.Fix GatewayAddressCache timeout not honoring ConnectionPolicy RequestTimeout.

2.2.02.2.0

  • Para diagnósticos de transporte TCP/direto, foi incluído TransportException, um tipo de exceção interno do SDK.For direct/TCP transport diagnostics, added TransportException, an internal exception type of the SDK. Quando presente nas mensagens de exceção, esse tipo imprime informações adicionais para solução de problemas de conectividade do cliente.When present in exception messages, this type prints additional information for troubleshooting client connectivity problems.

  • Adicionada nova sobrecarga de construtor que usa um HttpMessageHandler, uma pilha de manipulador HTTP a ser usada para enviar solicitações HttpClient (por exemplo, HttpClientHandler).Added new constructor overload which takes a HttpMessageHandler, a HTTP handler stack to use for sending HttpClient requests (e.g., HttpClientHandler).

  • Correção de bug em que cabeçalhos com valores nulos não eram tratados corretamente.Fix bug where header with null values were not being handled properly.

  • Aprimorada a validação de cache da coleção.Improved collection cache validation.

2.1.32.1.3

  • Atualizado System.Net.Security para 4.3.2.Updated System.Net.Security to 4.3.2.

2.1.22.1.2

  • Aprimoramentos de rastreamento de diagnósticoDiagnostic tracing improvements

2.1.12.1.1

  • Adição de maior resiliência a falhas transitórias de solicitação de várias regiões.Added more resilience to Multi-region request transient failures.

2.1.02.1.0

  • Adição de compatibilidade à gravação em várias regiões.Added Multi-region write support.
  • Melhorias de desempenho de consultar entre partições com TOP e MaxBufferedItemCount.Cross partition query performance improvements with TOP and MaxBufferedItemCount.

2.0.02.0.0

  • Adicionado suporte para cancelamento de solicitações.Added request cancellation support.
  • Adicionado SetCurrentLocation para ConnectionPolicy, que preenche automaticamente as localizações preferenciais com base na região.Added SetCurrentLocation to ConnectionPolicy, which automatically populates the preferred locations based on the region.
  • Corrigido o Bug em Consultas de Partição Cruzada com Mín/Máx e um filtro que não corresponde a nenhum documento em uma partição individual.Fixed Bug in Cross Partition Queries with Min/Max and a filter that matches no documents on an individual partition.
  • Os métodos DocumentClient agora têm paridade com IDocumentClient.DocumentClient methods now have parity with IDocumentClient.
  • Pilha de transporte de TCP direto atualizada para reduzir o número de conexões estabelecidas.Updated direct TCP transport stack to reduce the number of connections established.
  • Adicionado suporte para TCP de modo direto para clientes não Windows.Added support for Direct Mode TCP for non-Windows clients.

2.0.0-preview22.0.0-preview2

  • Adicionado suporte para cancelamento de solicitações.Added request cancellation support.
  • Adicionado SetCurrentLocation para ConnectionPolicy, que preenche automaticamente as localizações preferenciais com base na região.Added SetCurrentLocation to ConnectionPolicy, which automatically populates the preferred locations based on the region.
  • Corrigido o Bug em Consultas de Partição Cruzada com Mín/Máx e um filtro que não corresponde a nenhum documento em uma partição individual.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

  • Os métodos DocumentClient agora têm paridade com IDocumentClient.DocumentClient methods now have parity with IDocumentClient.
  • Pilha de transporte de TCP direto atualizada para reduzir o número de conexões estabelecidas.Updated direct TCP transport stack to reduce the number of connections established.
  • Adicionado suporte para TCP de modo direto para clientes não Windows.Added support for Direct Mode TCP for non-Windows clients.

1.22.01.22.0

  • Propriedade ConsistencyLevel adicionada a FeedOptions.Added ConsistencyLevel Property to FeedOptions.
  • JsonSerializerSettings adicionado a RequestOptions e FeedOptions.Added JsonSerializerSettings to RequestOptions and FeedOptions.
  • EnableReadRequestsFallback adicionado a ConnectionPolicy.Added EnableReadRequestsFallback to ConnectionPolicy.

1.21.11.21.1

  • Corrigido KeyNotFoundException para consultas order by entre partições em situações extremas.Fixed KeyNotFoundException for cross partition order by queries in corner cases.
  • Corrigido o bug onde o atributo JsonProperty na cláusula select para consultas LINQ não estava sendo respeitado.Fixed bug where JsonProperty attribute in select clause for LINQ queries was not being honored.

1.20.21.20.2

  • Corrigido um bug que ocorre em determinadas condições de corrida, que resulta em erros "Microsoft.Azure.Documents.NotFoundException: A sessão de leitura não está disponível para o token de sessão de entrada" intermitentes ao usar o nível de consistência de sessão.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

  • Regressão fixa em que FeedOptions.MaxItemCount = -1 gerou uma System.ArithmeticException: o tamanho da página é negativo.Fixed regression where FeedOptions.MaxItemCount = -1 threw an System.ArithmeticException: page size is negative.
  • Uma nova função ToString() foi adicionada a QueryMetrics.Added a new ToString() function to QueryMetrics.
  • Estatísticas de partição foram expostas em coleções de leitura.Exposed partition statistics on reading collections.
  • A propriedade PartitionKey foi adicionada a ChangeFeedOptions.Added PartitionKey property to ChangeFeedOptions.
  • Correções de bug secundárias.Minor bug fixes.

1.19.11.19.1

  • Adiciona a capacidade de especificar índices exclusivos para os documentos usando a propriedade UniqueKeyPolicy na DocumentCollection.Adds the ability to specify unique indexes for the documents by using UniqueKeyPolicy property on the DocumentCollection.
  • Correção de um bug no qual as configurações personalizadas JsonSerializer não estavam sendo cumpridas por algumas consultas e pela execução de procedimento armazenado.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

  • Alteração da identidade visual do DocumentDB do Azure para o Azure Cosmos DB na referência de API, documentação, informações de metadados em assemblies e o pacote NuGet.Branding change from Azure DocumentDB to Azure Cosmos DB in the API Reference documentation, metadata information in assemblies, and the NuGet package.
  • Expor informações de diagnóstico e a latência da resposta de solicitações enviadas com o modo de conectividade direta.Expose diagnostic information and latency from the response of requests sent with direct connectivity mode. Os nomes de propriedade são RequestDiagnosticsString e RequestLatency na classe ResourceResponse.The property names are RequestDiagnosticsString and RequestLatency on ResourceResponse class.
  • Esta versão do SDK requer a versão mais recente do Emulador do Azure Cosmos DB disponível para fazer o download em 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

  • Alterações internas para assemblies de amigos da Microsoft.Internal changes for Microsoft friends assemblies.

1.18.01.18.0

  • Foram adicionadas vários correções e melhorias de confiabilidade.Added several reliability fixes and improvements.

1.17.01.17.0

  • Adição de suporte a PartitionKeyRangeId como FeedOption de modo a definir o escopo dos resultados da consulta para um valor específico do intervalo de chaves de partição.Added support for PartitionKeyRangeId as a FeedOption for scoping query results to a specific partition key range value.
  • Adição de suporte a StartTime como ChangeFeedOption para começar a procurar as alterações após esse horário.Added support for StartTime as a ChangeFeedOption to start looking for the changes after that time.

1.16.11.16.1

  • Foi corrigido um problema na classe JsonSerializable que podia gerar uma exceção de excedente de pilha.Fixed an issue in the JsonSerializable class that may cause a stack overflow exception.

1.16.01.16.0

  • Corrigido um problema que exigia a recompilação o aplicativo devido à introdução de JsonSerializerSettings como um parâmetro opcional no construtor DocumentClient.Fixed an issue that required recompiling of the application due to the introduction of JsonSerializerSettings as an optional parameter in the DocumentClient constructor.
  • O construtor DocumentClient, que exigia JsonSerializerSettings como o último parâmetro para permitir valores padrão de parâmetros ConnectionPolicy e ConsistencyLevel ao passar no parâmetro JsonSerializerSettings, foi marcado como obsoleto.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

  • Adicionado suporte para a especificação de JsonSerializerSettings personalizadas ao instanciar DocumentClient.Added support for specifying custom JsonSerializerSettings while instantiating DocumentClient.

1.14.11.14.1

  • Corrigido um problema que afetava computadores x64 que não davam suporte à instrução SSE4 e que geravam SEHException ao executarem consultas de SQL do Azure Cosmos DB.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

  • Adição de suporte a um novo nível de consistência chamado ConsistentPrefix.Added support for a new consistency level called ConsistentPrefix.
  • Adição de suporte a métricas de consulta em partições individuais.Added support for query metrics for individual partitions.
  • Adição de suporte para limitar o tamanho do token de continuação em consultas.Added support for limiting the size of the continuation token for queries.
  • Adição de suporte para um rastreamento mais detalhado das solicitações com falha.Added support for more detailed tracing for failed requests.
  • Melhorias de desempenho no SDK.Made some performance improvements in the SDK.

1.13.41.13.4

  • Funcionalmente equivalente a 1.13.3.Functionally same as 1.13.3. Algumas alterações internas.Made some internal changes.

1.13.31.13.3

  • Funcionalmente equivalente a 1.13.2.Functionally same as 1.13.2. Algumas alterações internas.Made some internal changes.

1.13.21.13.2

  • Correção de um problema no qual o valor de PartitionKey fornecido em FeedOptions para consultas de agregação é ignorado.Fixed an issue that ignored the PartitionKey value provided in FeedOptions for aggregate queries.
  • Correção de um problema na manipulação transparente do gerenciamento de partição durante a metade da execução da consulta Order By entre partições.Fixed an issue in transparent handling of partition management during mid-flight cross-partition Order By query execution.

1.13.11.13.1

  • Correção de um problema que causou deadlocks em algumas APIs assíncronas quando usado dentro do contexto do ASP.NET.Fixed an issue which caused deadlocks in some of the async APIs when used inside ASP.NET context.

1.13.01.13.0

  • Correções para tornar o SDK mais resilientes ao failover automático em determinadas condições.Fixes to make SDK more resilient to automatic failover under certain conditions.

1.12.21.12.2

  • Correção de um problema que eventualmente causa uma WebException: O nome remoto não pôde ser resolvido.Fix for an issue that occasionally causes a WebException: The remote name could not be resolved.
  • Adição do suporte para ler um documento digitado diretamente com a adição de novas sobrecargas à API ReadDocumentAsync.Added the support for directly reading a typed document by adding new overloads to ReadDocumentAsync API.

1.12.11.12.1

  • Adicionado suporte ao LINQ para consultas de agregação (CONT.NÚM, MÍNIMO, MÁXIMO, SOMA e MÉDIA).Added LINQ support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG).
  • Correção de um problema de vazamento de memória do objeto ConnectionPolicy causado pelo uso do manipulador de eventos.Fix for a memory leak issue for the ConnectionPolicy object caused by the use of event handler.
  • Correção de um problema no qual UpsertAttachmentAsync não estava funcionando quando ETag era usada.Fix for an issue wherein UpsertAttachmentAsync was not working when ETag was used.
  • Correção de um problema no qual a continuação da consulta order-by entre partições não estava funcionando ao classificar no campo de cadeia de caracteres.Fix for an issue wherein cross partition order-by query continuation was not working when sorting on string field.

1.12.01.12.0

  • Suporte adicionado para consultas de agregação (COUNT, MIN, MAX, SUM e AVG).Added support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG). Veja Suporte de agregação.See Aggregation support.
  • Taxa de transferência mínima reduzida em coleções particionadas de 10.100 RU/s a 2500 RU/s.Lowered minimum throughput on partitioned collections from 10,100 RU/s to 2500 RU/s.

1.11.41.11.4

  • Correção para um problema no qual algumas das consultas entre partições com falha no processo de host de 32 bits.Fix for an issue wherein some of the cross-partition queries were failing in the 32-bit host process.
  • Correção para um problema no qual o contêiner de sessão não estava sendo atualizado com o token para solicitações com falha no modo de Gateway.Fix for an issue wherein the session container was not being updated with the token for failed requests in Gateway mode.
  • Correção para um problema no qual uma consulta com chamadas a UDF na projeção estava falhando em alguns casos.Fix for an issue wherein a query with UDF calls in projection was failing in some cases.
  • Correções de desempenho do lado do cliente para aumentar a taxa de transferência de leitura e gravação das solicitações.Client side performance fixes for increasing the read and write throughput of the requests.

1.11.31.11.3

  • Correção para um problema no qual o contêiner de sessão não estava sendo atualizado com o token para solicitações com falha.Fix for an issue wherein the session container was not being updated with the token for failed requests.
  • Adicionado suporte para o SDK trabalhar em um processo de host de 32 bits.Added support for the SDK to work in a 32-bit host process. Observe que, se você usar consultas entre partições, processamento de host de 64 bits é recomendado para melhorar o desempenho.Note that if you use cross partition queries, 64-bit host processing is recommended for improved performance.
  • Desempenho aprimorado para cenários que envolvem consultas com um grande número de valores de chave de partição em uma expressão em.Improved performance for scenarios involving queries with a large number of partition key values in an IN expression.
  • Preenchimento de várias estatísticas de cota de recursos no ResourceResponse para solicitações de leitura de conjuntos de documento quando a opção de solicitação PopulateQuotaInfo estiver definida.Populated various resource quota stats in the ResourceResponse for document collection read requests when PopulateQuotaInfo request option is set.

1.11.11.11.1

  • Pequena correção de desempenho para a API CreateDocumentCollectionIfNotExistsAsync introduzida no 1.11.0.Minor performance fix for the CreateDocumentCollectionIfNotExistsAsync API introduced in 1.11.0.
  • Correção de desempenho no SDK para cenários que envolvem o alto grau de solicitações simultâneas.Performance fix in the SDK for scenarios that involve high degree of concurrent requests.

1.11.01.11.0

  • Suporte para novas classes e métodos para processar o feed de alterações dos documentos dentro de uma coleção.Support for new classes and methods to process the change feed of documents within a collection.
  • Suporte para continuação de consulta entre partições e algumas melhorias de desempenho para consultas entre partições.Support for cross-partition query continuation and some perf improvements for cross-partition queries.
  • Acréscimo dos métodos CreateDatabaseIfNotExistsAsync e CreateDocumentCollectionIfNotExistsAsync.Addition of CreateDatabaseIfNotExistsAsync and CreateDocumentCollectionIfNotExistsAsync methods.
  • Suporte para LINQ para funções do sistema: IsDefined, IsNull e IsPrimitive.LINQ support for system functions: IsDefined, IsNull and IsPrimitive.
  • Correção para binplacing automático dos assemblies Microsoft.Azure.Documents.ServiceInterop.dll e DocumentDB.Spatial.Sql.dll para a pasta de lixeira do aplicativo ao usar o pacote do Nuget com projetos que têm ferramentas project.json.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.
  • Suporte para emitir rastreamentos ETW do lado cliente, que podem ser úteis em cenários de depuração.Support for emitting client side ETW traces which could be helpful in debugging scenarios.

1.10.01.10.0

  • Adicionado suporte a conectividade direta para coleções particionadas.Added direct connectivity support for partitioned collections.
  • Melhor desempenho para o nível de consistência Bounded Staleness.Improved performance for the Bounded Staleness consistency level.
  • Adicionado Polygon e LineString DataTypes ao especificar a política de indexação de coleção para consultas espaciais de isolamento geográfico.Added Polygon and LineString DataTypes while specifying collection indexing policy for geo-fencing spatial queries.
  • Adicionado suporte ao LINQ para StringEnumConverter, IsoDateTimeConverter e UnixDateTimeConverter ao converter predicados.Added LINQ support for StringEnumConverter, IsoDateTimeConverter and UnixDateTimeConverter while translating predicates.
  • Várias correções de bugs do SDK.Various SDK bug fixes.

1.9.51.9.5

  • Corrigido um problema que causava a seguinte NotFoundException: A sessão de leitura não está disponível para o token de sessão de entrada.Fixed an issue that caused the following NotFoundException: The read session is not available for the input session token. Essa exceção ocorria em alguns casos ao consultar a região de leitura de uma conta distribuída geograficamente.This exception occurred in some cases when querying for the read-region of a geo-distributed account.
  • Exposta a propriedade ResponseStream na classe ResourceResponse, que permite acesso direto ao fluxo subjacente de uma resposta.Exposed the ResponseStream property in the ResourceResponse class, which enables direct access to the underlying stream from a response.

1.9.41.9.4

  • Foram modificadas as classes ResourceResponse, FeedResponse, StoredProcedureResponse e MediaResponse para implementar a interface pública correspondente para que elas possam ser simuladas para a implantação orientada a testes (TDD).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).
  • Foi corrigido um problema que causava um cabeçalho de chave de partição malformado ao usar um objeto JsonSerializerSettings personalizado para serialização de dados.Fixed an issue that caused a malformed partition key header when using a custom JsonSerializerSettings object for serializing data.

1.9.31.9.3

  • Corrigido um problema que causou falha em consultas de longa execução com o erro: Token de autorização não é válido no momento atual.Fixed an issue that caused long running queries to fail with error: Authorization token is not valid at the current time.
  • Foi corrigido um problema que removia o SqlParameterCollection original de consultas superiores/ordenar por entre partições.Fixed an issue that removed the original SqlParameterCollection from cross partition top/order-by queries.

1.9.21.9.2

  • Adição de suporte a consultas paralelas de coleções particionadas.Added support for parallel queries for partitioned collections.
  • Adição de suporte a consultas ORDER BY e TOP entre partições para coleções particionadas.Added support for cross partition ORDER BY and TOP queries for partitioned collections.
  • Correção das referências ausentes para DocumentDB.Spatial.Sql.dll e Microsoft.Azure.Documents.ServiceInterop.dll, que são obrigatórios ao fazer referência a um projeto do Azure Cosmos DB com uma referência para o pacote Nuget do Azure Cosmos DB.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.
  • Correção da capacidade de usar parâmetros de diferentes tipos ao usar funções definidas pelo usuário no LINQ.Fixed the ability to use parameters of different types when using user-defined functions in LINQ.
  • Correção de um bug para contas globalmente replicadas em que chamadas Upsert estavam sendo direcionadas para locais de leitura em vez de locais de gravação.Fixed a bug for globally replicated accounts where Upsert calls were being directed to read locations instead of write locations.
  • Adição de métodos que estavam ausentes à interface IDocumentClient:Added methods to the IDocumentClient interface that were missing:
    • Método UpsertAttachmentAsync que usa mediaStream e opções como parâmetrosUpsertAttachmentAsync method that takes mediaStream and options as parameters
    • Método CreateAttachmentAsync que usa opções como um parâmetroCreateAttachmentAsync method that takes options as a parameter
    • Método CreateOfferQuery que usa querySpec como um parâmetro.CreateOfferQuery method that takes querySpec as a parameter.
  • Retirada do selo de classes públicas que são expostas na interface IDocumentClient.Unsealed public classes that are exposed in the IDocumentClient interface.

1.8.01.8.0

  • Suporte adicionado para contas de banco de dados de várias regiões.Added the support for multi-region database accounts.
  • Suporte adicionado para repetição de solicitações limitadas.Added support for retry on throttled requests. O usuário pode personalizar o número de repetições e o tempo máximo de espera configurando a propriedade ConnectionPolicy.RetryOptions.User can customize the number of retries and the max wait time by configuring the ConnectionPolicy.RetryOptions property.
  • Nova interface IDocumentClient adicionada que define as assinaturas de todos os métodos e propriedades de DocumentClient.Added a new IDocumentClient interface that defines the signatures of all DocumentClient properties and methods. Como parte dessa alteração, também foram alterados os métodos de extensão que criam IQueryable e IOrderedQueryable para métodos na própria classe DocumentClient.As part of this change, also changed extension methods that create IQueryable and IOrderedQueryable to methods on the DocumentClient class itself.
  • Opção de configuração adicionada para definir ServicePoint.ConnectionLimit de um determinado URI de ponto de extremidade do Azure Cosmos DB.Added configuration option to set the ServicePoint.ConnectionLimit for a given Azure Cosmos DB endpoint Uri. Use ConnectionPolicy.MaxConnectionLimit para alterar o valor padrão, que é definido como 50.Use ConnectionPolicy.MaxConnectionLimit to change the default value, which is set to 50.
  • IPartitionResolver e sua implementação foram preteridos.Deprecated IPartitionResolver and its implementation. O suporte para IPartitionResolver agora é obsoleto.Support for IPartitionResolver is now obsolete. Recomendamos que você use Coleções Particionadas para taxa de transferência e armazenamento superiores.It's recommended that you use Partitioned Collections for higher storage and throughput.

1.7.11.7.1

  • Adicionada uma sobrecarga ao Uri com base no método ExecuteStoredProcedureAsync que recebe RequestOptions como um parâmetro.Added an overload to Uri based ExecuteStoredProcedureAsync method that takes RequestOptions as a parameter.

1.7.01.7.0

  • Adicionado suporte a TTL (tempo de vida) para documentos.Added time to live (TTL) support for documents.

1.6.31.6.3

  • Correção de um bug no pacote Nuget do SDK do .NET para empacotamento como parte de uma solução do Serviço de Nuvem do Azure.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

  • [Corrigido] A consulta do ponto de extremidade do Azure Cosmos DB gera: 'System.Net.Http.HttpRequestException: Erro ao copiar o conteúdo para um fluxo'.[Fixed] Querying Azure Cosmos DB endpoint throws: 'System.Net.Http.HttpRequestException: Error while copying content to a stream'.

1.5.21.5.2

  • Expansão do suporte do LINQ, incluindo novos operadores para paginação, expressões condicionais e comparação de intervalo.Expanded LINQ support including new operators for paging, conditional expressions, and range comparison.
    • Operador Take para habilitar o comportamento de SELECT TOP no LINQTake operator to enable SELECT TOP behavior in LINQ
    • Operador CompareTo para habilitar comparações de intervalo de cadeia de caracteresCompareTo operator to enable string range comparisons
    • Operadores condicionais (?) e de união (??)Conditional (?) and coalesce operators (??)
  • [Corrigido] ArgumentOutOfRangeException ao combinar a projeção do Modelo com o Where-In na consulta LINQ.[Fixed] ArgumentOutOfRangeException when combining Model projection with Where-In in a LINQ query. #81#81

1.5.11.5.1

  • [Corrigido] Se Select não for a última expressão, o Provedor LINQ presumiu que não havia projeção e produziu SELECT * incorretamente.[Fixed] If Select is not the last expression the LINQ Provider assumed no projection and produced SELECT * incorrectly. Nº 58#58

1.5.01.5.0

  • Implementação de Upsert, adição de métodos UpsertXXXAsyncImplemented Upsert, Added UpsertXXXAsync methods
  • Melhorias de desempenho de todas as solicitaçõesPerformance improvements for all requests
  • Suporte ao provedor LINQ para os métodos conditional, coalesce e CompareTo em cadeias de caracteresLINQ Provider support for conditional, coalesce, and CompareTo methods for strings
  • [Corrigido] Provedor LINQ --> Implementa o método Contains em List para gerar o mesmo SQL como em IEnumerable e Array[Fixed] LINQ provider --> Implement Contains method on List to generate the same SQL as on IEnumerable and Array
  • [Corrigido] BackoffRetryUtility usa a mesma HttpRequestMessage novamente em vez de criar uma nova em uma nova tentativa[Fixed] BackoffRetryUtility uses the same HttpRequestMessage again instead of creating a new one on retry
  • [Obsoleto] UriFactory.CreateCollection--> agora deve usar UriFactory.CreateDocumentCollection[Obsolete] UriFactory.CreateCollection --> should now use UriFactory.CreateDocumentCollection

1.4.11.4.1

  • [Corrigido] Problemas de localização ao usar informações de cultura em outro idioma que não o inglês, como nl-NL, etc.[Fixed] Localization issues when using non en culture info such as nl-NL, etc.

1.4.01.4.0

  • Adicionado roteamento baseado em IDAdded ID-based routing
    • Novo auxiliar UriFactory para ajudá-lo a construir links para recursos baseados em identificaçãoNew UriFactory helper to assist with constructing ID-based resource links
    • Novas sobrecargas em DocumentClient para receber URINew overloads on DocumentClient to take in URI
  • Adicionado IsValid() e IsValidDetailed () em LINQ para geoespaciaisAdded IsValid() and IsValidDetailed() in LINQ for geospatial
  • Suporte ao provedor LINQ aprimorado:LINQ Provider support enhanced:
    • Matemática - Abs, Acos, Asin, Atan, Ceiling, Cos, Exp, Floor, Log, Log10, Pow, Round, Sign, Sin, Sqrt, Tan e TruncateMath - Abs, Acos, Asin, Atan, Ceiling, Cos, Exp, Floor, Log, Log10, Pow, Round, Sign, Sin, Sqrt, Tan, Truncate
    • Cadeia de caracteres - Concat, Contains, EndsWith, IndexOf, Count, ToLower, TrimStart, Replace, Reverse, TrimEnd, StartsWith, SubString e ToUpperString - Concat, Contains, EndsWith, IndexOf, Count, ToLower, TrimStart, Replace, Reverse, TrimEnd, StartsWith, SubString, ToUpper
    • Array - Concat, Contains, CountArray - Concat, Contains, Count
    • ININ operator

1.3.01.3.0

  • Suporte adicionado para modificar políticas de indexação.Added support for modifying indexing policies.
    • Novo método ReplaceDocumentCollectionAsync no DocumentClientNew ReplaceDocumentCollectionAsync method in DocumentClient
    • Nova propriedade IndexTransformationProgress em ResourceResponse para acompanhar o progresso em percentual de alterações na política de índiceNew IndexTransformationProgress property in ResourceResponse for tracking percent progress of index policy changes
    • DocumentCollection.IndexingPolicy agora é mutávelDocumentCollection.IndexingPolicy is now mutable
  • Suporte adicionado para consulta e indexação espacial.Added support for spatial indexing and query.
    • Novo namespace Microsoft.Azure.Documents.Spatial para serializar/desserializar tipos espaciais, como Ponto e PolígonoNew Microsoft.Azure.Documents.Spatial namespace for serializing/deserializing spatial types like Point and Polygon
    • Nova classe SpatialIndex para indexação de dados GeoJSON armazenados no Cosmos DBNew SpatialIndex class for indexing GeoJSON data stored in Cosmos DB
  • [Corrigido] : consulta SQL incorreta gerada usando a expressão LINQ Nº 38.[Fixed] Incorrect SQL query generated from a LINQ expression #38.

1.2.01.2.0

  • Adicionada dependência de Newtonsoft.Json v5.0.7.Added a dependency on Newtonsoft.Json v5.0.7.

  • Alterações feitas para dar suporte a Order By:Made changes to support Order By:

    • Suporte ao provedor LINQ para OrderBy() ou OrderByDescending()LINQ provider support for OrderBy() or OrderByDescending()

    • IndexingPolicy para dar suporte a Order ByIndexingPolicy to support Order By

      Possível alteração interruptivaPossible breaking change

      Se você tem o código existente que provisiona as coleções com uma política personalizada de indexação, o seu código existente precisa ser atualizado para dar suporte à nova classe IndexingPolicy.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. Se você não tem uma política personalizada de indexação, essa alteração não afeta você.If you have no custom indexing policy, then this change does not affect you.

1.1.01.1.0

  • Adicionado suporte a dados de particionamento usando as novas classes HashPartitionResolver e RangePartitionResolver e o IPartitionResolver.Added support for partitioning data by using the new HashPartitionResolver and RangePartitionResolver classes and the IPartitionResolver.
  • Adicionada serialização DataContract.Added DataContract serialization.
  • Adicionado suporte a GUID no provedor LINQ.Added GUID support in LINQ provider.
  • Adicionado suporte a UDF no LINQ.Added UDF support in LINQ.

1.0.01.0.0

  • SDK DO GAGA SDK

Datas de lançamento e desativaçãoRelease & Retirement dates

A Microsoft notifica pelo menos 12 meses antes de desativar um SDK, a fim de realizar uma transição tranquila para uma versão mais recente/com suporte.Microsoft provides notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version.

Os novos recursos, funcionalidades e otimizações são adicionados apenas ao SDK atual. Portanto, recomendamos que você atualize sempre que possível para a versão do SDK mais recente.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.

Qualquer solicitação feita ao BD Cosmos do Azure usando um SDK obsoleto é rejeitada pelo serviço.Any requests to Azure Cosmos DB using a retired SDK are rejected by the service.


VersãoVersion Data do lançamentoRelease Date Data de desativaçãoRetirement Date
2.5.12.5.1 02 de julho de 2019July 02, 2019 ---
2.4.12.4.1 20 de junho de 2019June 20, 2019 ---
2.4.02.4.0 05 de maio de 2019May 05, 2019 ---
2.3.02.3.0 04 de abril de 2019April 04, 2019 ---
2.2.32.2.3 11 de fevereiro de 2019February 11, 2019 ---
2.2.22.2.2 06 de fevereiro de 2019February 06, 2019 ---
2.2.12.2.1 24 de dezembro de 2018December 24, 2018 ---
2.2.02.2.0 07 de dezembro de 2018December 07, 2018 ---
2.1.32.1.3 15 de outubro de 2018October 15, 2018 ---
2.1.22.1.2 04 de outubro de 2018October 04, 2018 ---
2.1.12.1.1 27 de setembro de 2018September 27, 2018 ---
2.1.02.1.0 21 de setembro de 2018September 21, 2018 ---
2.0.02.0.0 07 de setembro de 2018September 07, 2018 ---
1.22.01.22.0 19 de abril de 2018April 19, 2018 ---
1.21.11.21.1 09 de março de 2018March 09, 2018 ---
1.20.21.20.2 21 de fevereiro de 2018February 21, 2018 ---
1.20.11.20.1 5 de fevereiro de 2018February 05, 2018 ---
1.19.11.19.1 16 de novembro de 2017November 16, 2017 ---
1.19.01.19.0 10 de novembro, 2017November 10, 2017 ---
1.18.11.18.1 07 de novembro de 2017November 07, 2017 ---
1.18.01.18.0 17 de outubro de 2017October 17, 2017 ---
1.17.01.17.0 10 de agosto de 2017August 10, 2017 ---
1.16.11.16.1 7 de agosto de 2017August 07, 2017 ---
1.16.01.16.0 2 de agosto de 2017August 02, 2017 ---
1.15.01.15.0 30 de junho de 2017June 30, 2017 ---
1.14.11.14.1 23 de maio de 2017May 23, 2017 ---
1.14.01.14.0 10 de maio de 2017May 10, 2017 ---
1.13.41.13.4 9 de maio de 2017May 09, 2017 ---
1.13.31.13.3 6 de maio de 2017May 06, 2017 ---
1.13.21.13.2 19 de abril de 2017April 19, 2017 ---
1.13.11.13.1 29 de março de 2017March 29, 2017 ---
1.13.01.13.0 24 de março de 2017March 24, 2017 ---
1.12.21.12.2 20 de março de 2017March 20, 2017 ---
1.12.11.12.1 14 de março de 2017March 14, 2017 ---
1.12.01.12.0 15 de fevereiro de 2017February 15, 2017 ---
1.11.41.11.4 06 de fevereiro de 2017February 06, 2017 ---
1.11.31.11.3 26 de janeiro de 2017January 26, 2017 ---
1.11.11.11.1 21 de dezembro de 2016December 21, 2016 ---
1.11.01.11.0 08 de dezembro de 2016December 08, 2016 ---
1.10.01.10.0 27 de setembro de 2016September 27, 2016 ---
1.9.51.9.5 1º de setembro de 2016September 01, 2016 ---
1.9.41.9.4 24 de agosto de 2016August 24, 2016 ---
1.9.31.9.3 15 de agosto de 2016August 15, 2016 ---
1.9.21.9.2 23 de julho de 2016July 23, 2016 ---
1.8.01.8.0 14 de junho de 2016June 14, 2016 ---
1.7.11.7.1 6 de maio de 2016May 06, 2016 ---
1.7.01.7.0 26 de abril de 2016April 26, 2016 ---
1.6.31.6.3 08 de abril de 2016April 08, 2016 ---
1.6.21.6.2 29 de março de 2016March 29, 2016 ---
1.5.31.5.3 19 de fevereiro de 2016February 19, 2016 ---
1.5.21.5.2 14 de dezembro de 2015December 14, 2015 ---
1.5.11.5.1 23 de novembro de 2015November 23, 2015 ---
1.5.01.5.0 5 de outubro de 2015October 05, 2015 ---
1.4.11.4.1 25 de agosto de 2015August 25, 2015 ---
1.4.01.4.0 13 de agosto de 2015August 13, 2015 ---
1.3.01.3.0 5 de agosto de 2015August 05, 2015 ---
1.2.01.2.0 6 de julho de 2015July 06, 2015 ---
1.1.01.1.0 30 de abril de 2015April 30, 2015 ---
1.0.01.0.0 8 de abril de 2015April 08, 2015 ---

Perguntas frequentesFAQ

1. Como os clientes serão notificados sobre a desativação do SDK?1. How will customers be notified of the retiring SDK?

A Microsoft enviará notificações com 12 meses de antecedência informando sobre o fim do suporte para o SDK desativado, a fim de facilitar uma transição suave para um SDK com suporte.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. Além disso, os clientes serão notificados por meio de vários canais de comunicação, como o Portal de Gerenciamento do Azure, a Central de Desenvolvedores, postagens de blog e a comunicação direta para os administradores de serviço indicados.Further, customers will be notified through various communication channels – Azure Management Portal, Developer Center, blog post, and direct communication to assigned service administrators.

2. Os clientes podem criar aplicativos usando um SDK do Azure Cosmos DB prestes a ser desativado durante o período de 12 meses?2. Can customers author applications using a "to-be" retired Azure Cosmos DB SDK during the 12 month period?

Sim, os clientes terão acesso total para criar, implantar e modificar os aplicativos usando o SDK do Azure Cosmos DB prestes a ser desativado durante o período de 12 meses.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. Durante o período de carência de 12 meses, os clientes serão aconselhados a migrar para uma versão mais recente com suporte do SDK do Azure Cosmos DB, como apropriado.During the 12 month grace period, customers are advised to migrate to a newer supported version of Azure Cosmos DB SDK as appropriate.

3. Os clientes poderão criar e modificar os aplicativos usando um SDK do Azure Cosmos DB desativado após o período de notificação de 12 meses?3. Can customers author and modify applications using a retired Azure Cosmos DB SDK after the 12 month notification period?

Após o período de notificação de 12 meses, o SDK será desativado.After the 12 month notification period, the SDK will be retired. O acesso de aplicativos ao Azure Cosmos DB com um SDK desativado não será permitido pela plataforma do Azure Cosmos DB.Any access to Azure Cosmos DB by an applications using a retired SDK will not be permitted by the Azure Cosmos DB platform. Além disso, a Microsoft não fornecerá suporte ao cliente para o SDK desativado.Further, Microsoft will not provide customer support on the retired SDK.

4. O que acontecerá com os aplicativos em execução do cliente que estiverem usando a versão sem suporte do SDK do Azure Cosmos DB?4. What happens to Customer’s running applications that are using unsupported Azure Cosmos DB SDK version?

As tentativas de conexão com o serviço do Azure Cosmos DB com uma versão de SDK desativada serão recusadas.Any attempts made to connect to the Azure Cosmos DB service with a retired SDK version will be rejected.

5. Os novos recursos e a funcionalidades serão aplicados a todos os SDKs não desativados?5. Will new features and functionality be applied to all non-retired SDKs?

Os novos recursos e funcionalidades serão adicionadas apenas para as novas versões.New features and functionality will only be added to new versions. Se estiver usando uma versão anterior mas não-obsoleta do SDK, suas solicitações para o Azure Cosmos DB continuarão funcionando como antes, mas você não terá acesso aos novos recursos.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. O que devo fazer, caso eu não consiga atualizar o aplicativo antes de uma data de fechamento?6. What should I do if I cannot update my application before a cut-off date?

Recomendamos atualizar o mais rápido possível para o SDK mais recente.We recommend that you upgrade to the latest SDK as early as possible. Quando um SDK é marcado para desativação, você tem 12 meses para atualizar o aplicativo.Once an SDK has been tagged for retirement you will have 12 months to update your application. Caso você não possa concluir a atualização do aplicativo nesse prazo por algum motivo, contate a Equipe do BD Cosmos e solicite ajuda antes da data de fechamento.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.

Consulte tambémSee also

Para saber mais sobre o Cosmos DB, consulte a página de serviço do Microsoft Azure Cosmos DB.To learn more about Cosmos DB, see Microsoft Azure Cosmos DB service page.