You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: sdk/tables/azure-data-tables/README.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,15 @@
1
-
# Azure Data Tables client library for Python
1
+
# Azure Tables client library for Python
2
2
3
-
Azure Data Tables is a NoSQL data storage service that can be accessed from anywhere in the world via authenticated calls using HTTP or HTTPS.
3
+
Azure Tables is a NoSQL data storage service that can be accessed from anywhere in the world via authenticated calls using HTTP or HTTPS.
4
4
Tables scales as needed to support the amount of data inserted, and allow for the storing of data with non-complex accessing.
5
-
The Azure Data Tables client can be used to access Azure Storage or Cosmos accounts. This document covers [`azure-data-tables`][Tables_pypi].
5
+
The Azure Tables client can be used to access Azure Storage or Cosmos accounts. This document covers [`azure-data-tables`][Tables_pypi].
6
6
7
7
Please note, this package is a replacement for [`azure-cosmosdb-tables`](https://github.com/Azure/azure-cosmos-table-python/tree/master/azure-cosmosdb-table) which is now deprecated. See the [migration guide][migration_guide] for more details.
The Azure Data Tables SDK can access an Azure Storage or CosmosDB account.
12
+
The Azure Tables SDK can access an Azure Storage or CosmosDB account.
13
13
14
14
### Prerequisites
15
15
* Python 2.7, or 3.6 or later is required to use this package.
@@ -22,13 +22,13 @@ The Azure Data Tables SDK can access an Azure Storage or CosmosDB account.
22
22
* To create a new cosmos storage account, you can use the [Azure CLI][azure_cli_create_cosmos] or [Azure Portal][azure_portal_create_cosmos].
23
23
24
24
### Install the package
25
-
Install the Azure Data Tables client library for Python with [pip][pip_link]:
25
+
Install the Azure Tables client library for Python with [pip][pip_link]:
26
26
```bash
27
27
pip install azure-data-tables
28
28
```
29
29
30
30
#### Create the client
31
-
The Azure Data Tables library allows you to interact with two types of resources:
31
+
The Azure Tables library allows you to interact with two types of resources:
32
32
* the tables in your account
33
33
* the entities within those tables.
34
34
Interaction with these resources starts with an instance of a [client](#clients). To create a client object, you will need the account's table service endpoint URL and a credential that allows you to access the account. The `endpoint` can be found on the page for your storage account in the [Azure Portal][azure_portal_account_url] under the "Access Keys" section or by running the following Azure CLI command:
@@ -111,12 +111,12 @@ Common uses of the Table service included:
111
111
* Quickly querying data using a clustered index
112
112
* Accessing data using the OData protocol and LINQ filter expressions
113
113
114
-
The following components make up the Azure Data Tables Service:
114
+
The following components make up the Azure Tables Service:
115
115
* The account
116
116
* A table within the account, which contains a set of entities
117
117
* An entity within a table, as a dictionary
118
118
119
-
The Azure Data Tables client library for Python allows you to interact with each of these components through the
119
+
The Azure Tables client library for Python allows you to interact with each of these components through the
120
120
use of a dedicated client object.
121
121
122
122
### Clients
@@ -252,7 +252,7 @@ the client level to enable it for all requests.
252
252
## Troubleshooting
253
253
254
254
### General
255
-
Azure Data Tables clients raise exceptions defined in [Azure Core][azure_core_readme].
255
+
Azure Tables clients raise exceptions defined in [Azure Core][azure_core_readme].
256
256
When you interact with the Azure table library using the Python SDK, errors returned by the service respond ot the same HTTP status codes for [REST API][tables_rest] requests. The Table service operations will throw a `HttpResponseError` on failure with helpful [error codes][tables_error_codes].
257
257
258
258
For examples, if you try to create a table that already exists, a `409` error is returned indicating "Conflict".
Get started with our [Table samples][tables_samples].
308
308
309
-
Several Azure Data Tables Python SDK samples are available to you in the SDK's GitHub repository. These samples provide example code for additional scenarios commonly encountered while working with Tables.
309
+
Several Azure Tables Python SDK samples are available to you in the SDK's GitHub repository. These samples provide example code for additional scenarios commonly encountered while working with Tables.
310
310
311
311
### Common Scenarios
312
-
These code samples show common scenario operations with the Azure Data tables client library. The async versions of the samples (the python sample files appended with _async) show asynchronous operations with Tables and require Python 3.5 or later.
312
+
These code samples show common scenario operations with the Azure Tables client library. The async versions of the samples (the python sample files appended with _async) show asynchronous operations with Tables and require Python 3.5 or later.
313
313
314
314
* Create and delete tables: [sample_create_delete_table.py](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/tables/azure-data-tables/samples/sample_create_delete_table.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/tables/azure-data-tables/samples/async_samples/sample_create_delete_table_async.py))
315
315
* List and query tables: [sample_query_tables.py](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/tables/azure-data-tables/samples/sample_query_tables.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/tables/azure-data-tables/samples/async_samples/sample_query_tables_async.py))
@@ -319,7 +319,7 @@ These code samples show common scenario operations with the Azure Data tables cl
319
319
* Committing many requests in a single transaction: [sample_batching.py](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/tables/azure-data-tables/samples/sample_batching.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/tables/azure-data-tables/samples/async_samples/sample_batching_async.py))
320
320
321
321
### Additional documentation
322
-
For more extensive documentation on Azure Data Tables, see the [Azure Data Tables documentation][Tables_product_doc] on docs.microsoft.com.
322
+
For more extensive documentation on Azure Tables, see the [Azure Tables documentation][Tables_product_doc] on docs.microsoft.com.
323
323
324
324
## Known Issues
325
325
A list of currently known issues relating to Cosmos DB table endpoints can be found [here](https://aka.ms/tablesknownissues).
0 commit comments