Developing with Azure Cosmos DB Table API and Azure Table storage
APPLIES TO: Table API
Azure Cosmos DB Table API and Azure Table storage share the same table data model and expose the same create, delete, update, and query operations through their SDKs.
The serverless capacity mode is now available on Azure Cosmos DB's Table API.
If you currently use Azure Table Storage, you gain the following benefits by moving to the Azure Cosmos DB Table API:
|Feature||Azure Table storage||Azure Cosmos DB Table API|
|Latency||Fast, but no upper bounds on latency.||Single-digit millisecond latency for reads and writes, backed with <10-ms latency reads and <15-ms latency writes at the 99th percentile, at any scale, anywhere in the world.|
|Throughput||Variable throughput model. Tables have a scalability limit of 20,000 operations/s.||Highly scalable with dedicated reserved throughput per table that's backed by SLAs. Accounts have no upper limit on throughput and support >10 million operations/s per table (in provisioned throughput mode).|
|Global distribution||Single region with one optional readable secondary read region for high availability which supports automatic and manual account failover.||Turnkey global distribution from one to 30+ regions. Support for automatic and manual failovers at any time, anywhere in the world.|
|Indexing||Only primary index on PartitionKey and RowKey. No secondary indexes.||Automatic and complete indexing on all properties, no index management.|
|Query||Query execution uses index for primary key, and scans otherwise.||Queries can take advantage of automatic indexing on properties for fast query times.|
|Consistency||Strong within primary region. Eventual within secondary region.||Five well-defined consistency levels to trade off availability, latency, throughput, and consistency based on your application needs.|
|Pricing||Consumption-based.||Available in both consumption-based and provisioned capacity modes.|
|SLAs||99.99% availability.||99.99% availability SLA for all single region accounts and all multi-region accounts with relaxed consistency, and 99.999% read availability on all multi-region database accounts Industry-leading comprehensive SLAs on general availability.|
Developing with the Azure Cosmos DB Table API
At this time, the Azure Cosmos DB Table API has four SDKs available for development:
Microsoft.Azure.Cosmos.Table: .NET SDK. This library targets .NET Standard and has the same classes and method signatures as the public Windows Azure Storage SDK, but also has the ability to connect to Azure Cosmos DB accounts using the Table API. Users of .NET Framework library Microsoft.Azure.CosmosDB.Table are recommended to upgrade to Microsoft.Azure.Cosmos.Table as it is in maintenance mode and will be deprecated soon.
Python SDK: The new Azure Cosmos DB Python SDK is the only SDK that supports Azure Table storage in Python. This SDK connects with both Azure Table storage and Azure Cosmos DB Table API.
Java SDK: This Azure Storage SDK has the ability to connect to Azure Cosmos DB accounts using the Table API.
Node.js SDK: This Azure Storage SDK has the ability to connect to Azure Cosmos DB accounts using the Table API.
Additional information about working with the Table API is available in the FAQ: Develop with the Table API article.
Developing with Azure Table storage
Azure Table storage has these SDKs available for development:
- The Microsoft.Azure.Storage.Blob, Microsoft.Azure.Storage.File, Microsoft.Azure.Storage.Queue, and Microsoft.Azure.Storage.Common libraries allow you to work with the Azure Table storage service. If you are using the Table API in Azure Cosmos DB, you can instead use the Microsoft.Azure.CosmosDB.Table library.
- Python SDK. The Azure Cosmos DB Table SDK for Python supports the Table Storage service (because Azure Table Storage and Cosmos DB's Table API share the same features and functionalities, and in an effort to factorize our SDK development efforts, we recommend to use this SDK).
- Azure Storage SDK for Java. This Azure Storage SDK provides a client library in Java to consume Azure Table storage.
- AzureRmStorageTable PowerShell module. This PowerShell module has cmdlets to work with storage Tables.
- Azure Storage Client Library for C++. This library enables you to build applications against Azure Storage.
- Azure Storage Table Client Library for Ruby. This project provides a Ruby package that makes it easy to access Azure storage Table services.
- Azure Storage Table PHP Client Library. This project provides a PHP client library that makes it easy to access Azure storage Table services.