Skip to content

Commit 4f84dde

Browse files
committed
Adds changes based upon review feedback.
1 parent 3a19aa2 commit 4f84dde

File tree

2 files changed

+14
-8
lines changed

2 files changed

+14
-8
lines changed

articles/cosmos-db/how-to-container-copy.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ This article describes how to create, monitor, and manage intra-account containe
1818
## Pre-requisites
1919

2020
* You may use the portal [Cloud Shell](../cloud-shell/quickstart-powershell#start-cloud-shell) to run container copy commands. Alternately, you may run the commands locally; make sure you have [Azure CLI](/cli/azure/install-azure-cli) or [Azure PowerShell](/powershell/azure/install-az-ps-msi) downloaded and installed on your machine.
21-
* Currently, container copy is only supported in [these regions](intra-account-container-copy.md#supported-regions). Make sure your account belongs to one of these regions.
21+
* Currently, container copy is only supported in [these regions](intra-account-container-copy.md#supported-regions). Make sure your account's write region belongs to this list.
2222

2323

2424
## Install the Cosmos DB preview extension
@@ -68,6 +68,7 @@ az cosmosdb dts copy `
6868
--source-cassandra-table keyspace=$sourceKeySpace table=$sourceTable `
6969
--dest-cassandra-table keyspace=$destinationKeySpace table=$destinationTable
7070
```
71+
**Note**: *'--job-name'* should be unique for each job within an account.
7172

7273
## Monitor the progress of a container copy job
7374

@@ -112,6 +113,10 @@ az cosmosdb dts resume `
112113
--job-name $jobName
113114
```
114115

116+
## Get support for container copy issues
117+
For issues related to intra-account container copy, please raise a New Support Request from the Azure Portal with the Problem Type as 'Data Migration' and Problem subtype as 'Intra-account container copy'.
118+
119+
115120
## Next steps
116121

117122
- For more information about intra-account container copy jobs, see [Container copy jobs](intra-account-container-copy.md).

articles/cosmos-db/intra-account-container-copy.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,11 @@ Intra-account container copy jobs can be [created and managed using CLI commands
2626

2727
## Get started
2828

29-
To get started using container copy jobs, register for "Intra-account offline container copy (Cassandra & SQL)" preview from the ['Preview Features'](access-previews.md) list in the Azure portal.
29+
To get started using container copy jobs, register for "Intra-account offline container copy (Cassandra & SQL)" preview from the ['Preview Features'](access-previews.md) list in the Azure portal. Once the registration is complete, the preview will be effective for all Cassandra and SQL API accounts in the subscription.
3030

3131
## Overview of steps needed to do container copy
3232

33-
1. Create the target Cosmos DB container with the required settings (partition key, throughput granularity, RUs, unique key, etc.).
33+
1. Create the target Cosmos DB container with the desired settings (partition key, throughput granularity, RUs, unique key, etc.).
3434
2. Stop the operations on the source container by pausing the application instances or any clients connecting to it.
3535
3. [Create the container copy job](how-to-container-copy.md).
3636
4. [Monitor the progress of the container copy job](how-to-container-copy.md#monitor-the-progress-of-a-container-copy-job) and wait until it's completed.
@@ -40,15 +40,16 @@ To get started using container copy jobs, register for "Intra-account offline co
4040

4141
Intra-account container copy jobs perform offline data copy using the source container's incremental change feed log.
4242

43-
* Within the platform, we allocate server-side compute instances for the Azure Cosmos DB account.
43+
* Within the platform, the platform allocates server-side compute instances for the Azure Cosmos DB account.
4444
* The instances are allocated when one or more container copy jobs are created within the account.
4545
* The container copy jobs run on these instances.
46+
* A single job is executed across all instances at any time.
4647
* The instances are shared by all the container copy jobs running within the same account.
4748
* The platform may de-allocate the instances if they're idle for >15 mins.
4849

4950
> [!NOTE]
50-
> We currently only support offline container copy. So, we strongly recommend to stop performing any operations on the source container prior to beginning the container copy.\
51-
> Item deletions and updates done on the source container after beginning the copy job may not be captured. Hence, continuing to perform operations on the source container while the container job is in progress may result in data missing on the target container.
51+
> We currently only support offline container copy jobs. So, we strongly recommend to stop performing any operations on the source container prior to beginning the container copy.\
52+
> Item deletions and updates done on the source container after beginning the copy job may not be captured. Hence, continuing to perform operations on the source container while the container job is in progress may result in additional or missing data on the target container.
5253
5354

5455
## Factors affecting the rate of a container copy job
@@ -87,9 +88,9 @@ The container copy job will run in the write region. If there are accounts confi
8788
The account's write region may change in the rare scenario of a region outage or due to manual failover. In such a scenario, incomplete container copy jobs created within the account would fail. You would need to recreate these failed jobs. Recreated jobs would then run in the new (current) write region.
8889

8990
### Why is a new database '_datatransferstate' created in the account when I run container copy jobs? Am I being charged for this database?
90-
* '_datatransferstate' is a temporary database that is created while running container copy jobs. This database is used by the platform to store the state and progress of the copy job.
91+
* '_datatransferstate' is a database that is created while running container copy jobs. This database is used by the platform to store the state and progress of the copy job.
9192
* The database uses manual provisioned throughput of 800 RUs. You'll be charged for this database.
92-
* Deleting this database will remove the container copy job history from the account. It can be safely deleted once all the jobs in the account have completed, if you no longer need the job history.
93+
* Deleting this database will remove the container copy job history from the account. It can be safely deleted once all the jobs in the account have completed, if you no longer need the job history. The platform will not clean up the '_datatransferstate' database automatically.
9394

9495
## Supported Regions
9596

0 commit comments

Comments
 (0)