Skip to content

Commit 057afdd

Browse files
committed
edit
1 parent e958168 commit 057afdd

File tree

1 file changed

+20
-9
lines changed

1 file changed

+20
-9
lines changed

articles/operational-excellence/relocation-cosmos-db.md

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -33,30 +33,41 @@ This article describes how to either:
3333

3434
- Identify all Cosmos DB dependent resources.
3535

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+
3647
## Redeploy without data
3748

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)
3950

4051
## Redeploy with data
4152

4253
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:
4354

4455
1. Add a new region to the account.
4556

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).
4758

4859
1. Perform a manual failover to the new region.
4960

5061
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.
5162

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).
5364

5465
1. Remove the original region.
5566

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).
5768

5869
> [!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.
6071
6172
## Redeploy Azure Cosmos DB account metadata
6273

@@ -65,7 +76,7 @@ Azure Cosmos DB does not natively support migrating account metadata from one re
6576
> [!IMPORTANT]
6677
> 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.
6778
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.
6980

7081
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:
7182

@@ -85,7 +96,7 @@ The following steps demonstrate how to migrate an Azure Cosmos DB account for th
8596

8697
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.
8798

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.":::
89100

90101
1. Redirect requests to the new application.
91102

@@ -99,5 +110,5 @@ The following steps demonstrate how to migrate an Azure Cosmos DB account for th
99110

100111
For more information and examples on how to manage the Azure Cosmos DB account as well as databases and containers, read the following articles:
101112

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

Comments
 (0)