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/azure-cache-for-redis/cache-how-to-import-export-data.md
+32-21Lines changed: 32 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,15 @@ description: Learn how to import and export data to and from blob storage with y
7
7
ms.topic: conceptual
8
8
ms.custom:
9
9
- ignite-2024
10
-
ms.date: 04/28/2025
10
+
ms.date: 04/29/2025
11
11
appliesto:
12
12
- ✅ Azure Cache for Redis
13
13
---
14
14
# Import and export data in Azure Cache for Redis
15
15
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.
17
17
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.
19
19
20
20
## Scope of availability
21
21
@@ -27,33 +27,40 @@ Import and export are supported in the Premium, Enterprise, and Enterprise Flash
27
27
28
28
## Compatibility
29
29
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.
31
32
- 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**
33
36
- You can export your snapshots as RDB page blobs in Premium tier, or as `.gz` block blobs in Enterprise tiers.
34
37
- 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.
37
42
38
43
## Prerequisites
39
44
40
-
- A Premiumor Enterprise tier cache in Azure Cache for Redis.
45
+
- A Premium, Enterprise, or Enterprise Flash tier cache in Azure Cache for Redis.
41
46
- 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.
44
49
45
50
## Import
46
51
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.
48
53
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.
51
55
52
56
> [!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.
54
58
55
59
> [!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.
57
64
58
65
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.
59
66
@@ -65,7 +72,7 @@ You can use import to bring Redis-compatible RDB files from any Redis server run
65
72
66
73
:::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.":::
67
74
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.
69
76
70
77
:::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.":::
71
78
@@ -83,7 +90,7 @@ You can monitor import progress by following the notifications from the Azure po
83
90
84
91
## Export
85
92
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.
87
94
88
95
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.
89
96
@@ -104,7 +111,7 @@ During the export process, a temporary file is created on the virtual machine th
104
111
105
112
:::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.":::
106
113
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**.
108
115
109
116
:::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":::
110
117
@@ -144,7 +151,9 @@ The import and export features are available only in the Premium, Enterprise, an
144
151
145
152
### Can I import data from any Redis server?
146
153
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.
148
157
149
158
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.
150
159
@@ -181,7 +190,7 @@ When you configure data persistence, your cache persists a snapshot of the data
181
190
182
191
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.
183
192
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.
185
194
186
195
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).
187
196
@@ -215,7 +224,9 @@ To resolve this error, start the import or export operation before 15 minutes el
215
224
216
225
### Why did I get an error when exporting my data to Azure Blob Storage?
217
226
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.
219
230
220
231
### What if I have firewall enabled on my storage account?
0 commit comments