Add upsert operation to BatchClient and upgrade samples (Azure#14799)

* Add upsert operation to BatchClient and upgrade samples

* delete legacy samples

* Remove locale

* Fix links

* Fix samples logger issue

* Re-publish samples

Author: joheredi

sdk/tables/data-tables/package.json

@@ -18,13 +18,13 @@
     "build:autorest": "autorest ./swagger/README.md --typescript --package-version=1.0.0-beta.4 --version=3.0.6267 --v3=true",
     "build:browser": "tsc -p . && cross-env ONLY_BROWSER=true rollup -c 2>&1",
     "build:node": "tsc -p . && cross-env ONLY_NODE=true rollup -c 2>&1",
-    "build:samples": "dev-tool samples prep && cd dist-samples && tsc",
+    "build:samples": "echo Obsolete.",
     "build:test": "tsc -p . && rollup -c rollup.test.config.js 2>&1",
     "build:types": "downlevel-dts types/latest types/3.1",
     "build": "tsc -p . && rollup -c 2>&1 && api-extractor run --local",
     "check-format": "prettier --list-different \"src/**/*.ts\" \"test/**/*.ts\" \"*.{js,json}\"",
     "clean": "rimraf dist dist-* types *.tgz *.log",
-    "execute:samples": "echo Skipped.",
+    "execute:samples": "dev-tool samples run samples-dev",
     "extract-api": "tsc -p . && api-extractor run --local",
     "format": "prettier --write --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.ts\" \"test/**/*.ts\" \"*.{js,json}\"",
     "integration-test:browser": "karma start --single-run --testMode=integration",
@@ -125,6 +125,16 @@
     "ts-node": "^9.0.0",
     "typedoc": "0.15.2"
   },
+  "//sampleConfiguration": {
+    "productName": "Azure Data Tables",
+    "productSlugs": [
+      "azure",
+      "azure-table-storage"
+    ],
+    "requiredResources": {
+      "Azure Storage instance": "https://docs.microsoft.com/azure/storage/tables/table-storage-quickstart-portal"
+    }
+  },
   "//metadata": {
     "constantPaths": [
       {

sdk/tables/data-tables/recordings/browsers/batch_operations/recording_should_send_a_set_of_upsert_batch_operations.json

@@ -244,6 +244,7 @@ export interface TableBatch {
     partitionKey: string;
     submitBatch: () => Promise<TableBatchResponse>;
     updateEntity: <T extends object>(entity: TableEntity<T>, mode: UpdateMode, options?: UpdateTableEntityOptions) => void;
+    upsertEntity: <T extends object>(entity: TableEntity<T>, mode: UpdateMode, options?: UpsertTableEntityOptions) => void;
 }
 
 // @public

sdk/tables/data-tables/recordings/node/batch_operations/recording_should_send_a_set_of_upsert_batch_operations.js

@@ -0,0 +1,91 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+/**
+ * This sample demonstrates how to use the different methods of authentication
+ * to make calls to the Azure Tables Service
+ *
+ * @summary authenticates using different authentication methods
+ * @azsdk-weight 40
+ */
+import { TableServiceClient, TablesSharedKeyCredential } from "@azure/data-tables";
+
+// Load the .env file if it exists
+import * as dotenv from "dotenv";
+dotenv.config();
+
+// URL of the tables endpoint
+const tablesUrl = process.env["TABLES_URL"] || "";
+
+// You can find your storage account's name, connection strings and keys in the Azure portal.
+// Navigate to Settings > Access keys in your storage account's menu blade to see connection strings for both primary and secondary access keys
+const accountConnectionString = process.env["ACCOUNT_CONNECTION_STRING"] || "";
+const accountName = process.env["ACCOUNT_NAME"] || "";
+const accountKey = process.env["ACCOUNT_KEY"] || "";
+
+// You can generate a SAS connection string and token for your storage account in the Azure Portal
+// Navigate to Settings > "Shared access signature" in your storage account's menu blade select the Allowed services, resource types, permissions and expiry options
+// and generate your SAS and connection string.
+const sasConnectionString = process.env["SAS_CONNECTION_STRING"] || "";
+const sasToken = process.env["SAS_TOKEN"] || "";
+
+/**
+ * Create a TableServiceCLient using a SAS connection String
+ */
+async function tableServiceClientWithSasConnectionString() {
+  const client = TableServiceClient.fromConnectionString(sasConnectionString);
+  countTablesWithClient(client);
+}
+
+/**
+ * Create a TableServiceCLient using a SAS token
+ */
+async function tableServiceClientWithSasToken() {
+  const client = new TableServiceClient(`${tablesUrl}${sasToken}`);
+  countTablesWithClient(client);
+}
+
+/**
+ * Create a TableServiceCLient using an Account connection String.
+ * Note that this authentication method is only supported in Node,
+ * and it is not available for browsers
+ */
+async function tableServiceClientWithAccountConnectionString() {
+  const client = TableServiceClient.fromConnectionString(accountConnectionString);
+  countTablesWithClient(client);
+}
+
+/**
+ * Create a TableServiceCLient using account name and account key
+ * Note that this authentication method is only supported in Node,
+ * and it is not available for browsers
+ */
+async function tableServiceClientWithAccountKey() {
+  const creds = new TablesSharedKeyCredential(accountName, accountKey);
+  const client = new TableServiceClient(tablesUrl, creds);
+  countTablesWithClient(client);
+}
+
+async function countTablesWithClient(client: TableServiceClient) {
+  const tablesIterator = client.listTables();
+  let count = 0;
+  for await (const _table of tablesIterator) {
+    count++;
+  }
+
+  console.log(`Listed ${count} tables`);
+}
+
+export async function main() {
+  console.log("== Client Authentication Methods Sample ==");
+
+  await tableServiceClientWithSasConnectionString();
+  await tableServiceClientWithSasToken();
+
+  await tableServiceClientWithAccountConnectionString();
+  await tableServiceClientWithAccountKey();
+}
+
+main().catch((err) => {
+  console.error("The sample encountered an error:", err);
+});