You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cosmos-db/how-to-container-copy.md
+6-1Lines changed: 6 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ This article describes how to create, monitor, and manage intra-account containe
18
18
## Pre-requisites
19
19
20
20
* 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 accountbelongs 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.
**Note**: *'--job-name'* should be unique for each job within an account.
71
72
72
73
## Monitor the progress of a container copy job
73
74
@@ -112,6 +113,10 @@ az cosmosdb dts resume `
112
113
--job-name $jobName
113
114
```
114
115
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
+
115
120
## Next steps
116
121
117
122
- For more information about intra-account container copy jobs, see [Container copy jobs](intra-account-container-copy.md).
Copy file name to clipboardExpand all lines: articles/cosmos-db/intra-account-container-copy.md
+8-7Lines changed: 8 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,11 +26,11 @@ Intra-account container copy jobs can be [created and managed using CLI commands
26
26
27
27
## Get started
28
28
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.
30
30
31
31
## Overview of steps needed to do container copy
32
32
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.).
34
34
2. Stop the operations on the source container by pausing the application instances or any clients connecting to it.
35
35
3.[Create the container copy job](how-to-container-copy.md).
36
36
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
40
40
41
41
Intra-account container copy jobs perform offline data copy using the source container's incremental change feed log.
42
42
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.
44
44
* The instances are allocated when one or more container copy jobs are created within the account.
45
45
* The container copy jobs run on these instances.
46
+
* A single job is executed across all instances at any time.
46
47
* The instances are shared by all the container copy jobs running within the same account.
47
48
* The platform may de-allocate the instances if they're idle for >15 mins.
48
49
49
50
> [!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.
52
53
53
54
54
55
## 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
87
88
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.
88
89
89
90
### 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.
91
92
* 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.
0 commit comments