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
+18-17Lines changed: 18 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ author: flang-msft
5
5
6
6
ms.service: cache
7
7
ms.topic: conceptual
8
-
ms.date: 03/24/2023
8
+
ms.date: 06/26/2023
9
9
ms.author: franlanglois
10
10
11
11
---
@@ -14,12 +14,13 @@ ms.author: franlanglois
14
14
Use the import and export functionality in Azure Cache for Redis as a data management operation. You import data into your cache instance or export data from a cache instance using an Azure Cache for Redis Database (RDB) snapshot. The snapshots are imported or exported using a blob in an Azure Storage Account.
15
15
16
16
Import/Export is supported in the Premium, Enterprise, and Enterprise Flash tiers:
17
+
17
18
-_Export_ - you can export your Azure Cache for Redis RDB snapshots to a Page Blob (Premium tier) or Block Blob (Enterprise tiers).
18
19
-_Import_ - you can import your Azure Cache for Redis RDB snapshots from either a Page Blob or a Block Blob.
19
20
20
21
You can use Import/Export to migrate between different Azure Cache for Redis instances or populate the cache with data before use.
21
22
22
-
This article provides a guide for importing and exporting data with Azure Cache for Redis and provides the answers to commonly asked questions.
23
+
This article provides a guide for importing and exporting data with Azure Cache for Redis and provides the answers to commonly asked questions.
23
24
24
25
## Scope of availability
25
26
@@ -30,7 +31,7 @@ This article provides a guide for importing and exporting data with Azure Cache
30
31
## Compatibility
31
32
32
33
- Data is exported as an RDB page blob in the _Premium_ tier. In the _Enterprise_ and _Enterprise Flash_ tiers, data is exported as a .gz block blob.
33
-
- Caches running Redis 4.0 support RDB version 8 and below. Caches running Redis 6.0 support RDB version 9 and below.
34
+
- Caches running Redis 4.0 support RDB version 8 and below. Caches running Redis 6.0 support RDB version 9 and below.
34
35
- Exported backups from newer versions of Redis (for example, Redis 6.0) can't be imported into older versions of Redis (for example, Redis 4.0)
35
36
- RDB files from _Premium_ tier caches can be imported into _Enterprise_ and _Enterprise Flash_ tier caches.
36
37
@@ -39,7 +40,7 @@ This article provides a guide for importing and exporting data with Azure Cache
39
40
Use import to bring Redis compatible RDB files from any Redis server running in any cloud or environment, including Redis running on Linux, Windows, or any cloud provider such as Amazon Web Services and others. Importing data is an easy way to create a cache with prepopulated data. During the import process, Azure Cache for Redis loads the RDB files from Azure storage into memory and then inserts the keys into the cache.
40
41
41
42
> [!NOTE]
42
-
> Before beginning the import operation, ensure that your Redis Database (RDB) file or files are uploaded into page or block blobs in Azure storage, in the same region and subscription as your Azure Cache for Redis instance. For more information, see [Get started with Azure Blob storage](../storage/blobs/storage-quickstart-blobs-dotnet.md). If you exported your RDB file using the [Azure Cache for Redis Export](#export) feature, your RDB file is already stored in a page blob and is ready for importing.
43
+
> Before beginning the import operation, ensure that your Redis Database (RDB) file or files are uploaded into page or block blobs in Azure storage, in the same region and subscription as your Azure Cache for Redis instance. If you are using managed identity for authentication, the storage account can be in a different subscription. For more information, see [Get started with Azure Blob storage](../storage/blobs/storage-quickstart-blobs-dotnet.md). If you exported your RDB file using the [Azure Cache for Redis Export](#export) feature, your RDB file is already stored in a page blob and is ready for importing.
43
44
44
45
> [!IMPORTANT]
45
46
> Currently, importing from Redis Enterprise tier to Premium tier is not supported.
@@ -71,10 +72,10 @@ Use import to bring Redis compatible RDB files from any Redis server running in
71
72
:::image type="content" source="./media/cache-how-to-import-export-data/cache-import-blobs.png" alt-text="Screenshot showing the Import button to select to begin the import.":::
72
73
73
74
You can monitor the progress of the import operation by following the notifications from the Azure portal, or by viewing the events in the [activity log](../azure-monitor/essentials/activity-log.md).
74
-
75
+
75
76
> [!IMPORTANT]
76
77
> Activity log support is not yet available in the Enterprise tiers.
77
-
>
78
+
>
78
79
79
80
:::image type="content" source="./media/cache-how-to-import-export-data/cache-import-data-import-complete.png" alt-text="Screenshot showing the import progress in the notifications area.":::
80
81
@@ -86,7 +87,7 @@ Export allows you to export the data stored in Azure Cache for Redis to Redis co
86
87
87
88
:::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":::
88
89
89
-
2. Select **Choose Storage Container** and to display a list of available storage accounts. Select the storage account you want. The storage account must be in the same subscription and region as your cache.
90
+
2. Select **Choose Storage Container** and to display a list of available storage accounts. Select the storage account you want. The storage account must be in the same region as your cache. If you're using managed identity for authentication, the storage account can be in a different subscription. Otherwise, the storage account must be in the same subscription as your cache.
90
91
91
92
> [!IMPORTANT]
92
93
>
@@ -137,9 +138,9 @@ The _import_ and _export_ features are available only in the _Premium_, _Enterpr
137
138
138
139
### Can I import data from any Redis server?
139
140
140
-
Yes, you can import data that was exported from Azure Cache for Redis instances. You can import RDB files from any Redis server running in any cloud or environment. The environments include Linux, Windows, or cloud providers such as Amazon Web Services. To do import this data, upload the RDB file from the Redis server you want into a page or block blob in an Azure Storage Account. Then, import it into your premium Azure Cache for Redis instance.
141
+
Yes, you can import data that was exported from Azure Cache for Redis instances. You can import RDB files from any Redis server running in any cloud or environment. The environments include Linux, Windows, or cloud providers such as Amazon Web Services. To do import this data, upload the RDB file from the Redis server you want into a page or block blob in an Azure Storage Account. Then, import it into your premium Azure Cache for Redis instance.
141
142
142
-
For example, you might want to:
143
+
For example, you might want to:
143
144
144
145
1. Export the data from your production cache.
145
146
@@ -152,7 +153,7 @@ For example, you might want to:
152
153
153
154
### What RDB versions can I import?
154
155
155
-
For more information on supported RDB versions used with import, see the [compatibility section](#compatibility).
156
+
For more information on supported RDB versions used with import, see the [compatibility section](#compatibility).
156
157
157
158
### Is my cache available during an Import/Export operation?
158
159
@@ -176,25 +177,25 @@ Some pricing tiers have different [databases limits](cache-configure.md#database
176
177
177
178
The Azure Cache for Redis _persistence_ feature is primarily a data durability feature. Conversely, the _import/export_ functionality is designed as a method to make periodic data backups for point-in-time recovery.
178
179
<!-- Kyle I rewrote this based on another convo. Also I want the primary answer to be in the first paragraph. -->
179
-
When _persistence_ is configured, your cache persists a snapshot of the data to disk, based on a configurable backup frequency. The data is written with a Redis-proprietary binary format. If a catastrophic event occurs that disables both the primary and the replica caches, the cache data is restored automatically using the most recent snapshot.
180
+
When _persistence_ is configured, your cache persists a snapshot of the data to disk, based on a configurable backup frequency. The data is written with a Redis-proprietary binary format. If a catastrophic event occurs that disables both the primary and the replica caches, the cache data is restored automatically using the most recent snapshot.
180
181
181
-
Data persistence is designed for disaster recovery. It isn't intended as a point-in-time recovery mechanism.
182
+
Data persistence is designed for disaster recovery. It isn't intended as a point-in-time recovery mechanism.
182
183
183
-
- On the Premium tier, the data persistence file is stored in Azure Storage, but the file can't be imported into a different cache.
184
-
- On the Enterprise tiers, the data persistence file is stored in a mounted disk that isn't user-accessible.
184
+
- On the Premium tier, the data persistence file is stored in Azure Storage, but the file can't be imported into a different cache.
185
+
- On the Enterprise tiers, the data persistence file is stored in a mounted disk that isn't user-accessible.
185
186
186
187
If you want to make periodic data backups for point-in-time recovery, we recommend using 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
188
188
189
### Can I automate Import/Export using PowerShell, CLI, or other management clients?
189
190
190
191
Yes, see the following instructions for the _Premium_ tier:
- Azure CLI instructions to [import Redis data](/cli/azure/redisenterprise/database#az-redisenterprise-database-import) and [export Redis data](/cli/azure/redisenterprise/database#az-redisenterprise-database-export)
199
200
200
201
### I received a timeout error during my Import/Export operation. What does it mean?
@@ -219,7 +220,7 @@ More information here - [Managed identity for storage accounts - Azure Cache for
219
220
220
221
### Can I import or export data from a storage account in a different subscription than my cache?
221
222
222
-
In the _Premium_ tier, you can import and export data from a storage account in a different subscription than your cache, but you must use [managed identity](cache-managed-identity.md) as the authentication method. You will need to select the chosen subscription holding the storage account when configuring the import or export.
223
+
In the _Premium_ tier, you can import and export data from a storage account in a different subscription than your cache, but you must use [managed identity](cache-managed-identity.md) as the authentication method. You will need to select the chosen subscription holding the storage account when configuring the import or export.
0 commit comments