Merge pull request #204334 from iriaosara/cqlshupdate

Updating cqlsh copy

Author: PRMerger5

articles/cosmos-db/cassandra/cassandra-support.md

@@ -247,7 +247,30 @@ You can connect to the Cassandra API in Azure Cosmos DB by using the CQLSH insta
 
 **Windows:**
 
-If using windows, we recommend you enable the [Windows filesystem for Linux](/windows/wsl/install-win10#install-the-windows-subsystem-for-linux). You can then follow the linux commands below.
+<!-- If using windows, we recommend you enable the [Windows filesystem for Linux](/windows/wsl/install-win10#install-the-windows-subsystem-for-linux). You can then follow the linux commands below. -->
+
+1. Install [Python 2.7](https://www.python.org/downloads/release/python-2718/)    
+    1. Select the Windows x86-64 MSI installer version 
+1. Install PIP
+    1. Before install PIP, download the get-pip.py file.
+    1. Launch a command prompt if it isn't already open. To do so, open the Windows search bar, type cmd and select the icon.
+    1. Then, run the following command to download the get-pip.py file:
+    ```bash
+    curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py 
+    ```
+1. Install PIP on Windows
+```bash
+python get-pip.py
+```
+1. Verify the PIP installation (look for a message from step 3 to confirm which folder PIP was installed in and then navigate to that folder and run the command pip help).
+1. Install CQLSH using PIP
+```bash
+pip3 install cqlsh==5.0.3
+```
+1. Run the [CQLSH using the authentication mechanism](manage-data-cqlsh.md#update-your-connection-string).
+
+> [!NOTE]
+>  You would need to set the environment variables to point to  the Python27 folder.
 
 **Install on Unix/Linux/Mac:**
 

articles/cosmos-db/cassandra/migrate-data.md

@@ -96,6 +96,35 @@ Use the [CQL COPY command](https://cassandra.apache.org/doc/latest/cassandra/too
    ```bash
    COPY exampleks.tablename FROM 'data.csv' WITH HEADER = TRUE;
    ```
+> [!NOTE]
+> Cassandra API supports protocol version 4, which shipped with Cassandra 3.11. There may be issues with using later protocol versions with our API. COPY FROM with later protocol version can go into a loop and return duplicate rows. 
+> Add the protocol-version to the cqlsh command.
+```sql
+cqlsh <USERNAME>.cassandra.cosmos.azure.com 10350 -u <USERNAME> -p <PASSWORD> --ssl --protocol-version=4
+```
+##### Add throughput-limiting options to CQL Copy command
+
+The COPY command in cqlsh supports various parameters to control the rate of ingestion of documents into Azure Cosmos DB.
+
+The default configuration for COPY command tries to ingest data at very fast pace and does not account for the rate-limiting behavior of CosmosDB. You should reduce the CHUNKSIZE or INGESTRATE depending on the throughput configured on the collection.
+
+We recommend the below configuration (at minimum) for a collection at 20,000 RUs if the document or record size is 1 KB.
+
+- CHUNKSIZE = 100
+- INGESTRATE = 500
+- MAXATTEMPTS = 10
+
+###### Example commands
+
+- Copying data from Cassandra API to local csv file
+```sql
+COPY standard1 (key, "C0", "C1", "C2", "C3", "C4") TO 'backup.csv' WITH PAGESIZE=100 AND MAXREQUESTS=1 ;
+```
+
+- Copying data from local csv file to Cassandra API
+```sql
+COPY standard2 (key, "C0", "C1", "C2", "C3", "C4") FROM 'backup.csv' WITH CHUNKSIZE=100 AND INGESTRATE=100 AND MAXATTEMPTS=10;
+```
 
 >[!IMPORTANT]
 > Only the open-source Apache Cassandra version of CQLSH COPY is supported. Datastax Enterprise (DSE) versions of CQLSH may encounter errors.