Azure Cache for Redis でデータをインポートまたはエクスポートするImport and Export data in Azure Cache for Redis

Import/Export は Azure Cache for Redis のデータ管理操作です。Azure Cache for Redis データベース (RDB) のスナップショットを Premium キャッシュと Azure Storage アカウント内の BLOB の間でインポートとエクスポートを行うことで、データを Azure Cache for Redis にインポートしたり、Azure Cache for Redis からエクスポートしたりすることができます。Import/Export is an Azure Cache for Redis data management operation, which allows you to import data into Azure Cache for Redis or export data from Azure Cache for Redis by importing and exporting an Azure Cache for Redis Database (RDB) snapshot from a premium cache to a blob in an Azure Storage Account.

  • Export - ページ Blob に、Azure Cache for Redis RDB のスナップショットをエクスポートすることができます。Export - you can export your Azure Cache for Redis RDB snapshots to a Page Blob.
  • Import - ページ Blob またはブロック Blob から、Azure Cache for Redis RDB のスナップショットをインポートすることができます。Import - you can import your Azure Cache for Redis RDB snapshots from either a Page Blob or a Block Blob.

Import/Export により、異なる Azure Cache for Redis インスタンス間での移行や、使用前のキャッシュへのデータ入力が可能になります。Import/Export enables you to migrate between different Azure Cache for Redis instances or populate the cache with data before use.

この記事では Azure Cache for Redis でデータをインポートまたはエクスポートする方法を説明し、よく寄せられる質問に回答します。This article provides a guide for importing and exporting data with Azure Cache for Redis and provides the answers to commonly asked questions.

重要

Import/Export は、Premium レベルのキャッシュでのみ使用できます。Import/Export is only available for Premium tier caches.

[インポート]Import

Import は、任意のクラウドまたは環境で稼働している任意の Redis サーバー (Linux や Windows のほか、アマゾン ウェブ サービスをはじめとする各種クラウド プロバイダーで稼働している Redis など) から Redis と互換性のある RDB ファイルを取り込むときに使用できます。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. データをインポートすると、あらかじめデータが入力されたキャッシュを簡単に作成できます。Importing data is an easy way to create a cache with pre-populated data. インポート処理中に、Azure Cache for Redis では RDB ファイルが Azure Storage からメモリに読み込まれて、キーがキャッシュに挿入されます。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.

注意

インポート操作を開始する前に、Redis データベース (RDB) ファイルが、Azure Cache for Redis インスタンスと同じリージョンとサブスクリプションにある Azure Storage 内のページ BLOB またはブロック BLOB にアップロードされる設定になっていることを確認してください。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. 詳細については、 Azure Blob Storage の使用に関するページをご覧ください。For more information, see Get started with Azure Blob storage. Azure Cache for Redis の Export 機能を使って RDB ファイルをエクスポートした場合、そのファイルは既にページ BLOB に格納されており、インポートの準備ができています。If you exported your RDB file using the Azure Cache for Redis Export feature, your RDB file is already stored in a page blob and is ready for importing.

  1. エクスポートされた 1 つ以上のキャッシュ BLOB をインポートするには、Azure Portal で キャッシュを参照し、 [リソース] メニューの [データのインポート] をクリックします。To import one or more exported cache blobs, browse to your cache in the Azure portal and click Import data from the Resource menu.

    データのインポート

  2. [BLOB の選択] をクリックして、インポートするデータを含むストレージ アカウントを選択します。Click Choose Blob(s) and select the storage account that contains the data to import.

    ストレージ アカウントの選択

  3. インポートするデータが含まれているコンテナーをクリックします。Click the container that contains the data to import.

    Choose container

  4. BLOB 名の左側の領域をクリックして、インポートする 1 つ以上の BLOB を選択し、 [選択] をクリックします。Select one or more blobs to import by clicking the area to the left of the blob name, and then click Select.

    Choose blobs

  5. [インポート] をクリックしてインポート処理を開始します。Click Import to begin the import process.

    重要

    インポート処理中は、キャッシュ クライアントからキャッシュにアクセスすることはできません。また、キャッシュ内の既存データはすべて削除されます。The cache is not accessible by cache clients during the import process, and any existing data in the cache is deleted.

    [インポート]

    インポート操作の進行状況を監視するには、Azure Portal からの通知を確認するか、監査ログのイベントを確認します。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.

    Import progress

[エクスポート]Export

Export では、Azure Cache for Redis に格納されたデータを、Redis と互換性のある RDB ファイルにエクスポートできます。Export allows you to export the data stored in Azure Cache for Redis to Redis compatible RDB file(s). この機能を使えば、ある Azure Cache for Redis インスタンスから、別のインスタンスまたは別の Redis サーバーにデータを移動できます。You can use this feature to move data from one Azure Cache for Redis instance to another or to another Redis server. エクスポート処理中に、Azure Cache for Redis サーバー インスタンスをホストしている VM に一時ファイルが作成され、そのファイルが、指定されているストレージ アカウントにアップロードされます。During the export process, a temporary file is created on the VM that hosts the Azure Cache for Redis server instance, and the file is uploaded to the designated storage account. エクスポート処理が完了したら、処理の成否にかかわらず、この一時ファイルは削除されます。When the export operation completes with either a status of success or failure, the temporary file is deleted.

  1. キャッシュの現在の内容をストレージにエクスポートするには、Azure Portal で キャッシュを参照し、 [リソース] メニューの [データのエクスポート] をクリックします。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.

    Contoso5premium のナビゲーション ウィンドウで、[管理] 一覧の [データのエクスポート] オプションが強調表示されています。

  2. [ストレージ コンテナーの選択] をクリックし、目的のストレージ アカウントを選択します。Click Choose Storage Container and select the desired storage account. ストレージ アカウントは、キャッシュと同じサブスクリプションおよびリージョン内にある必要があります。The storage account must be in the same subscription and region as your cache.

    重要

    エクスポートが機能するページ BLOB は、クラシック ストレージ アカウントと Resource Manager ストレージ アカウントの両方でサポートされていますが、現時点では 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. 詳細については、「Azure ストレージ アカウントの概要」を参照してください。For more information, see Azure storage account overview.

    ストレージ アカウント

  3. 目的の BLOB コンテナーを選び、 [選択] をクリックします。Choose the desired blob container and click Select. 新しいコンテナーを使用するには、まず [コンテナーの追加] をクリックして新しいコンテナーを追加したうえで、一覧からそれを選択します。To use new a container, click Add Container to add it first and then select it from the list.

    Contoso55 の [コンテナー] で、+ 記号の [コンテナー] オプションが強調表示されています。

  4. BLOB 名のプレフィックス を入力し、 [エクスポート] をクリックしてエクスポート処理を開始します。Type a Blob name prefix and click Export to start the export process. BLOB 名のプレフィックスは、このエクスポート操作によって生成されるファイル名のプレフィックスとして使用されます。The blob name prefix is used to prefix the names of files generated by this export operation.

    [エクスポート]

    エクスポート操作の進行状況を監視するには、Azure Portal からの通知を確認するか、監査ログのイベントを確認します。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.

    データのエクスポートの完了

    エクスポート処理中でも、キャッシュは使用可能な状態のままです。Caches remain available for use during the export process.

Import/Export の FAQImport/Export FAQ

このセクションでは、Import/Export 機能についてよく寄せられる質問を掲載しています。This section contains frequently asked questions about the Import/Export feature.

Import/Export はどの価格レベルで使用できますか?What pricing tiers can use Import/Export?

Import/Export は Premium 価格レベルでのみ使用できます。Import/Export is available only in the premium pricing tier.

どの Redis サーバーからでもデータをインポートできるのでしょうか?Can I import data from any Redis server?

はい。インポートできるのは Azure Cache for Redis インスタンスからエクスポートされたデータだけではありません。任意のクラウドや環境 (Linux や Windows のほか、アマゾン ウェブ サービスなどの各種クラウド プロバイダー) で稼働している任意の Redis サーバーから RDB ファイルをインポートできます。Yes, in addition to importing data exported from Azure Cache for Redis 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. これを行うには、RDB ファイルを目的の Redis サーバーから Azure ストレージ アカウント内のページ BLOB またはブロック BLOB にアップロードし、さらに Premium Azure Cache for Redis インスタンスにインポートします。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 Cache for Redis instance. 具体的には、運用環境のキャッシュからデータをエクスポートし、テストまたは移行のためのステージング環境の一部として使用するキャッシュにインポートする場合が考えられます。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.

重要

ページ BLOB を使用する場合、Azure Cache for Redis 以外の Redis サーバーからエクスポートされたデータを正常にインポートするには、ページ BLOB のサイズを 512 バイト境界に合わせる必要があります。To successfully import data exported from Redis servers other than Azure Cache for Redis when using a page blob, the page blob size must be aligned on a 512 byte boundary. 必要なバイト パディングを実行するサンプル コードについては、ページ BLOB をアップロードするためのサンプル コードに関するページを参照してください。For sample code to perform any required byte padding, see Sample page blob upload.

RDB のどのバージョンをインポートできますか?What RDB versions can I import?

Azure Cache for Redis は、RDB バージョン 7 までの RDB のインポートをサポートしています。Azure Cache for Redis supports RDB import up through RDB version 7.

Import/Export 操作中にキャッシュを使うことはできますか?Is my cache available during an Import/Export operation?

  • エクスポート - キャッシュは使用可能な状態のままです。エクスポート操作中もキャッシュの使用を続行できます。Export - Caches remain available and you can continue to use your cache during an export operation.
  • インポート - インポート処理が開始されると、キャッシュは使用できなくなります。インポート処理が終了すると、キャッシュは使用可能になります。Import - Caches become unavailable when an import operation starts, and become available for use when the import operation completes.

Redis クラスターで Import/Export を使うことはできますか?Can I use Import/Export with Redis cluster?

はい。さらに、クラスター化されたキャッシュとクラスター化されていないキャッシュの間でインポート/エクスポートを実行することもできます。Yes, and you can import/export between a clustered cache and a non-clustered cache. Redis クラスターは、データベース 0 のみをサポートするため、0 以外のデータベースのデータはインポートされません。Since Redis cluster only supports database 0, any data in databases other than 0 isn't imported. クラスター化されたキャッシュのデータがインポートされると、クラスターのシャード間でキーが再配分されます。When clustered cache data is imported, the keys are redistributed among the shards of the cluster.

Import/Export がカスタム データベース設定を操作する方法How does Import/Export work with a custom databases setting?

価格レベルによってさまざまなデータベースの制限があるため、キャッシュの作成中に databases の設定にカスタム値を設定する場合、インポート時の考慮事項がいくつかあります。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.

  • エクスポートしたレベルより低い databases の制限の価格レベルにインポートする場合:When importing to a pricing tier with a lower databases limit than the tier from which you exported:
    • すべての価格レベルが 16 の databases の既定の数を使っている場合、データは失われません。If you are using the default number of databases, which is 16 for all pricing tiers, no data is lost.
    • インポートしているレベルの制限範囲に含まれるユーザー設定の数値の databases を使用している場合、データは失われません。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.
    • エクスポートしたデータが新しいレベルの制限を超えるデータベースのデータを含む場合、レベルの高いデータベースのデータはインポートされません。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.

Import/Export と Redis の永続化にはどのような違いがありますか?How is Import/Export different from Redis persistence?

Azure Cache for Redis 永続化では、Redis に保管されたデータを Azure Storage で永続化することができます。Azure Cache for Redis persistence allows you to persist data stored in Redis to Azure Storage. 永続化が構成されている場合、Azure Cache for Redis では、構成可能なバックアップ頻度に基づき Redis バイナリ形式でそのスナップショットがディスクに保持されます。When persistence is configured, Azure Cache for Redis persists a snapshot of the Azure Cache for Redis in a Redis binary format to disk based on a configurable backup frequency. プライマリ キャッシュとレプリカ キャッシュの両方が無効になるような致命的なイベントが発生した場合、最新のスナップショットを使用してキャッシュ データが自動的に復元されます。If a catastrophic event occurs that disables both the primary and replica cache, the cache data is restored automatically using the most recent snapshot. 詳しくは、「Premium Azure Cache for Redis のデータ永続化の構成方法」をご覧ください。For more information, see How to configure data persistence for a Premium Azure Cache for Redis.

Import/Export では、Azure Cache for Redis へのデータの取り込みと Azure Redis Cache からのデータのエクスポートが可能です。Import/ Export allows you to bring data into or export from Azure Cache for Redis. Redis 永続化を使用してバックアップと復元が構成されることはありません。It does not configure backup and restore using Redis persistence.

PowerShell、CLI、またはその他の管理クライアントを使って Import/Export を自動化することはできますか?Can I automate Import/Export using PowerShell, CLI, or other management clients?

はい、PowerShell の方法については、「Azure Cache for Redis をインポートするには」および「Azure Cache for Redis をエクスポートするには」をご覧ください。Yes, for PowerShell instructions see To import an Azure Cache for Redis and To export an Azure Cache for Redis.

Import/Export 操作中にタイムアウト エラーが発生しました。I received a timeout error during my Import/Export operation. これはどういうことですか?What does it mean?

[データのインポート] ブレードまたは [データのエクスポート] ブレードに操作を開始しないまま留まっている時間が 15 分を超えると、次の例のようなエラー メッセージのエラーが発生します。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.

これを解決するには、インポート操作またはエクスポート操作を 15 分以内に開始してください。To resolve this, initiate the import or export operation before 15 minutes has elapsed.

Azure Blob Storage にデータをエクスポートしているときにエラーが発生しました。I got an error when exporting my data to Azure Blob Storage. なぜでしょうか?What happened?

Export は、ページ BLOB として格納されている RDB ファイルでのみ機能します。Export works only with RDB files stored as page blobs. それ以外のタイプの BLOB は、ホット層とクール層の BLOB ストレージ アカウントも含め、現時点ではサポートされていません。Other blob types are not currently supported, including Blob storage accounts with hot and cool tiers. 詳細については、「Azure ストレージ アカウントの概要」を参照してください。For more information, see Azure storage account overview.

次のステップNext steps

Azure Cache for Redis の機能についてLearn more about Azure Cache for Redis features.