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/operational-excellence/relocation-cosmos-db.md
+20-9Lines changed: 20 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,30 +33,41 @@ This article describes how to either:
33
33
34
34
- Identify all Cosmos DB dependent resources.
35
35
36
+
37
+
## Downtime
38
+
39
+
## Considerations for Service Endpoints
40
+
41
+
The virtual network service endpoints for Azure Cosmos DB restrict access to a specified virtual network. The endpoints can also restrict access to a list of IPv4 (internet protocol version 4) address ranges. Any user connecting to the Event Hubs from outside those sources is denied access. If Service endpoints were configured in the source region for the Event Hubs resource, the same would need to be done in the target one.
42
+
43
+
For a successful recreation of the Azure Cosmos DB to the target region, the VNet and Subnet must be created beforehand. In case the move of these two resources is being carried out with the Azure Resource Mover tool, the service endpoints won’t be configured automatically. Hence, they need to be configured manually, which can be done through the [Azure portal](/azure/key-vault/general/quick-create-portal), the [Azure CLI](/azure/key-vault/general/quick-create-cli), or [Azure PowerShell](/azure/key-vault/general/quick-create-powershell).
44
+
45
+
46
+
36
47
## Redeploy without data
37
48
38
-
For cases where the Cosmos DB instance needs to be relocated alone without the configuration and customer data, the instance itself can be created using [Microsoft.DocumentDB databaseAccounts](https://learn.microsoft.com/azure/templates/microsoft.documentdb/2021-04-15/databaseaccounts?tabs=json&pivots=deployment-language-arm-template)
49
+
For cases where the Cosmos DB instance needs to be relocated alone without the configuration and customer data, the instance itself can be created using [Microsoft.DocumentDB databaseAccounts](/azure/templates/microsoft.documentdb/2021-04-15/databaseaccounts?tabs=json&pivots=deployment-language-arm-template)
39
50
40
51
## Redeploy with data
41
52
42
53
Azure Cosmos DB supports data replication natively, so moving data from one region to another is simple. You can accomplish it by using the Azure portal, Azure PowerShell, or the Azure CLI. It involves the following steps:
43
54
44
55
1. Add a new region to the account.
45
56
46
-
To add a new region to an Azure Cosmos DB account, see [Add/remove regions to an Azure Cosmos DB account](../cosmos-db/nosql/how-to-manage-database-account.yml#add-remove-regions-from-your-database-account).
57
+
To add a new region to an Azure Cosmos DB account, see [Add/remove regions to an Azure Cosmos DB account](../cosmos-db/how-to-manage-database-account.yml#add-remove-regions-from-your-database-account).
47
58
48
59
1. Perform a manual failover to the new region.
49
60
50
61
When the region that's being removed is currently the write region for the account, you'll need to start a failover to the new region added in the previous step. This is a zero-downtime operation. If you're moving a read region in a multiple-region account, you can skip this step.
51
62
52
-
To start a failover, see [Perform manual failover on an Azure Cosmos DB account](../cosmos-db/nosql/how-to-manage-database-account.yml#perform-manual-failover-on-an-azure-cosmos-db-account).
63
+
To start a failover, see [Perform manual failover on an Azure Cosmos DB account](../cosmos-db/how-to-manage-database-account.yml#perform-manual-failover-on-an-azure-cosmos-db-account).
53
64
54
65
1. Remove the original region.
55
66
56
-
To remove a region from an Azure Cosmos DB account, see [Add/remove regions from your Azure Cosmos DB account](../cosmos-db/nosql/how-to-manage-database-account.yml#add-remove-regions-from-your-database-account).
67
+
To remove a region from an Azure Cosmos DB account, see [Add/remove regions from your Azure Cosmos DB account](../cosmos-db/how-to-manage-database-account.yml#add-remove-regions-from-your-database-account).
57
68
58
69
> [!NOTE]
59
-
> If you perform a failover operation or add/remove a new region while an [asynchronous throughput scaling operation](../cosmos-db/nosql/scaling-provisioned-throughput-best-practices.md#background-on-scaling-rus) is in progress, the throughput scale-up operation will be paused. It will resume automatically when the failover or add/remove region operation is complete.
70
+
> If you perform a failover operation or add/remove a new region while an [asynchronous throughput scaling operation](../cosmos-db/scaling-provisioned-throughput-best-practices.md#background-on-scaling-rus) is in progress, the throughput scale-up operation will be paused. It will resume automatically when the failover or add/remove region operation is complete.
60
71
61
72
## Redeploy Azure Cosmos DB account metadata
62
73
@@ -65,7 +76,7 @@ Azure Cosmos DB does not natively support migrating account metadata from one re
65
76
> [!IMPORTANT]
66
77
> It is not necessary to migrate the account metadata if the data is stored or moved to a different region. The region in which the account metadata resides has no impact on the performance, security or any other operational aspects of your Azure Cosmos DB account.
67
78
68
-
A near-zero-downtime migration for the API for NoSQL requires the use of the [change feed](../cosmos-db/nosql/change-feed.md) or a tool that uses it.
79
+
A near-zero-downtime migration for the API for NoSQL requires the use of the [change feed](../cosmos-db/change-feed.md) or a tool that uses it.
69
80
70
81
The following steps demonstrate how to migrate an Azure Cosmos DB account for the API for NoSQL and its data from one region to another:
71
82
@@ -85,7 +96,7 @@ The following steps demonstrate how to migrate an Azure Cosmos DB account for th
85
96
86
97
With the Live Data Migration sample still running, update the connection information in the new deployment of your application. You can retrieve the endpoints and keys for your application from the Azure portal.
87
98
88
-
:::image type="content" source="./media/secure-access-to-data/nosql-database-security-master-key-portal.png" alt-text="Access control in the Azure portal, demonstrating NoSQL database security.":::
99
+
:::image type="content" source="../cosmos-db/media/secure-access-to-data/nosql-database-security-master-key-portal.png" alt-text="Access control in the Azure portal, demonstrating NoSQL database security.":::
89
100
90
101
1. Redirect requests to the new application.
91
102
@@ -99,5 +110,5 @@ The following steps demonstrate how to migrate an Azure Cosmos DB account for th
99
110
100
111
For more information and examples on how to manage the Azure Cosmos DB account as well as databases and containers, read the following articles:
101
112
102
-
*[Manage an Azure Cosmos DB account](../cosmos-db/nosql/how-to-manage-database-account.yml)
103
-
*[Change feed in Azure Cosmos DB](../cosmos-db/nosql/change-feed.md)
113
+
*[Manage an Azure Cosmos DB account](../cosmos-db/how-to-manage-database-account.yml)
114
+
*[Change feed in Azure Cosmos DB](../cosmos-db/change-feed.md)
0 commit comments