Gegevens importeren en exporteren in Azure Cache voor Redis

  • Artikel

Gebruik de import- en exportfunctionaliteit in Azure Cache voor Redis als gegevensbeheerbewerking. U importeert gegevens in uw cache-exemplaar of exporteert gegevens uit een cache-exemplaar met behulp van een rdb-momentopname (Azure Cache voor Redis Database). De momentopnamen worden geïmporteerd of geëxporteerd met behulp van een blob in een Azure Storage-account.

Importeren/exporteren wordt ondersteund in de Premium-, Enterprise- en Enterprise Flash-lagen:

  • Exporteren: u kunt uw Azure Cache voor Redis RDB-momentopnamen exporteren naar een pagina-blob (Premium-laag) of blok-blob (enterprise-lagen).
  • Importeren: u kunt uw Azure Cache voor Redis RDB-momentopnamen importeren uit een pagina-blob of een blok-blob.

U kunt Import/Export gebruiken om te migreren tussen verschillende Azure Cache voor Redis exemplaren of om de cache te vullen met gegevens voordat u deze gebruikt.

Dit artikel bevat een handleiding voor het importeren en exporteren van gegevens met Azure Cache voor Redis en biedt de antwoorden op veelgestelde vragen.

Bereik van beschikbaarheid

Laag Basic, Standard Premium Enterprise, Enterprise Flash
Beschikbaar Nr. Ja Ja

Compatibiliteit

  • Gegevens worden geëxporteerd als een RDB-pagina-blob in de Premium-laag . In de lagen Enterprise en Enterprise Flash worden gegevens geëxporteerd als een .gz blok-blob.
  • Caches met Redis 4.0 ondersteunen RDB versie 8 en lager. Caches met Redis 6.0 ondersteunen RDB versie 9 en lager.
  • Geëxporteerde back-ups uit nieuwere versies van Redis (bijvoorbeeld Redis 6.0) kunnen niet worden geïmporteerd in oudere versies van Redis (bijvoorbeeld Redis 4.0)
  • RDB-bestanden uit caches in de Premium-laag kunnen worden geïmporteerd in Enterprise- en Enterprise Flash-laagcaches.

Importeren

Gebruik import om redis-compatibele RDB-bestanden te gebruiken vanaf elke Redis-server die wordt uitgevoerd in een cloud of omgeving, waaronder Redis die wordt uitgevoerd op Linux, Windows of een cloudprovider zoals Amazon Web Services en anderen. Het importeren van gegevens is een eenvoudige manier om een cache te maken met vooraf ingevulde gegevens. Tijdens het importproces laadt Azure Cache voor Redis de RDB-bestanden uit Azure Storage in het geheugen en voegt u vervolgens de sleutels in de cache in.

Notitie

Voordat u de importbewerking start, moet u ervoor zorgen dat uw RDB-bestand (Redis Database) wordt geüpload naar pagina- of blok-blobs in Azure Storage, in dezelfde regio en hetzelfde abonnement als uw Azure Cache voor Redis exemplaar. Als u beheerde identiteit gebruikt voor verificatie, kan het opslagaccount zich in een ander abonnement bevinden. Zie Aan de slag met Azure Blob Storage voor meer informatie. Als u uw RDB-bestand hebt geëxporteerd met behulp van de functie Azure Cache voor Redis Exporteren, wordt uw RDB-bestand al opgeslagen in een pagina-blob en kunt u het importeren.

Belangrijk

Het importeren van de Redis Enterprise-laag naar de Premium-laag wordt momenteel niet ondersteund.

  1. Als u een of meer geëxporteerde cache-blobs wilt importeren, bladert u naar uw cache in Azure Portal en selecteert u Gegevens importeren in het menu Resource. In het werkvenster ziet u Blob(s) kiezen waar u RDB-bestanden kunt vinden.

    Schermopname met Gegevens importeren geselecteerd in het menu Resource.

  2. Selecteer Blob(s) kiezen en selecteer het opslagaccount dat de gegevens bevat die u wilt importeren.

    Schermopname van een lijst met opslagaccounts.

  3. Selecteer de container die de gegevens bevat die u wilt importeren.

    Schermopname van de lijst met containers uit het eerder gekozen opslagaccount.

  4. Selecteer een of meer blobs die u wilt importeren door het gebied links van de blobnaam te selecteren en selecteer vervolgens.

    Schermopname van een blob uit de container.

  5. Selecteer Importeren om het importproces te starten.

    Belangrijk

    De cache is niet toegankelijk voor cacheclients tijdens het importproces en eventuele bestaande gegevens in de cache worden verwijderd.

    Schermopname van de knop Importeren om de import te starten.

    U kunt de voortgang van de importbewerking controleren door de meldingen uit de Azure-portal te volgen of door de gebeurtenissen in het activiteitenlogboek weer te geven.

    Belangrijk

    Ondersteuning voor activiteitenlogboeken is nog niet beschikbaar in de Enterprise-lagen.

    Schermopname van de voortgang van het importeren in het meldingengebied.

Export

Met exporteren kunt u de gegevens die zijn opgeslagen in Azure Cache voor Redis exporteren naar redis-compatibele RDB-bestanden. U kunt deze functie gebruiken om gegevens van het ene Azure Cache voor Redis exemplaar naar een andere of naar een andere Redis-server te verplaatsen. Tijdens het exportproces wordt een tijdelijk bestand gemaakt op de virtuele machine waarop het Azure Cache voor Redis serverexemplaren worden gehost. Vervolgens wordt het bestand geüpload naar het gekozen opslagaccount. Wanneer de exportbewerking is voltooid met de status geslaagd of mislukt, wordt het tijdelijke bestand verwijderd.

  1. Als u de huidige inhoud van de cache naar opslag wilt exporteren, bladert u naar uw cache in Azure Portal en selecteert u Gegevens exporteren in het menu Resource. U ziet Opslagcontainer kiezen in het werkvenster.

    Schermopname met Gegevens exporteren geselecteerd in het menu Resource

  2. Selecteer Opslagcontainer kiezen en een lijst met beschikbare opslagaccounts weergeven. Selecteer het gewenste opslagaccount. Het opslagaccount moet zich in dezelfde regio bevinden als uw cache. Als u beheerde identiteit gebruikt voor verificatie, kan het opslagaccount zich in een ander abonnement bevinden. Anders moet het opslagaccount zich in hetzelfde abonnement bevinden als uw cache.

    Belangrijk

    • Exporteren werkt met pagina-blobs die worden ondersteund door zowel klassieke als Resource Manager-opslagaccounts.
    • Azure Cache voor Redis biedt geen ondersteuning voor exporteren naar ADLS Gen2-opslagaccounts.
    • Exporteren wordt momenteel niet ondersteund door Blob Storage-accounts.
    • Als het exporteren van uw cachegegevens naar opslagaccounts met firewall mislukt, raadpleegt u Wat als ik een firewall heb ingeschakeld voor mijn opslagaccount?

    Zie Overzicht van Azure-opslagaccount voor meer informatie.

    Schermopname van een lijst met containers in het werkvenster.

  3. Kies de opslagcontainer die u wilt opslaan en selecteer vervolgens. Als u een nieuwe container wilt, selecteert u Container toevoegen om deze eerst toe te voegen en selecteert u deze vervolgens in de lijst.

    Schermopname van een lijst met containers met één gemarkeerd en een selectieknop.

  4. Typ een voorvoegsel voor de blobnaam en selecteer Exporteren om het exportproces te starten. Het voorvoegsel van de blobnaam wordt gebruikt om de namen van bestanden die door deze exportbewerking worden gegenereerd, voor te voegen.

    Schermopname van een voorvoegsel voor de blobnaam en een knop Exporteren.

    U kunt de voortgang van de exportbewerking controleren door de meldingen uit Azure Portal te volgen of door de gebeurtenissen in het auditlogboek weer te geven.

    Schermopname van de voortgang van de export in het meldingengebied.

    Caches blijven beschikbaar voor gebruik tijdens het exportproces.

Veelgestelde vragen over importeren/exporteren

Deze sectie bevat veelgestelde vragen over de functie Importeren/exporteren.

Welke lagen ondersteunen Import/Export?

De import - en exportfuncties zijn alleen beschikbaar in de Premium-, Enterprise- en Enterprise Flash-lagen .

Kan ik gegevens importeren vanaf een Redis-server?

Ja, u kunt gegevens importeren die zijn geëxporteerd uit Azure Cache voor Redis exemplaren. U kunt RDB-bestanden importeren vanaf elke Redis-server die wordt uitgevoerd in elke cloud of omgeving. De omgevingen omvatten Linux-, Windows- of cloudproviders zoals Amazon Web Services. Als u deze gegevens wilt importeren, uploadt u het RDB-bestand van de Redis-server naar een pagina of blok-blob in een Azure Storage-account. Importeer deze vervolgens in uw Premium Azure Cache voor Redis-exemplaar.

U kunt bijvoorbeeld het volgende doen:

  1. Exporteer de gegevens uit uw productiecache.

  2. Importeer deze vervolgens in een cache die wordt gebruikt als onderdeel van een faseringsomgeving voor testen of migratie.

Belangrijk

Als u gegevens wilt importeren die zijn geëxporteerd van andere Redis-servers dan Azure Cache voor Redis wanneer u een pagina-blob gebruikt, moet de grootte van de pagina-blob worden uitgelijnd op een grens van 512 byte. Zie Voorbeeldpagina-blobupload om eventuele vereiste byteopvullingen uit te voeren.

Welke RDB-versies kan ik importeren?

Zie de compatibiliteitssectie voor meer informatie over ondersteunde RDB-versies die worden gebruikt met importeren.

Is mijn cache beschikbaar tijdens een import-/exportbewerking?

  • Exporteren - Caches blijven beschikbaar en u kunt uw cache blijven gebruiken tijdens een exportbewerking.
  • Importeren : caches worden niet beschikbaar wanneer een importbewerking wordt gestart en worden beschikbaar voor gebruik wanneer de importbewerking is voltooid.

Kan ik Import/Export gebruiken met Redis-cluster?

Ja, en u kunt importeren/exporteren tussen een geclusterde cache en een niet-geclusterde cache. Omdat Redis-cluster alleen database 0 ondersteunt, worden gegevens in andere databases dan 0 niet geïmporteerd. Wanneer geclusterde cachegegevens worden geïmporteerd, worden de sleutels opnieuw verdeeld over de shards van het cluster.

Hoe werkt Import/Export met een aangepaste databaseinstelling?

Sommige prijscategorieën hebben verschillende databaselimieten, dus er zijn enkele overwegingen bij het importeren als u een aangepaste waarde voor de instelling hebt geconfigureerd tijdens het maken van de databases cache.

  • Wanneer u importeert naar een prijscategorie met een lagere databases limiet dan de categorie waaruit u hebt geëxporteerd:
    • Als u het standaardaantal databases, dat 16 is voor alle prijscategorieën, gebruikt, gaan er geen gegevens verloren.
    • Als u een aangepast aantal databases gebruikt dat binnen de limieten valt voor de laag waarnaar u importeert, gaan er geen gegevens verloren.
    • Als u gegevens exporteert die gegevens bevatten in een database die de limieten van de nieuwe laag overschrijdt, worden de gegevens uit deze hogere databases niet geïmporteerd.

Hoe verschilt Import/Export van Redis-persistentie?

De Azure Cache voor Redis persistentiefunctie is voornamelijk een functie voor duurzaamheid van gegevens. Omgekeerd is de import-/exportfunctionaliteit ontworpen als een methode om periodieke gegevensback-ups te maken voor herstel naar een bepaald tijdstip.

Wanneer persistentie is geconfigureerd, blijft uw cache een momentopname van de gegevens op schijf behouden op basis van een configureerbare back-upfrequentie. De gegevens worden geschreven met een binaire indeling van Redis. Als er een onherstelbare gebeurtenis optreedt die zowel de primaire als de replicacache uitschakelt, worden de cachegegevens automatisch hersteld met behulp van de meest recente momentopname.

Gegevenspersistentie is ontworpen voor herstel na noodgevallen. Het is niet bedoeld als een herstelmechanisme voor een bepaald tijdstip.

  • In de Premium-laag wordt het bestand voor gegevenspersistentie opgeslagen in Azure Storage, maar het bestand kan niet worden geïmporteerd in een andere cache.
  • Op de Enterprise-lagen wordt het bestand voor gegevenspersistentie opgeslagen op een gekoppelde schijf die niet toegankelijk is voor de gebruiker.

Als u periodieke gegevensback-ups wilt maken voor herstel naar een bepaald tijdstip, raden we u aan de import-/exportfunctionaliteit te gebruiken. Zie Gegevenspersistentie configureren voor Azure Cache voor Redis voor meer informatie.

Kan ik Importeren/exporteren automatiseren met PowerShell-, CLI- of andere beheerclients?

Ja, zie de volgende instructies voor de Premium-laag :

Voor de Enterprise- en Enterprise Flash-lagen:

Er is een time-outfout opgetreden tijdens mijn import-/exportbewerking. Wat betekent dit?

Als u langer dan 15 minuten gegevens importeren of exporteren voordat u de bewerking start, ontvangt u een foutbericht met een foutbericht dat lijkt op het volgende voorbeeld:

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.

U kunt deze fout oplossen door de import- of exportbewerking te starten voordat 15 minuten zijn verstreken.

Er is een fout opgetreden bij het exporteren van mijn gegevens naar Azure Blob Storage. Wat is er gebeurd?

Exporteren werkt alleen met RDB-bestanden die zijn opgeslagen als pagina-blobs. Andere blobtypen worden momenteel niet ondersteund, waaronder Blob Storage-accounts met dynamische en statische lagen. Zie Overzicht van Azure-opslagaccount voor meer informatie. Als u een toegangssleutel gebruikt voor het verifiëren van een opslagaccount, leidt het gebruik van firewall-uitzonderingen voor het opslagaccount ertoe dat het import-/exportproces mislukt.

Wat gebeurt er als ik een firewall heb ingeschakeld voor mijn opslagaccount?

Als u een exemplaar van de Premium-laag gebruikt, moet u in de instellingen van uw opslagaccount de optie Azure-services op de lijst met vertrouwde services toestaan om toegang te krijgen tot dit opslagaccount. Gebruik vervolgens een beheerde identiteit (door het systeem of de gebruiker toegewezen) en richt de RBAC-rol Inzender voor opslagblobgegevens in voor die object-id.

Zie beheerde identiteit voor opslagaccounts - Azure Cache voor Redis voor meer informatie

Enterprise- en Enterprise Flash-exemplaren bieden geen ondersteuning voor het importeren van of exporteren van gegevens naar opslagaccounts die gebruikmaken van firewalls of privé-eindpunten. Het opslagaccount moet openbare netwerktoegang hebben.

Kan ik gegevens importeren of exporteren uit een opslagaccount in een ander abonnement dan mijn cache?

In de Premium-laag kunt u gegevens importeren en exporteren uit een opslagaccount in een ander abonnement dan uw cache, maar u moet beheerde identiteit gebruiken als verificatiemethode. U moet het gekozen abonnement selecteren dat het opslagaccount bevat bij het configureren van de import of export.

Welke machtigingen moeten worden verleend aan het SAS-token (Shared Access Signature) van het opslagaccount om export toe te staan?

Als u wilt exporteren naar een Azure-opslagaccount, moet het SAS-token (Shared Access Signature) de volgende machtigingen hebben:

  • read
  • add
  • create
  • write
  • delete
  • tag
  • move

Volgende stappen

Meer informatie over Azure Cache voor Redis functies.