Skip to content

Commit b40392e

Browse files
authored
Merge pull request #242979 from flang-msft/fxl---Update-screenshots-when-new-functionality-is-available-in-Import-article
fxl---Updated images for managed identity
2 parents 5e18c2d + 0556907 commit b40392e

File tree

4 files changed

+18
-17
lines changed

4 files changed

+18
-17
lines changed

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

Lines changed: 18 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: flang-msft
55

66
ms.service: cache
77
ms.topic: conceptual
8-
ms.date: 03/24/2023
8+
ms.date: 06/26/2023
99
ms.author: franlanglois
1010

1111
---
@@ -14,12 +14,13 @@ ms.author: franlanglois
1414
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.
1515

1616
Import/Export is supported in the Premium, Enterprise, and Enterprise Flash tiers:
17+
1718
- _Export_ - you can export your Azure Cache for Redis RDB snapshots to a Page Blob (Premium tier) or Block Blob (Enterprise tiers).
1819
- _Import_ - you can import your Azure Cache for Redis RDB snapshots from either a Page Blob or a Block Blob.
1920

2021
You can use Import/Export to migrate between different Azure Cache for Redis instances or populate the cache with data before use.
2122

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.
2324

2425
## Scope of availability
2526

@@ -30,7 +31,7 @@ This article provides a guide for importing and exporting data with Azure Cache
3031
## Compatibility
3132

3233
- 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.
3435
- 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)
3536
- RDB files from _Premium_ tier caches can be imported into _Enterprise_ and _Enterprise Flash_ tier caches.
3637

@@ -39,7 +40,7 @@ This article provides a guide for importing and exporting data with Azure Cache
3940
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.
4041

4142
> [!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.
4344
4445
> [!IMPORTANT]
4546
> 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
7172
:::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.":::
7273

7374
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+
7576
> [!IMPORTANT]
7677
> Activity log support is not yet available in the Enterprise tiers.
77-
>
78+
>
7879
7980
:::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.":::
8081

@@ -86,7 +87,7 @@ Export allows you to export the data stored in Azure Cache for Redis to Redis co
8687

8788
:::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":::
8889

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.
9091

9192
> [!IMPORTANT]
9293
>
@@ -137,9 +138,9 @@ The _import_ and _export_ features are available only in the _Premium_, _Enterpr
137138

138139
### Can I import data from any Redis server?
139140

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.
141142

142-
For example, you might want to:
143+
For example, you might want to:
143144

144145
1. Export the data from your production cache.
145146

@@ -152,7 +153,7 @@ For example, you might want to:
152153
153154
### What RDB versions can I import?
154155

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

157158
### Is my cache available during an Import/Export operation?
158159

@@ -176,25 +177,25 @@ Some pricing tiers have different [databases limits](cache-configure.md#database
176177

177178
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.
178179
<!-- 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.
180181

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.
182183

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.
185186

186187
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).
187188

188189
### Can I automate Import/Export using PowerShell, CLI, or other management clients?
189190

190191
Yes, see the following instructions for the _Premium_ tier:
191192

192-
- PowerShell instructions [to import Redis data](cache-how-to-manage-redis-cache-powershell.md#to-import-an-azure-cache-for-redis) and [to export Redis data](cache-how-to-manage-redis-cache-powershell.md#to-export-an-azure-cache-for-redis).
193+
- PowerShell instructions [to import Redis data](cache-how-to-manage-redis-cache-powershell.md#to-import-an-azure-cache-for-redis) and [to export Redis data](cache-how-to-manage-redis-cache-powershell.md#to-export-an-azure-cache-for-redis).
193194
- Azure CLI instructions to [import Redis data](/cli/azure/redis#az-redis-import) and [export Redis data](/cli/azure/redis#az-redis-export)
194195

195196
For the _Enterprise_ and _Enterprise Flash_ tiers:
196197

197-
- PowerShell instructions [to import Redis data](/powershell/module/az.redisenterprisecache/import-azredisenterprisecache) and [to export Redis data](/powershell/module/az.redisenterprisecache/export-azredisenterprisecache).
198+
- PowerShell instructions [to import Redis data](/powershell/module/az.redisenterprisecache/import-azredisenterprisecache) and [to export Redis data](/powershell/module/az.redisenterprisecache/export-azredisenterprisecache).
198199
- 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)
199200

200201
### 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
219220

220221
### Can I import or export data from a storage account in a different subscription than my cache?
221222

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.
223224

224225
## Next steps
225226

Loading
10.4 KB
Loading
-4.91 KB
Loading

0 commit comments

Comments
 (0)