Updating titles for migrate docs

SnehaGunda · SnehaGunda · commit 1299fe71152e · 2018-08-28T19:14:07.000-07:00
diff --git a/articles/cosmos-db/cassandra-import-data.md b/articles/cosmos-db/cassandra-import-data.md
@@ -13,9 +13,9 @@ ms.date: 11/15/2017
 ms.author: govindk
 ms.custom: mvc
 ---
-# Azure Cosmos DB: Import Cassandra data
+# Migrate your data to Azure Cosmos DB Cassandra API account
 
-This tutorial provides instructions on importing Cassandra data into Azure Cosmos DB using the Cassandra Query Language (CQL) COPY command. 
+This tutorial provides instructions on importing Cassandra data into Azure Cosmos DB by using the Cassandra Query Language (CQL) COPY command. 
 
 This tutorial covers the following tasks:
 
@@ -26,11 +26,13 @@ This tutorial covers the following tasks:
 
 # Prerequisites
 
-* Install [Apache Cassandra](http://cassandra.apache.org/download/) and specifically ensure *cqlsh* is present.
-* Increase throughput: The duration of your data migration depends on the amount of throughput you provisioned for your Tables. Be sure to increase the throughput for larger data migrations. After you've completed the migration, decrease the throughput to save costs. For more information about increasing throughput in the [Azure portal](https://portal.azure.com), see [Set throughput for Azure Cosmos DB containers](set-throughput.md).
+* Install [Apache Cassandra](http://cassandra.apache.org/download/) and specifically ensure *cqlsh* is present.  
+
+* Increase throughput: The duration of your data migration depends on the amount of throughput you provisioned for your Tables. Be sure to increase the throughput for larger data migrations. After you've completed the migration, decrease the throughput to save costs. For more information about increasing throughput in the [Azure portal](https://portal.azure.com), see [Set throughput for Azure Cosmos DB containers](set-throughput.md).  
+
 * Enable SSL: Azure Cosmos DB has strict security requirements and standards. Be sure to enable SSL when you interact with your account. When you use CQL with SSH, you have an option to provide SSL information. 
 
-## Find your connection string
+## Get your connection string
 
 1. In the [Azure portal](https://portal.azure.com), on the far left, click **Azure Cosmos DB**.
 
@@ -40,14 +42,14 @@ This tutorial covers the following tasks:
 
     ![Connection string page](./media/cassandra-import-data/keys.png)
 
-## Use cqlsh COPY
+## Migrate data by using cqlsh COPY
 
 To import Cassandra data into Azure Cosmos DB for use with the Cassandra API, use the following guidance:
 
 1. Log in to cqhsh using the connection information from the portal.
 2. Use the [CQL COPY command](http://cassandra.apache.org/doc/latest/tools/cqlsh.html#cqlsh) to copy local data to the Apache Cassandra API endpoint. Ensure the source and target are in same datacenter to minimize latency issues.
 
-### Guide for moving data with cqlsh
+### Steps to move data with cqlsh
 
 1. Pre-create and scale your table:
     * By default, Azure Cosmos DB provisions a new Cassandra API table with 1,000 request units per second (RU/s) (CQL-based creation is provisioned with 400 RU/s). Before you start the migration by using cqlsh, pre-create all your tables from the [Azure portal](https://portal.azure.com) or from cqlsh. 
@@ -75,11 +77,11 @@ To import Cassandra data into Azure Cosmos DB for use with the Cassandra API, us
 
 5. Run the final migration command. Running this command assumes you have started cqlsh using the connection string information.
 
-   ```
+   ```bash
    COPY exampleks.tablename FROM filefolderx/*.csv 
    ```
 
-## Use Spark to import data
+## Migrate data by using Spark
 
 For data residing in an existing cluster in Azure virtual machines, importing data using Spark is also feasible option. This requires Spark to be set up as intermediary for one time or regular ingestion. 
 
diff --git a/articles/cosmos-db/import-data.md b/articles/cosmos-db/import-data.md
@@ -14,11 +14,12 @@ ms.date: 03/30/2018
 ms.author: dech
 ms.custom: mvc
 ---
-# Azure Cosmos DB: Data migration tool
+# Use Data migration tool to migrate your data to Azure Cosmos DB 
 
 This tutorial provides instructions on using the Azure Cosmos DB Data Migration tool, which can import data from various sources into Azure Cosmos DB collections and tables. You can import from JSON files, CSV files, SQL, MongoDB, Azure Table storage, Amazon DynamoDB, and even Azure Cosmos DB SQL API collections, and you migrate that data to collections and tables for use with Azure Cosmos DB. The Data Migration tool can also be used when migrating from a single partition collection to a multi-partition collection for the SQL API.
 
 Which API are you going to use with Azure Cosmos DB? 
+
 * **[SQL API](documentdb-introduction.md)** - You can use any of the source options provided in the Data Migration tool to import data.
 * **[Table API](table-introduction.md)** - You can use the Data Migration tool or AzCopy to import data. See [Import data for use with the Azure Cosmos DB Table API](table-import.md) for more information.
 * **[MongoDB API](mongodb-introduction.md)** - The Data Migration tool does not currently support Azure Cosmos DB MongoDB API either as a source or as a target. If you want to migrate the data in or out of MongoDB API collections in Azure Cosmos DB, refer to [Azure Cosmos DB: How to migrate data for the MongoDB API](mongodb-migrate.md) for instructions. You can still use the Data Migration tool to export data from MongoDB to Azure Cosmos DB SQL API collections for use with the SQL API. 
diff --git a/articles/cosmos-db/mongodb-migrate.md b/articles/cosmos-db/mongodb-migrate.md
@@ -15,7 +15,7 @@ ms.author: sclyon
 ms.custom: mvc
 ---
 
-# Azure Cosmos DB: Import MongoDB data 
+# Migrate your data to Azure Cosmos DB MongoDB API account
 
 To migrate data from MongoDB to an Azure Cosmos DB account for use with the API for MongoDB, you must:
 
@@ -38,7 +38,7 @@ This tutorial covers the following tasks:
 
 * Enable SSL: Azure Cosmos DB has strict security requirements and standards. Be sure to enable SSL when you interact with your account. The procedures in the rest of the article include how to enable SSL for mongoimport and mongorestore.
 
-## Find your connection string information (host, port, username, and password)
+## Get your connection string 
 
 1. In the [Azure portal](https://portal.azure.com), in the left pane, click the **Azure Cosmos DB** entry.
 1. In the **Subscriptions** pane, select your account name.
@@ -48,43 +48,51 @@ This tutorial covers the following tasks:
 
    ![Connection String blade](./media/mongodb-migrate/ConnectionStringBlade.png)
 
-## Import data to the API for MongoDB by using mongoimport
+## Migrate data by using mongoimport
 
 To import data to your Azure Cosmos DB account, use the following template. Fill in *host*, *username*, and *password* with the values that are specific to your account.  
 
 Template:
 
-    mongoimport.exe --host <your_hostname>:10255 -u <your_username> -p <your_password> --db <your_database> --collection <your_collection> --ssl --sslAllowInvalidCertificates --type json --file C:\sample.json
+```bash
+    mongoimport.exe --host <your_hostname>:10255 -u <your_username> -p <your_password> --db <your_database> --collection <your_collection> --ssl --sslAllowInvalidCertificates --type json --file "C:\sample.json"
+```
 
 Example:  
 
-    mongoimport.exe --host cosmosdb-mongodb-account.documents.azure.com:10255 -u cosmosdb-mongodb-account -p tkvaVkp4Nnaoirnouenrgisuner2435qwefBH0z256Na24frio34LNQasfaefarfernoimczciqisAXw== --ssl --sslAllowInvalidCertificates --db sampleDB --collection sampleColl --type json --file C:\Users\admin\Desktop\*.json
+```bash
+    mongoimport.exe --host cosmosdb-mongodb-account.documents.azure.com:10255 -u cosmosdb-mongodb-account -p tkvaVkp4Nnaoirnouenrgisuner2435qwefBH0z256Na24frio34LNQasfaefarfernoimczciqisAXw== --ssl --sslAllowInvalidCertificates --db sampleDB --collection sampleColl --type json --file "C:\Users\admin\Desktop\*.json"
+```
 
-## Import data to the API for MongoDB by using mongorestore
+## Migrate data by using mongorestore
 
 To restore data to your API for MongoDB account, use the following template to execute the import. Fill in *host*, *username*, and *password* with the values that are specific to your account.
 
 Template:
 
+```bash
     mongorestore.exe --host <your_hostname>:10255 -u <your_username> -p <your_password> --db <your_database> --collection <your_collection> --ssl --sslAllowInvalidCertificates <path_to_backup>
+```
 
 Example:
 
+```bash
     mongorestore.exe --host cosmosdb-mongodb-account.documents.azure.com:10255 -u cosmosdb-mongodb-account -p tkvaVkp4Nnaoirnouenrgisuner2435qwefBH0z256Na24frio34LNQasfaefarfernoimczciqisAXw== --ssl --sslAllowInvalidCertificates ./dumps/dump-2016-12-07
+```
     
-## Guide for a successful migration
+## Steps for a successful migration
 
 1. Pre-create and scale your collections:
         
-    * By default, Azure Cosmos DB provisions a new MongoDB collection with 1,000 request units per second (RU/sec). Before you start the migration by using mongoimport, mongorestore, or mongomirror, pre-create all your collections from the [Azure portal](https://portal.azure.com) or from MongoDB drivers and tools. If your collection is greater than 10 GB, make sure to create a [sharded/partitioned collection](partition-data.md) with an appropriate shard key.
+    * By default, Azure Cosmos DB provisions a new MongoDB collection with 1,000 request units per second (RU/sec). Before you start the migration by using mongoimport, mongorestore, pre-create all your collections from the [Azure portal](https://portal.azure.com) or from MongoDB drivers and tools. If the data size is greater than 10 GB, make sure to create a [sharded/partitioned collection](partition-data.md) with an appropriate shard key.
 
-    * From the [Azure portal](https://portal.azure.com), increase your collections' throughput from 1,000 RUs/sec for a single partition collection and 2,500 RUs/sec for a sharded collection just for the migration. With the higher throughput, you can avoid rate limiting and migrate in less time. With hourly billing in Azure Cosmos DB, you can reduce the throughput immediately after the migration to save costs.
+    * From the [Azure portal](https://portal.azure.com), increase your collections throughput from 1000 RUs/sec for a single partition collection and 2,500 RUs/sec for a sharded collection just for the migration. With the higher throughput, you can avoid rate limiting and migrate in less time. You can reduce the throughput immediately after the migration to save costs.
 
     * In addition to provisioning RUs/sec at the collection level, you may also provision RU/sec for a set of collections at the parent database level. This requires pre-creating the database and collections, as well as defining a shard key for each collection.
 
     * You can create sharded collections through your favorite tool, driver, or SDK. In this example, we use the Mongo Shell to create a sharded collection:
 
-        ```
+        ```bash
         db.runCommand( { shardCollection: "admin.people", key: { region: "hashed" } } )
         ```
     
@@ -100,15 +108,17 @@ Example:
 
 1. Calculate the approximate RU charge for a single document write:
 
-    a. Connect to your Azure Cosmos DB MongoDB database from the MongoDB Shell. You can find instructions in [Connect a MongoDB application to Azure Cosmos DB](connect-mongodb-account.md).
-    
-    b. Run a sample insert command by using one of your sample documents from the MongoDB Shell:
+   a. Connect to your Azure Cosmos DB MongoDB API account from the MongoDB Shell. You can find instructions in [Connect a MongoDB application to Azure Cosmos DB](connect-mongodb-account.md).
     
-        ```db.coll.insert({ "playerId": "a067ff", "hashedid": "bb0091", "countryCode": "hk" })```
+   b. Run a sample insert command by using one of your sample documents from the MongoDB Shell:
+   
+      ```bash
+      db.coll.insert({ "playerId": "a067ff", "hashedid": "bb0091", "countryCode": "hk" })
+      ```
         
-    c. Run ```db.runCommand({getLastRequestStatistics: 1})``` and you'll receive a response like the following:
+   c. Run ```db.runCommand({getLastRequestStatistics: 1})``` and you'll receive a response like the following:
      
-        ```
+      ```bash
         globaldb:PRIMARY> db.runCommand({getLastRequestStatistics: 1})
         {
             "_t": "GetRequestStatisticsResponse",
@@ -117,7 +127,7 @@ Example:
             "RequestCharge": 10,
             "RequestDurationInMilliSeconds": NumberLong(50)
         }
-        ```
+      ```
         
     d. Take note of the request charge.
     
@@ -156,12 +166,12 @@ Example:
 
 1. Run the final migration command:
 
-   ```
+   ```bash
    mongoimport.exe --host cosmosdb-mongodb-account.documents.azure.com:10255 -u cosmosdb-mongodb-account -p wzRJCyjtLPNuhm53yTwaefawuiefhbauwebhfuabweifbiauweb2YVdl2ZFNZNv8IU89LqFVm5U0bw== --ssl --sslAllowInvalidCertificates --jsonArray --db dabasename --collection collectionName --file "C:\sample.json" --numInsertionWorkers 4 --batchSize 24
    ```
    Or with mongorestore (make sure all collections have the throughput set at or above the amount of RUs used in previous calculations):
    
-   ```
+   ```bash
    mongorestore.exe --host cosmosdb-mongodb-account.documents.azure.com:10255 -u cosmosdb-mongodb-account -p wzRJCyjtLPNuhm53yTwaefawuiefhbauwebhfuabweifbiauweb2YVdl2ZFNZNv8IU89LqFVm5U0bw== --ssl --sslAllowInvalidCertificates ./dumps/dump-2016-12-07 --numInsertionWorkersPerCollection 4 --batchSize 24
    ```
 
diff --git a/articles/cosmos-db/table-import.md b/articles/cosmos-db/table-import.md
@@ -14,9 +14,9 @@ ms.author: sngun
 
 ---
 
-# Import data for use with the Azure Cosmos DB Table API
+# Migrate your data to Azure Cosmos DB Table API account
 
-This tutorial provides instructions on importing data for use with the Azure Cosmos DB [Table API](table-introduction.md). If you have data stored in Azure Table storage, you can use either the Data Migration Tool or AzCopy to import your data. If you have data stored in an Azure Cosmos DB Table API (preview) account, you must use the Data Migration tool to migrate your data. Once your data is imported, you'll be able to take advantage of the premium capabilities Azure Cosmos DB offers, such as turnkey global distribution, dedicated throughput, single-digit millisecond latencies at the 99th percentile, guaranteed high availability, and automatic secondary indexing.
+This tutorial provides instructions on importing data for use with the Azure Cosmos DB [Table API](table-introduction.md). If you have data stored in Azure Table storage, you can use either the Data Migration Tool or AzCopy to import your data to Azure Cosmos DB Table API. If you have data stored in an Azure Cosmos DB Table API (preview) account, you must use the Data Migration tool to migrate your data. 
 
 This tutorial covers the following tasks:
 
@@ -36,11 +36,11 @@ The command-line Azure Cosmos DB Data Migration tool (dt.exe) can be used to imp
 To perform a migration of table data, complete the following tasks:
 
 1. Download the migration tool from [GitHub](https://github.com/azure/azure-documentdb-datamigrationtool).
-2. Run `dt.exe` using the command-line arguments for your scenario.
-
-dt.exe takes a command in the following format:
+2. Run `dt.exe` using the command-line arguments for your scenario. `dt.exe` takes a command in the following format:
 
+   ```bash
     dt.exe [/<option>:<value>] /s:<source-name> [/s.<source-option>:<value>] /t:<target-name> [/t.<target-option>:<value>] 
+```
 
 Options for the command are:
 
@@ -102,7 +102,7 @@ Here is a command-line sample to import from Table API preview to Table API GA:
 dt /s:AzureTable /s.ConnectionString:DefaultEndpointsProtocol=https;AccountName=<Table API preview account name>;AccountKey=<Table API preview account key>;TableEndpoint=https://<Account Name>.documents.azure.com; /s.Table:<Table name> /t:TableAPIBulk /t.ConnectionString:DefaultEndpointsProtocol=https;AccountName=<Azure Cosmos DB account name>;AccountKey=<Azure Cosmos DB account key>;TableEndpoint=https://<Account name>.table.cosmosdb.azure.com:443 /t.TableName:<Table name> /t.Overwrite
 ```
 
-## AzCopy command
+## Migrate data by using AzCopy
 
 Using the AzCopy command-line utility is the other option for migrating data from Azure Table storage to the Azure Cosmos DB Table API. To use AzCopy, you first export your data as described in [Export data from Table storage](../storage/common/storage-use-azcopy.md#export-data-from-table-storage), then import the data to Azure Cosmos DB as described in [Azure Cosmos DB Table API](../storage/common/storage-use-azcopy.md#import-data-into-table-storage).
 
