Skip to content

Commit 4195fd5

Browse files
committed
final touchups
1 parent b9152f9 commit 4195fd5

File tree

3 files changed

+32
-21
lines changed

3 files changed

+32
-21
lines changed

articles/azure-cache-for-redis/cache-how-to-import-export-data.md

Lines changed: 32 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,15 @@ description: Learn how to import and export data to and from blob storage with y
77
ms.topic: conceptual
88
ms.custom:
99
- ignite-2024
10-
ms.date: 04/28/2025
10+
ms.date: 04/29/2025
1111
appliesto:
1212
- ✅ Azure Cache for Redis
1313
---
1414
# Import and export data in Azure Cache for Redis
1515

16-
You can use Azure Cache for Redis import and export functionality for data management. You import or export data to or from your cache instance as a Redis Database (RDB) snapshot using blob data in an Azure Storage account.
16+
Azure Cache for Redis import and export functionality imports or exports data to or from Azure Redis cache instances as Redis Database (RDB) snapshots. The snapshots are imported or exported using a blob in an Azure Storage account.
1717

18-
You can use import and export to migrate between different Redis cache instances or to populate a cache with data before use. This article describes how to import and export data in Azure Redis, and answers commonly asked questions.
18+
You can use Azure Redis import and export functionality for data management, to migrate between different cache instances, or to populate a cache with data before use. This article describes how to import and export data in Azure Redis, and answers commonly asked questions.
1919

2020
## Scope of availability
2121

@@ -27,33 +27,40 @@ Import and export are supported in the Premium, Enterprise, and Enterprise Flash
2727

2828
## Compatibility
2929

30-
- You can import your RDB snapshots from either page blobs or block blobs in Premium or Enterprise tiers.
30+
**Import**
31+
- You can import your RDB snapshots from either page blobs or block blobs.
3132
- You can import RDB files from Premium tier caches into Enterprise and Enterprise Flash tier caches.
32-
- You can't import from Redis Enterprise tiers to Premium tier.
33+
- You can't import from Redis Enterprise and Enterprise Flash tier caches into Premium tier caches.
34+
35+
**Export**
3336
- You can export your snapshots as RDB page blobs in Premium tier, or as `.gz` block blobs in Enterprise tiers.
3437
- Blob storage accounts don't support export.
35-
- Caches running Redis 4.0 support RDB version 8 and below. Caches running Redis 6.0 support RDB version 9 and below.
36-
- You can't import exported backups from newer versions of Redis like Redis 6.0 into older versions like Redis 4.0.
38+
39+
**Versions**
40+
- Redis 4.0 caches support RDB version 8 and below. Redis 6.0 caches support RDB version 9 and below.
41+
- You can't import exported backups from newer Redis versions like Redis 6.0 into older versions like Redis 4.0.
3742

3843
## Prerequisites
3944

40-
- A Premium or Enterprise tier cache in Azure Cache for Redis.
45+
- A Premium, Enterprise, or Enterprise Flash tier cache in Azure Cache for Redis.
4146
- To import files, an RDB file or files uploaded into page or block blobs in Azure Storage, in the same region and subscription as your Azure Redis cache.
42-
- If you use managed identity for storage account authentication, the storage account can be in a different subscription.
43-
- If you follow the [Export](#export) procedure first, your RDB file is already stored in a page blob and is ready for importing.
47+
> [!NOTE]
48+
> If you use managed identity for storage account authentication, the storage account can be in a different subscription.
4449
4550
## Import
4651

47-
You can use import to bring Redis-compatible RDB files from any Redis server running in any cloud or environment, including Linux, Windows, or other cloud providers such as Amazon Web Services. Importing data is an easy way to create a cache with prepopulated data. During the import process, Azure Redis loads the RDB files from Azure Storage into memory and then inserts the keys into the cache.
52+
You can use import to bring Redis-compatible RDB files from any Redis server running in any cloud or environment, including Linux, Windows, or other cloud providers such as Amazon Web Services. Importing data is an easy way to create a cache with prepopulated data.
4853

49-
> [!NOTE]
50-
> Before importing, ensure that your RDB file or files are uploaded into page or block blobs in Azure Storage.
54+
During the import process, Azure Redis loads the RDB files from Azure Storage into memory and then inserts the keys into the cache.
5155

5256
> [!IMPORTANT]
53-
> Importing from Redis Enterprise tiers to Premium tier isn't supported.
57+
> Importing data deletes preexisting cache data, and the cache isn't accessible by cache clients during the import process.
5458
5559
> [!IMPORTANT]
56-
> Importing data deletes preexisting cache data, and the cache isn't accessible by cache clients during the import process.
60+
> Importing from Redis Enterprise tiers to Premium tier isn't supported.
61+
62+
> [!NOTE]
63+
> Before importing, ensure that your RDB file or files are uploaded into page or block blobs in Azure Storage. If you follow the [Export](#export) procedure first, your RDB file is already stored in a page blob and is ready for importing.
5764
5865
1. To import one or more cache blobs, on your Redis cache page in the Azure portal, select **Import data** under **Administration** on the left navigation menu.
5966

@@ -65,7 +72,7 @@ You can use import to bring Redis-compatible RDB files from any Redis server run
6572

6673
:::image type="content" source="./media/cache-how-to-import-export-data/cache-import-choose-storage-account.png" alt-text="Screenshot showing a list of storage accounts.":::
6774

68-
1. On the **Containers** page, select the container that contains the data to import.
75+
1. On the **Containers** page, select the container within the storage account that contains the data to import.
6976

7077
:::image type="content" source="./media/cache-how-to-import-export-data/cache-import-choose-container.png" alt-text="Screenshot showing a list of containers in the storage account.":::
7178

@@ -83,7 +90,7 @@ You can monitor import progress by following the notifications from the Azure po
8390

8491
## Export
8592

86-
The export process exports the data stored in your Azure Redis cache to RDB files. You can use this feature to move data from one Azure Cache for Redis instance to another instance or to another Redis server.
93+
The export process exports the data stored in your Azure Redis cache to RDB files. You can use this feature to move data from one Azure Redis cache or server to another.
8794

8895
During the export process, a temporary file is created on the virtual machine that hosts the Azure Redis server instance. The file is then uploaded to the chosen storage account. When the export operation completes with either success or failure, the temporary file is deleted.
8996

@@ -104,7 +111,7 @@ During the export process, a temporary file is created on the virtual machine th
104111

105112
:::image type="content" source="./media/cache-how-to-import-export-data/cache-import-choose-storage-account.png" alt-text="Screenshot showing a list of storage accounts.":::
106113

107-
1. On the **Containers** page, if you want to create a new container for the export, select **Container** and on the **New Container** page, enter a name for the container and select **Create**.
114+
1. On the **Containers** page, if you want to create a new container for the export, select **Container**, and on the **New Container** page, enter a name for the container and select **Create**.
108115

109116
:::image type="content" source="./media/cache-how-to-import-export-data/cache-export-data-choose-storage-container.png" alt-text="Screenshot showing Export data selected in the Resource menu":::
110117

@@ -144,7 +151,9 @@ The import and export features are available only in the Premium, Enterprise, an
144151

145152
### Can I import data from any Redis server?
146153

147-
Yes, you can import data that was exported from Azure Redis instances. You can import RDB files from any Redis server running in any cloud or environment, including Linux, Windows, or other cloud providers like Amazon Web Services. To import this data, upload the RDB file from the Redis server into a page or block blob in an Azure Storage account. Then import it into your Azure Redis cache instance.
154+
Yes, you can import data that was exported from Azure Redis instances. You can import RDB files from any Redis server running in any cloud or environment, including Linux, Windows, or other cloud providers like Amazon Web Services.
155+
156+
To import this data, upload the RDB file from the Redis server into a page or block blob in an Azure Storage account. Then import it into your Azure Redis cache instance.
148157

149158
For example, you might want to export the data from your production cache, and then import it into a cache that's part of a staging environment for testing or migration.
150159

@@ -181,7 +190,7 @@ When you configure data persistence, your cache persists a snapshot of the data
181190

182191
On the Premium tier, the data persistence file is stored in Azure Storage, but you can't import the file into a different cache. On the Enterprise tiers, the data persistence file is stored in a mounted disk that isn't user-accessible.
183192

184-
If a catastrophic event disables both the primary and the replica caches, the cache data is restored automatically using the most recent snapshot. Data persistence is designed for disaster recovery, and isn't intended as a PITR mechanism.
193+
If a catastrophic event disables both the primary and the replica caches, the persisted cache data is restored automatically using the most recent snapshot. Data persistence is designed for disaster recovery, and isn't intended as a PITR mechanism.
185194

186195
To make periodic data backups for PITR, use the import-export functionality. For more information, see [How to configure data persistence for Azure Cache for Redis](cache-how-to-premium-persistence.md).
187196

@@ -215,7 +224,9 @@ To resolve this error, start the import or export operation before 15 minutes el
215224

216225
### Why did I get an error when exporting my data to Azure Blob Storage?
217226

218-
Export works only with RDB files stored as page blobs. Other blob types aren't supported, including blob storage accounts with hot and cool tiers. For more information, see [Azure storage account overview](/azure/storage/common/storage-account-overview). If you use an access key to authenticate a storage account, having firewall exceptions on the storage account can cause the import-export process to fail.
227+
Export works only with RDB files stored as page blobs. Other blob types aren't supported, including blob storage accounts with hot and cool tiers. For more information, see [Azure storage account overview](/azure/storage/common/storage-account-overview).
228+
229+
If you use an access key to authenticate a storage account, having firewall exceptions on the storage account can cause the import-export processes to fail.
219230

220231
### What if I have firewall enabled on my storage account?
221232

98 Bytes
Loading
-992 Bytes
Loading

0 commit comments

Comments
 (0)