Importare ed esportare dati in Cache Redis di AzureImport and Export data in Azure Redis Cache

L'importazione/esportazione è un'operazione di gestione dati di Cache Redis di Azure che consente di importare o esportare dati da Cache Redis di Azure, importando o esportando uno snapshot del database di Cache Redis (RDB) da una cache Premium a un BLOB in un account di Archiviazione di Azure.Import/Export is an Azure Redis Cache data management operation, which allows you to import data into Azure Redis Cache or export data from Azure Redis Cache by importing and exporting a Redis Cache Database (RDB) snapshot from a premium cache to a blob in an Azure Storage Account.

  • Esportare: è possibile esportare gli snapshot RDB di Cache Redis di Azure in un BLOB di pagine.Export - you can export your Azure Redis Cache RDB snapshots to a Page Blob.
  • Importare: è possibile importare gli snapshot RDB di Cache Redis da un BLOB di pagine o da un BLOB in blocchi.Import - you can import your Redis Cache RDB snapshots from either a Page Blob or a Block Blob.

L'operazione Importa/Esporta consente di eseguire la migrazione tra diverse istanze di Cache Redis di Azure o di popolare la cache con i dati prima dell'uso.Import/Export enables you to migrate between different Azure Redis Cache instances or populate the cache with data before use.

Questo articolo è una guida all'importazione e all'esportazione dei dati con Cache Redis di Azure e include le risposte alle domande più frequenti.This article provides a guide for importing and exporting data with Azure Redis Cache and provides the answers to commonly asked questions.

Importante

La funzionalità Importazione/Esportazione è disponibile in anteprima solo per le cache del piano Premium .Import/Export is in preview and is only available for premium tier caches.

ImportaImport

L'importazione può essere usata per spostare i file RDB compatibili con Redis da qualsiasi server Redis in esecuzione su qualsiasi cloud o ambiente, compresi i server Redis in esecuzione su Linux, Windows o su altri provider di servizi cloud come Amazon Web Services e altri.Import can be used 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. L'importazione dei dati è un modo semplice per creare una cache con dati già popolati.Importing data is an easy way to create a cache with pre-populated data. Durante il processo di importazione Cache Redis di Azure carica i file RDB dall'archiviazione di Azure nella memoria e quindi inserisce le chiavi nella cache.During the import process, Azure Redis Cache loads the RDB files from Azure storage into memory and then inserts the keys into the cache.

Nota

Prima di avviare l'operazione di importazione, assicurarsi che il file o i file di database Redis (RDB) siano caricati nei BLOB di pagine o nei BLOB in blocchi in Archiviazione di Azure, nella stessa area e nella stessa sottoscrizione dell'istanza di Cache Redis di Azure.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 Redis Cache instance. Per altre informazioni, vedere Introduzione all'archivio BLOB di Azure.For more information, see Get started with Azure Blob storage. Se il file RDB è stato esportato con la funzionalità Esportazione di Cache Redis di Azure , è già archiviato in un BLOB di pagine ed è pronto per l'importazione.If you exported your RDB file using the Azure Redis Cache Export feature, your RDB file is already stored in a page blob and is ready for importing.

  1. Per importare uno o più BLOB di cache esportati, passare alla cache nel portale di Azure e fare clic su Importa dati dal menu della risorsa.To import one or more exported cache blobs, browse to your cache in the Azure portal and click Import data from the Resource menu.

    Importa dati

  2. Fare clic su Scegliere i BLOB e selezionare l'account di archiviazione che contiene i dati da importare.Click Choose Blob(s) and select the storage account that contains the data to import.

    Scegliere l'account di archiviazione

  3. Fare clic sul contenitore che contiene i dati da importare.Click the container that contains the data to import.

    Scegliere il contenitore

  4. Selezionare uno o più BLOB da importare facendo clic sull'area a sinistra del nome del BLOB e quindi fare clic su Seleziona.Select one or more blobs to import by clicking the area to the left of the blob name, and then click Select.

    Scegliere il BLOB

  5. Fare clic su Importa per avviare il processo di importazione.Click Import to begin the import process.

    Importante

    Durante il processo di importazione la cache non è accessibile ai client della cache ed eventuali dati esistenti nella cache vengono eliminati.The cache is not accessible by cache clients during the import process, and any existing data in the cache is deleted.

    Importa

    È possibile controllare lo stato dell'operazione di importazione tramite le notifiche del portale di Azure oppure visualizzando gli eventi nel log di controllo.You can monitor the progress of the import operation by following the notifications from the Azure portal, or by viewing the events in the audit log.

    Stato dell'importazione

EsportazioneExport

L'esportazione consente di esportare i dati memorizzati in Cache Redis di Azure in file RDB compatibili con Redis.Export allows you to export the data stored in Azure Redis Cache to Redis compatible RDB file(s). È possibile usare questa funzionalità per spostare i dati da un'istanza di Cache Redis di Azure a un'altra o su un altro server Redis.You can use this feature to move data from one Azure Redis Cache instance to another or to another Redis server. Durante il processo di esportazione viene creato un file temporaneo nella VM che ospita l'istanza del server Cache Redis di Azure e il file viene caricato nell'account di archiviazione designato.During the export process, a temporary file is created on the VM that hosts the Azure Redis Cache server instance, and the file is uploaded to the designated storage account. Quando l'operazione di esportazione viene completata con esito positivo o negativo, il file temporaneo viene eliminato.When the export operation completes with either a status of success or failure, the temporary file is deleted.

  1. Per esportare il contenuto corrente della cache nell'archiviazione, passare alla cache nel portale di Azure e fare clic su Esporta dati dal menu della risorsa.To export the current contents of the cache to storage, browse to your cache in the Azure portal and click Export data from the Resource menu.

    Scegliere il contenitore di archiviazione

  2. Fare clic su Scegliere il contenitore di archiviazione e selezionare l'account di archiviazione desiderato.Click Choose Storage Container and select the desired storage account. L'account di archiviazione deve trovarsi nella stessa area e nella stessa sottoscrizione della cache.The storage account must be in the same subscription and region as your cache.

    Importante

    La funzionalità di esportazione è compatibile con i BLOB di pagine, supportati dagli account di archiviazione di Azure Resource Manager e della versione classica ma al momento non supportati dagli account di archiviazione BLOB.Export works with page blobs, which are supported by both classic and Resource Manager storage accounts, but are not supported by Blob storage accounts at this time.

    Account di archiviazione

  3. Scegliere il contenitore BLOB desiderato e fare clic su Seleziona.Choose the desired blob container and click Select. Per usare un nuovo contenitore, fare clic su Aggiungi contenitore per aggiungerlo prima e quindi selezionarlo dall'elenco.To use new a container, click Add Container to add it first and then select it from the list.

    Scegliere il contenitore di archiviazione

  4. Digitare un valore in Prefisso nome BLOB e fare clic su Esporta per avviare il processo di esportazione.Type a Blob name prefix and click Export to start the export process. Il prefisso del nome BLOB viene usato per i nomi dei file generati da questa operazione di esportazione.The blob name prefix is used to prefix the names of files generated by this export operation.

    Esportazione

    È possibile controllare lo stato dell'operazione di esportazione seguendo le notifiche del portale di Azure oppure visualizzando gli eventi nel log di controllo.You can monitor the progress of the export operation by following the notifications from the Azure portal, or by viewing the events in the audit log.

    Esportazione dei dati completa

    Durante il processo di esportazione le cache rimangono disponibili per l'uso.Caches remain available for use during the export process.

Domande frequenti su Importazione/EsportazioneImport/Export FAQ

Questa sezione contiene le domande frequenti relative alla funzionalità Importazione/Esportazione.This section contains frequently asked questions about the Import/Export feature.

Con quali piani tariffari è possibile usare Importazione/Esportazione?What pricing tiers can use Import/Export?

La funzionalità Importazione/Esportazione è disponibile solo con il piano tariffario Premium.Import/Export is available only in the premium pricing tier.

È possibile importare dati da qualsiasi server Redis?Can I import data from any Redis server?

Sì. Oltre a importare i dati esportati da istanze di Cache Redis di Azure, è possibile importare i file RDB da qualsiasi server Redis in esecuzione in qualsiasi cloud o ambiente, come Linux, Windows, o provider di cloud, come Amazon Web Services.Yes, in addition to importing data exported from Azure Redis Cache instances, you can import RDB files from any Redis server running in any cloud or environment, such as Linux, Windows, or cloud providers such as Amazon Web Services. A tale scopo, caricare il file RDB dal server Redis desiderato in un BLOB di pagine o in un BLOB in blocchi di un account di Archiviazione di Azure e quindi importarlo nell'istanza di Cache Redis di Azure Premium.To do this, upload the RDB file from the desired Redis server into a page or block blob in an Azure Storage Account, and then import it into your premium Azure Redis Cache instance. È ad esempio possibile importare i dati della cache di produzione e importarli in una cache usata in un ambiente di gestione temporanea per i test o la migrazione.For example, you may want to export the data from your production cache and import it into a cache used as part of a staging environment for testing or migration.

Importante

Per importare i dati esportati da server Redis diversi da Cache Redis di Azure quando si usa un BLOB di pagine, la dimensione del BLOB di pagine deve essere allineata a un limite di 512 byte.To successfully import data exported from Redis servers other than Azure Redis Cache when using a page blob, the page blob size must be aligned on a 512 byte boundary. Per codice di esempio che esegua il byte padding richiesto, vedere SamplePageBlobUpload.For sample code to perform any required byte padding, see Sample page blog upload.

Quali versioni RDB è possibile importare?What RDB versions can I import?

Cache Redis di Azure supporta l'importazione RDB fino alla versione 7.Azure Redis Cache supports RDB import up through RDB version 7.

La cache è disponibile durante un'operazione di Importazione/Esportazione?Is my cache available during an Import/Export operation?

  • Esportazione : durante un'operazione di esportazione le cache rimangono disponibili ed è possibile continuare a usarle.Export - Caches remain available and you can continue to use your cache during an export operation.
  • Importazione : quando si avvia un'operazione di importazione le cache non sono più disponibili, ma tornano disponibili al termine dell'operazione.Import - Caches become unavailable when an import operation starts, and become available for use when the import operation completes.

È possibile usare Importazione/Esportazione con il cluster Redis?Can I use Import/Export with Redis cluster?

Sì. È inoltre possibile usare questa funzionalità tra una cache di cluster e una non di cluster.Yes, and you can import/export between a clustered cache and a non-clustered cache. Poiché il cluster Redis supporta solo database 0, i dati nei database diversi da 0 non verranno importati.Since Redis cluster only supports database 0, any data in databases other than 0 isn't imported. Quando si importano dati della cache di cluster, le chiavi vengono ridistribuite tra le partizioni del cluster.When clustered cache data is imported, the keys are redistributed among the shards of the cluster.

Come funziona Importazione/Esportazione con un'impostazione databases personalizzata?How does Import/Export work with a custom databases setting?

Alcuni piani tariffari hanno limiti di database diversi, quindi esistono alcune considerazioni da tenere presente durante l'importazione se si è configurato un valore personalizzato per l'impostazione databases durante la creazione della cache.Some pricing tiers have different databases limits, so there are some considerations when importing if you configured a custom value for the databases setting during cache creation.

  • Quando si esegue l'importazione in un piano tariffario con un limite di databases più basso del piano da cui è stata eseguita l'esportazione:When importing to a pricing tier with a lower databases limit than the tier from which you exported:
    • Se si usa il numero predefinito di databases, che è 16 per tutti i piani tariffari, non viene perso alcun dato.If you are using the default number of databases, which is 16 for all pricing tiers, no data is lost.
    • Se si usa un numero personalizzato di databases compreso nei limiti per il piano in cui si esegue l'importazione, non viene perso alcun dato.If you are using a custom number of databases that falls within the limits for the tier to which you are importing, no data is lost.
    • Se i dati esportati contenevano dati in un database che superano i limiti per il nuovo piano, i dati dei database più elevati non vengono importati.If your exported data contained data in a database that exceeds the limits of the new tier, the data from those higher databases is not imported.

Quali sono le differenze tra la funzionalità Importazione/Esportazione e la persistenza di Redis?How is Import/Export different from Redis persistence?

La persistenza di Cache Redis di Azure consente di salvare in modo permanente in Archiviazione di Azure i dati archiviati in Redis.Azure Redis Cache persistence allows you to persist data stored in Redis to Azure Storage. Quando si configura la persistenza, Cache Redis di Azure archivia uno snapshot della cache Redis in un formato binario Redis su disco in base a una frequenza di backup configurabile.When persistence is configured, Azure Redis Cache persists a snapshot of the Redis cache in a Redis binary format to disk based on a configurable backup frequency. Se si verifica un evento catastrofico che disabilita sia la cache primaria che quella di replica, i dati della cache vengono ripristinati automaticamente usando lo snapshot più recente.If a catastrophic event occurs that disables both the primary and replica cache, the cache data is restored automatically using the most recent snapshot. Per altre informazioni, vedere Come configurare la persistenza dei dati per una Cache Redis di Azure Premium.For more information, see How to configure data persistence for a Premium Azure Redis Cache.

La funzionalità Importazione/Esportazione consente di importare o esportare dati in Cache Redis di Azure,Import/ Export allows you to bring data into or export from Azure Redis Cache. ma non di configurare il backup e il ripristino usando la persistenza di Redis.It does not configure backup and restore using Redis persistence.

È possibile automatizzare la funzionalità Importazione/Esportazione con PowerShell, l'interfaccia della riga di comando o altri client di gestione?Can I automate Import/Export using PowerShell, CLI, or other management clients?

Sì, per istruzioni relative a PowerShell vedere Per importare una cache Redis e Per esportare una cache Redis.Yes, for PowerShell instructions see To import a Redis cache and To export a Redis cache.

Durante l'operazione di Importazione/Esportazione è stato ricevuto un errore di timeout.I received a timeout error during my Import/Export operation. Da cosa dipende il problema?What does it mean?

Se il pannello Importa dati o Esporta dati rimane aperto per più di 15 minuti prima che l'operazione venga avviata, verrà visualizzato un errore contenente un messaggio simile al seguente:If you remain on the Import data or Export data blade for longer than 15 minutes before initiating the operation, you receive an error with an error message similar to the following example:

The request to import data into cache 'contoso55' failed with status 'error' and error 'One of the SAS URIs provided could not be used for the following reason: The SAS token end time (se) must be at least 1 hour from now and the start time (st), if given, must be at least 15 minutes in the past.

Per risolvere il problema, avviare l'operazione di importazione o esportazione prima che scadano i 15 minuti.To resolve this, initiate the import or export operation before 15 minutes has elapsed.

Durante l'esportazione dei dati nell'archivio BLOB di Azure è stato visualizzato un errore.I got an error when exporting my data to Azure Blob Storage. Che cosa è successo?What happened?

L'esportazione funziona solo con i file RDB archiviati come BLOB di pagine.Export works only with RDB files stored as page blobs. Al momento non sono supportati altri tipi di BLOB, inclusi gli account di archiviazione BLOB con livelli di accesso frequente e non frequente.Other blob types are not currently supported, including blob storage accounts with hot and cool tiers. Per altre informazioni, vedere Account di archiviazione BLOB.For more information, see Blob storage accounts.

Passaggi successiviNext steps

Informazioni su come usare altre funzionalità di cache premium.Learn how to use more premium cache features.