@azure/data-tables 13.0.1-alpha.20211210.2 → 13.0.1-alpha.20211221.1

package/README.md

@@ -123,6 +123,24 @@ const { TableServiceClient, AzureNamedKeyCredential } = require("@azure/data-tab
 
 The `TableServiceClient` requires a URL to the table service and an access credential. It also optionally accepts some settings in the `options` parameter.
 
+#### `TableServiceClient` with AzureNamedKeyCredential
+
+You can instantiate a `TableServiceClient` with a `AzureNamedKeyCredential` by passing account-name and account-key as arguments. (The account-name and account-key can be obtained from the azure portal.)
+[ONLY AVAILABLE IN NODE.JS RUNTIME]
+
+```javascript
+const { TableServiceClient, AzureNamedKeyCredential } = require("@azure/data-tables");
+
+const account = "<account>";
+const accountKey = "<accountkey>";
+
+const credential = new AzureNamedKeyCredential(account, accountKey);
+const serviceClient = new TableServiceClient(
+  `https://${account}.table.core.windows.net`,
+  credential
+);
+```
+
 #### `TableServiceClient` with TokenCredential (AAD)
 
 Azure Tables provides integration with Azure Active Directory (Azure AD) for identity-based authentication of requests
@@ -220,7 +238,7 @@ const serviceClient = new TableServiceClient(
 
 async function main() {
   const tableName = `newtable`;
-  // If the table 'newTable' already exists, createTable doesn' throw
+  // If the table 'newTable' already exists, createTable doesn't throw
   await serviceClient.createTable(tableName);
 }
 
@@ -326,6 +344,36 @@ const clientWithSAS = new TableClient(
 );
 ```
 
+#### `TableClient` with TokenCredential (AAD)
+
+Azure Tables provides integration with Azure Active Directory (Azure AD) for identity-based authentication of requests
+to the Table service when targeting a Storage endpoint. With Azure AD, you can use role-based access control (RBAC) to
+grant access to your Azure Table resources to users, groups, or applications.
+
+To access a table resource with a `TokenCredential`, the authenticated identity should have either the "Storage Table Data Contributor" or "Storage Table Data Reader" role.
+
+With the `@azure/identity` package, you can seamlessly authorize requests in both development and production environments.
+To learn more about Azure AD integration in Azure Storage, see the [Azure.Identity README](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/README.md)
+
+```javascript
+const { TableClient } = require("@azure/data-tables");
+const { DefaultAzureCredential } = require("@azure/identity");
+
+// DefaultAzureCredential expects the following three environment variables:
+// - AZURE_TENANT_ID: The tenant ID in Azure Active Directory
+// - AZURE_CLIENT_ID: The application (client) ID registered in the AAD tenant
+// - AZURE_CLIENT_SECRET: The client secret for the registered application
+const credential = new DefaultAzureCredential();
+const account = "<account name>";
+const tableName = "<tableName>";
+
+const clientWithAAD = new TableClient(
+  `https://${account}.table.core.windows.net`,
+  tableName,
+  credential
+);
+```
+
 #### List Entities in a table
 
 You can list entities within a table by through a `TableClient` instance calling the `listEntities` function. This function returns a `PageableAsyncIterator` that you can consume using `for-await-of`

package/dist/index.js

@@ -3854,7 +3854,8 @@ class InternalTableTransaction {
      * @param partitionKey - partition key
      * @param credential - credential to authenticate the transaction request
      */
-    constructor(url, partitionKey, transactionId, changesetId, interceptClient, credential, allowInsecureConnection = false) {
+    constructor(url, partitionKey, transactionId, changesetId, clientOptions, interceptClient, credential, allowInsecureConnection = false) {
+        this.clientOptions = clientOptions;
         this.credential = credential;
         this.url = url;
         this.interceptClient = interceptClient;
@@ -3949,7 +3950,7 @@ class InternalTableTransaction {
     async submitTransaction() {
         await Promise.all(this.resetableState.pendingOperations);
         const body = getTransactionHttpRequestBody(this.resetableState.bodyParts, this.resetableState.transactionId, this.resetableState.changesetId);
-        const options = {};
+        const options = this.clientOptions;
         if (coreAuth.isTokenCredential(this.credential)) {
             options.credentialScopes = STORAGE_SCOPE;
             options.credential = this.credential;
@@ -4393,10 +4394,10 @@ class TableClient {
         this.tableName = tableName;
         const credential = isCredential(credentialOrOptions) ? credentialOrOptions : undefined;
         this.credential = credential;
-        const clientOptions = (!isCredential(credentialOrOptions) ? credentialOrOptions : options) || {};
-        this.allowInsecureConnection = (_a = clientOptions.allowInsecureConnection) !== null && _a !== void 0 ? _a : false;
-        clientOptions.endpoint = clientOptions.endpoint || this.url;
-        const internalPipelineOptions = Object.assign(Object.assign(Object.assign({}, clientOptions), { loggingOptions: {
+        this.clientOptions = (!isCredential(credentialOrOptions) ? credentialOrOptions : options) || {};
+        this.allowInsecureConnection = (_a = this.clientOptions.allowInsecureConnection) !== null && _a !== void 0 ? _a : false;
+        this.clientOptions.endpoint = this.clientOptions.endpoint || this.url;
+        const internalPipelineOptions = Object.assign(Object.assign(Object.assign({}, this.clientOptions), { loggingOptions: {
                 logger: logger.info,
                 additionalAllowedHeaderNames: [...TablesLoggingAllowedHeaderNames]
             }, deserializationOptions: {
@@ -4953,7 +4954,7 @@ class TableClient {
         const changesetId = Uuid.generateUuid();
         if (!this.transactionClient) {
             // Add pipeline
-            this.transactionClient = new InternalTableTransaction(this.url, partitionKey, transactionId, changesetId, new TableClient(this.url, this.tableName), this.credential, this.allowInsecureConnection);
+            this.transactionClient = new InternalTableTransaction(this.url, partitionKey, transactionId, changesetId, this.clientOptions, new TableClient(this.url, this.tableName), this.credential, this.allowInsecureConnection);
         }
         else {
             this.transactionClient.reset(transactionId, changesetId, partitionKey);