API .NET de Tabela do Azure Cosmos DB: Downloads e notas sobre a versãoAzure Cosmos DB Table .NET API: Download and release notes

Baixe o SDKSDK download NuGetNuGet
Início rápidoQuickstart Banco de dados do Azure Cosmos DB: Compilar um aplicativo com o .NET e a API de TabelaAzure Cosmos DB: Build an app with .NET and the Table API
TutorialTutorial Banco de dados do Azure Cosmos DB: Desenvolver com a API de Tabela no .NETAzure Cosmos DB: Develop with the Table API in .NET
Framework atualmente com suporteCurrent supported framework Microsoft .NET Framework 4.5.1Microsoft .NET Framework 4.5.1

Importante

O SDK Microsoft.Azure.CosmosDB.Table do .NET Framework está no modo de manutenção e será preterido em breve.The .NET Framework SDK Microsoft.Azure.CosmosDB.Table is in maintenance mode and it will be deprecated soon. Atualize para Microsoft.Azure.Cosmos.Table da nova biblioteca do .NET Standard para continuar a obter os recursos mais recentes com suporte na API de Tabela.Please upgrade to the new .NET Standard library Microsoft.Azure.Cosmos.Table to continue to get the latest features supported by the Table API.

Se você criou uma conta da API de Tabela durante a versão prévia, crie uma nova conta da API de Tabela para trabalhar com os SDKs da API de Tabela disponíveis para o público em geral.If you created a Table API account during the preview, please create a new Table API account to work with the generally available Table API SDKs.

Notas de versãoRelease notes

2.1.22.1.2

  • Correções de bugBug fixes

2.1.02.1.0

  • Correções de bugBug fixes

2.0.02.0.0

  • Adição de suporte de gravação de várias regiõesAdded Multi-region write support
  • Correção das dependências de pacotes NuGet em Microsoft.Azure.DocumentDB, Microsoft.OData.Core, Microsoft.OData.Edm e Microsoft.SpatialFixed NuGet package dependencies on Microsoft.Azure.DocumentDB, Microsoft.OData.Core, Microsoft.OData.Edm, Microsoft.Spatial

1.1.31.1.3

  • Corrigidas as dependências de pacote NuGet no Microsoft.Azure.Storage.Common e Microsoft.Azure.DocumentDB.Fixed NuGet package dependencies on Microsoft.Azure.Storage.Common and Microsoft.Azure.DocumentDB.
  • Correções de bugs na serialização de tabelas quando o JsonConvert.DefaultSettings é configurado.Bug fixes on table serialization when JsonConvert.DefaultSettings are configured.

1.1.11.1.1

  • Validação adicional para ETAGs malformadas no Modo Direto.Added validation for malformed ETAGs in Direct Mode.
  • Bug de consulta LINQ fixado no Modo de Gateway.Fixed LINQ query bug in Gateway Mode.
  • As APIs síncronas agora são executadas no pool de threads com SynchronizationContext.Synchronous APIs now run on the thread pool with SynchronizationContext.

1.1.01.1.0

  • Adicionar TableQueryMaxItemCount, TableQueryEnableScan, TableQueryMaxDegreeOfParallelism e TableQueryContinuationTokenLimitInKb a TableRequestOptionsAdd TableQueryMaxItemCount, TableQueryEnableScan, TableQueryMaxDegreeOfParallelism, and TableQueryContinuationTokenLimitInKb to TableRequestOptions
  • Correções de BugBug Fixes

1.0.01.0.0

  • Versão de disponibilidade geralGeneral availability release

0.9.0-preview0.9.0-preview

  • Versão prévia inicialInitial preview release

Datas de lançamento e desativaçãoRelease and 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.

Atualmente Microsoft.Azure.CosmosDB.Table , a biblioteca está disponível somente para .NET Framework e está no modo de manutenção e será preterida em breve.The Microsoft.Azure.CosmosDB.Table library is currently available for .NET Framework only, and is in maintenance mode and will be deprecated soon. Novos recursos e funcionalidades e otimizações são adicionados somente à biblioteca de .NET Standard Microsoft. Azure. Cosmos. Table, por isso é recomendável que você atualize para Microsoft. Azure. Cosmos. Table.New features and functionalities and optimizations are only added to the .NET Standard library Microsoft.Azure.Cosmos.Table, as such it is recommended that you upgrade to Microsoft.Azure.Cosmos.Table.

O pacote de visualização WindowsAzure. Storage-premiumtable foi preterido.The WindowsAzure.Storage-PremiumTable preview package has been deprecated. O SDK WindowsAzure.Storage-PremiumTable será desativado em 15 de novembro de 2018, quando as solicitações para o SDK obsoleto não serão permitidas.The WindowsAzure.Storage-PremiumTable SDK will be retired on November 15, 2018, at which time requests to the retired SDK will not be permitted.

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.

VersionVersion Data do lançamentoRelease Date Data de desativaçãoRetirement Date
2.1.22.1.2 16 de setembro de 2019September 16, 2019
2.1.02.1.0 22 janeiro de 2019January 22, 2019 01 de abril de 2020April 01, 2020
2.0.02.0.0 26 de setembro de 2018September 26, 2018 1º de março de 2020March 01, 2020
1.1.31.1.3 17 de julho de 2018July 17, 2018 1º de dezembro de 2019December 01, 2019
1.1.11.1.1 26 de março de 2018March 26, 2018 1º de dezembro de 2019December 01, 2019
1.1.01.1.0 21 de fevereiro de 2018February 21, 2018 1º de dezembro de 2019December 01, 2019
1.0.01.0.0 15 de novembro de 2017November 15, 2017 15 de novembro de 2019November 15, 2019
0.9.0-preview0.9.0-preview 11 de novembro de 2017November 11, 2017 11 de novembro de 2019November 11, 2019

Solução de problemasTroubleshooting

Se você receber o erroIf you get the error

Unable to resolve dependency 'Microsoft.Azure.Storage.Common'. Source(s) used: 'nuget.org', 
'CliFallbackFolder', 'Microsoft Visual Studio Offline Packages', 'Microsoft Azure Service Fabric SDK'`

ao tentar usar o pacote Microsoft.Azure.CosmosDB.Table NuGet, você tem duas opções para corrigir o problema:when attempting to use the Microsoft.Azure.CosmosDB.Table NuGet package, you have two options to fix the issue:

  • Use o Console de Gerenciamento de Pacote para instalar o pacote Microsoft.Azure.CosmosDB.Table e suas dependências.Use Package Manage Console to install the Microsoft.Azure.CosmosDB.Table package and its dependencies. Para fazer isso, digite o seguinte no Console do Gerenciador de Pacotes para sua solução.To do this, type the following in the Package Manager Console for your solution.

    Install-Package Microsoft.Azure.CosmosDB.Table -IncludePrerelease
    
  • Usando a ferramenta de gerenciamento de pacotes NuGet preferencial, instale o pacote NuGet Microsoft.Azure.Storage.Common antes de instalar o Microsoft.Azure.CosmosDB.Table.Using your preferred NuGet package management tool, install the Microsoft.Azure.Storage.Common NuGet package before installing Microsoft.Azure.CosmosDB.Table.

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 a API de Tabela do Azure CosmosDB, consulte Introdução ao Azure Cosmos DB: API de Tabela.To learn more about the Azure Cosmos DB Table API, see Introduction to Azure Cosmos DB Table API.