Zelfstudie: Offline migreren van Amazon RDS for PostgreSQL naar Azure Database for PostgreSQL met de migratieservice

In dit artikel wordt beschreven hoe u uw PostgreSQL-database offline migreert van Amazon RDS for PostgreSQL naar Azure Database for PostgreSQL.

De migratieservice in Azure Database for PostgreSQL is een volledig beheerde service die is geïntegreerd in Azure Portal en Azure CLI. Het is ontworpen om uw migratietraject naar de Azure Database for PostgreSQL-server te vereenvoudigen.

• Vereisten
• De migratie uitvoeren
• De migratie bewaken
• De migratie controleren wanneer deze is voltooid

Vereisten

Voor het voltooien van de migratie hebt u de volgende vereisten nodig:

Voordat u de migratie met de Azure Database for PostgreSQL-migratieservice start, is het belangrijk om aan de volgende vereisten te voldoen, speciaal ontworpen voor offlinemigratiescenario's.

• De bronversie controleren
• Doelinstellingen configureren
• Netwerkconfiguratie configureren
• Extensies inschakelen
• Serverparameters controleren
• Gebruikers en rollen controleren
• Hoge beschikbaarheid (betrouwbaarheid) en leesreplica's in het doel uitschakelen

De bronversie controleren

De bronversie van de PostgreSQL-server moet 9.5 of hoger zijn.

Als de postgreSQL-bronversie kleiner is dan 9.5, moet u deze upgraden naar 9.5 of hoger voordat u de migratie start.

Doelinstellingen configureren

Voordat u met de migratie begint, moet u een Azure Database for PostgreSQL instellen in Azure.

De SKU die voor Azure Database for PostgreSQL is gekozen, moet overeenkomen met de specificaties van de brondatabase om compatibiliteit en adequate prestaties te garanderen.

Netwerkconfiguratie configureren

Het instellen van het netwerk is essentieel voor de juiste werking van de migratieservice. Zorg ervoor dat de PostgreSQL-bronserver kan communiceren met de Azure Database for PostgreSQL-doelserver. De volgende netwerkconfiguraties zijn essentieel voor een geslaagde migratie.

Ga naar de netwerkhandleiding voor migratieservice voor informatie over de netwerkinstallatie.

Extensies inschakelen

Als u wilt zorgen voor een geslaagde migratie met behulp van de migratieservice in Azure Database for PostgreSQL, moet u mogelijk extensies verifiëren voor uw postgreSQL-bronexemplaren. Extensies bieden functionaliteit en functies die mogelijk vereist zijn voor uw toepassing. Zorg ervoor dat u de extensies op het PostgreSQL-bronexemplaren controleert voordat u het migratieproces start.

Schakel in het doelexemplaren van Azure Database for PostgreSQL - Flexible Server ondersteunde extensies in die zijn geïdentificeerd in het PostgreSQL-bronexemplaren.

Zie Extensies in Azure Database for PostgreSQL voor meer informatie.

Notitie

Opnieuw opstarten is vereist wanneer u wijzigingen aanbrengt in de shared_preload_libraries parameter.

Serverparameters controleren

Deze parameters worden niet automatisch gemigreerd naar de doelomgeving en moeten handmatig worden geconfigureerd.

• Koppel de serverparameterwaarden van de PostgreSQL-brondatabase aan de Azure Database for PostgreSQL door toegang te krijgen tot de sectie Serverparameters in Azure Portal en de waarden dienovereenkomstig handmatig bij te werken.

• Sla de parameterwijzigingen op en start de Azure Database for PostgreSQL opnieuw om zo nodig de nieuwe configuratie toe te passen.

Gebruikers en rollen controleren

Wanneer u migreert naar Azure Database for PostgreSQL, is het essentieel om de migratie van gebruikers en rollen afzonderlijk aan te pakken, omdat hiervoor handmatige tussenkomst is vereist:

• Handmatige migratie van gebruikers en rollen: gebruikers en hun bijbehorende rollen moeten handmatig worden gemigreerd naar azure Database for PostgreSQL. Om dit proces te vergemakkelijken, kunt u het pg_dumpall hulpprogramma met de --globals-only vlag gebruiken om globale objecten, zoals rollen en gebruikersaccounts, te exporteren. Voer de volgende opdracht uit, waarbij u <<username>> de werkelijke gebruikersnaam en <<filename>> de gewenste naam van het uitvoerbestand vervangt:

  pg_dumpall --globals-only -U <<username>> -f <<filename>>.sql
  

• Beperking voor Superuser-rollen: Azure Database for PostgreSQL biedt geen ondersteuning voor supergebruikersrollen. Daarom moeten gebruikers met supergebruikersbevoegdheden deze bevoegdheden vóór de migratie verwijderen. Zorg ervoor dat u de machtigingen en rollen dienovereenkomstig aanpast.

Door deze stappen te volgen, kunt u ervoor zorgen dat gebruikersaccounts en -rollen correct worden gemigreerd naar Azure Database for PostgreSQL zonder problemen met betrekking tot supergebruikersbeperkingen.

Hoge beschikbaarheid (betrouwbaarheid) en leesreplica's in het doel uitschakelen

• Het uitschakelen van hoge beschikbaarheid (betrouwbaarheid) en leesreplica's in de doelomgeving is essentieel. Deze functies moeten alleen worden ingeschakeld nadat de migratie is voltooid.

• Door deze richtlijnen te volgen, kunt u een soepel migratieproces garanderen zonder de toegevoegde variabelen die zijn geïntroduceerd door HA en Leesreplica's. Zodra de migratie is voltooid en de database stabiel is, kunt u doorgaan met het inschakelen van deze functies om de beschikbaarheid en schaalbaarheid van uw databaseomgeving in Azure te verbeteren.

De migratie uitvoeren

U kunt migreren met behulp van Azure Portal of de Azure CLI.

Portal

Azure Portal biedt een eenvoudige en intuïtieve, wizardgebaseerde ervaring waarmee u door de migratie wordt geleid. Als u de stappen in deze zelfstudie volgt, kunt u uw database naadloos overdragen naar Azure Database for PostgreSQL - Flexible Server en profiteren van de krachtige functies en schaalbaarheid.

Als u wilt migreren met Azure Portal, configureert u eerst de migratietaak, maakt u verbinding met de bron en het doel en voert u vervolgens de migratie uit.

De migratietaak configureren

De migratieservice wordt geleverd met een eenvoudige, wizardgebaseerde ervaring in Azure Portal.

1. Open uw webbrowser en ga naar de portal. Voer uw referenties in om u aan te melden. De standaardweergave is uw service-dashboard.

2. Ga naar uw Flexibele PostgreSQL-server in Azure Database for the PostgreSQL.

3. Schuif op het tabblad Overzicht van de flexibele server in het linkermenu omlaag naar Migratie en selecteer deze.

   

4. Selecteer de knop Maken om te migreren van Amazon RDS voor PostgreSQL naar een flexibele server.

   Notitie

   De eerste keer dat u de migratieservice gebruikt, wordt er een leeg raster weergegeven met een prompt om uw eerste migratie te starten.

   Als migraties naar uw flexibele serverdoel al zijn gemaakt, bevat het raster nu informatie over geprobeerde migraties.

5. Selecteer de knop Maken om een reeks tabbladen op basis van een wizard te doorlopen om een migratie uit te voeren.

   

Instellingen

De gebruiker moet meerdere details opgeven met betrekking tot de migratie, zoals de migratienaam, het type bronserver, de optie en de modus.

• De migratienaam is de unieke id voor elke migratie naar dit flexibele serverdoel. Dit veld accepteert alleen alfanumerieke tekens en accepteert geen speciale tekens, behalve een afbreekstreepje (-). De naam kan niet beginnen met een afbreekstreepje en moet uniek zijn voor een doelserver. Er kunnen geen twee migraties naar hetzelfde flexibele serverdoel dezelfde naam hebben.

• Bronservertype : afhankelijk van uw PostgreSQL-bron, kunt u Amazon RDS voor PostgreSQL selecteren.

• Migratieoptie : hiermee kunt u validaties uitvoeren voordat u een migratie activeert. U kunt een van de volgende opties kiezen:

  • Valideren : controleert de gereedheid van uw server en database voor migratie naar het doel.
  • Migreren : slaat validaties over en start migraties.
  • Valideren en migreren : voert validatie uit voordat een migratie wordt geactiveerd. Als er geen validatiefouten zijn, wordt de migratie geactiveerd.

Het kiezen van de optie Valideren of Valideren en migreren is altijd een goede gewoonte voor het uitvoeren van premigratievalidaties voordat u de migratie uitvoert.

Ga naar premigratie voor meer informatie over de premigratievalidatie.

• Met de migratiemodus kunt u de modus voor de migratie kiezen. Offline is de standaardoptie.

Selecteer de knop Volgende: Verbinding maken met bron .

Runtime-server selecteren

De migratieruntimeserver is een gespecialiseerde functie binnen de migratieservice, ontworpen om te fungeren als een tussenliggende server tijdens de migratie. Het is een afzonderlijk exemplaar van Azure Database for PostgreSQL - Flexible Server dat niet de doelserver is, maar wordt gebruikt om de migratie van databases vanuit een bronomgeving te vergemakkelijken die alleen toegankelijk is via een particulier netwerk.

Ga naar de Migration Runtime-server voor meer informatie over de Runtime-server.

Verbinding maken met bron

Op het tabblad Verbinding maken met bron wordt u gevraagd om details te geven met betrekking tot de bron die is geselecteerd op het tabblad Setup. Dit is de bron van de databases.

• Servernaam : geef de hostnaam of het IP-adres van het postgreSQL-bronexemplaren op
• Poort - Poortnummer van de bronserver
• Aanmeldingsnaam van de serverbeheerder - Gebruikersnaam van de postgreSQL-bronserver
• Wachtwoord - Wachtwoord van de PostgreSQL-bronserver
• SSL-modus : ondersteunde waarden hebben de voorkeur en zijn vereist. Wanneer de SSL op de PostgreSQL-bronserver IS UITGESCHAKELD, gebruikt u de SSLMODE=voorkeur. Als de SSL op de bronserver ON is, gebruikt u SSLMODE=require. SSL-waarden kunnen worden bepaald in het bestand postgresql.conf.
• Verbinding testen: voert de connectiviteitstest tussen het doel en de bron uit. Zodra de verbinding is geslaagd, kunnen gebruikers doorgaan met de volgende stap; ze moeten de netwerkproblemen tussen het doel en de bron identificeren en de gebruikersnaam/het wachtwoord voor de bron verifiëren. Het tot stand brengen van een testverbinding duurt enkele minuten.

Selecteer na de geslaagde testverbinding de knop Volgende: Migratiedoel selecteren .

Migratiedoel selecteren

Op het tabblad Migratiedoel selecteren worden metagegevens weergegeven voor het flexibele serverdoel, zoals abonnementsnaam, resourcegroep, servernaam, locatie en PostgreSQL-versie.

• Gebruikersnaam van beheerder - Gebruikersnaam van beheerder van de PostgreSQL-doelserver
• Wachtwoord - Wachtwoord van de PostgreSQL-doelserver
• Aangepaste FQDN/IP (optioneel): het aangepaste FQDN-/IP-veld is optioneel en kan worden gebruikt wanneer het doel zich achter een aangepaste DNS-server bevindt of aangepaste DNS-naamruimten heeft, waardoor het alleen toegankelijk is via specifieke FQDN's of IP-adressen. Dit kan bijvoorbeeld vermeldingen zijn zoalsflexibleserver.example.com, of een PostgreSQL-FQDN, zoals flexibleserver.postgres.database.azure.com, als de aangepaste DNS-server de DNS-zone postgres.database.azure.com bevat of query's doorstuurt naar 168.63.129.16, waar de FQDN wordt omgezet in de openbare of privé-DNS-zone van 198.1.0.2Azure.
• Verbinding testen: voert de connectiviteitstest tussen het doel en de bron uit. Zodra de verbinding is geslaagd, kunnen gebruikers doorgaan met de volgende stap. Anders moeten we de netwerkproblemen tussen het doel en de bron identificeren en de gebruikersnaam/het wachtwoord van het doel verifiëren. Testverbinding duurt enkele minuten om een verbinding tot stand te brengen tussen het doel en de bron

Selecteer na de geslaagde testverbinding de volgende: Database(s) selecteren voor migratie

Database selecteren voor migratie

Op het tabblad Database selecteren voor migratie kunt u een lijst kiezen met gebruikersdatabases die u wilt migreren vanaf de PostgreSQL-bronserver.
Nadat u de databases hebt geselecteerd, selecteert u de volgende: samenvatting

Samenvatting

Het tabblad Samenvatting bevat een overzicht van alle bron- en doeldetails voor het maken van de validatie of migratie. Controleer de details en selecteer de knop Validatie en migratie starten.

De migratie bewaken

Nadat u de knop Validatie en migratie starten hebt geselecteerd, verschijnt er een melding over een paar seconden om te zeggen dat de validatie of het maken van de migratie is geslaagd. U wordt omgeleid naar het exemplaar van de migratiepagina voor flexibele servers. De vermelding heeft de status InProgress en de substate PerformingPreRequisiteSteps . De werkstroom duurt 2-3 minuten om de migratie-infrastructuur in te stellen en netwerkverbindingen te controleren.

Het raster met de migraties bevat de volgende kolommen: Naam, Status, Migratiemodus, Migratietype, Bronserver, Bronservertype, Databases, **Duur en Begintijd. De vermeldingen worden weergegeven in aflopende volgorde van de begintijd, met de meest recente vermelding bovenaan. U kunt de knop Vernieuwen gebruiken om de status van de validatie of migratieuitvoering te vernieuwen.

Migratiedetails

Selecteer de migratienaam in het raster om de bijbehorende details weer te geven.

Op het tabblad Setup hebben we de migratieoptie gevalideerd en migreren geselecteerd. In dit scenario worden validaties eerst uitgevoerd voordat de migratie wordt gestart. Nadat het substraat PerformingPreRequisiteSteps is voltooid, wordt de werkstroom verplaatst naar het substraat van Validatie in uitvoering.

• Als de validatie fouten bevat, wordt de migratie verplaatst naar de status Mislukt .

• Als de validatie zonder fouten is voltooid, wordt de migratie gestart en wordt de werkstroom verplaatst naar de substatus van Gegevens migreren.

Validatiedetails zijn beschikbaar op exemplaar- en databaseniveau.

• Validatie op exemplaarniveau

  • Bevat validatie met betrekking tot de connectiviteitscontrole, de bronversie, dat wil gezegd PostgreSQL-versie >= 9.5, serverparametercontrole, als de extensies zijn ingeschakeld in de serverparameters van de Flexibele server van Azure Database for PostgreSQL.

• Validatie op databaseniveau

  • Het bevat validatie van de afzonderlijke databases die betrekking hebben op extensies en sorteringen in Azure Database for PostgreSQL, een flexibele server.

U kunt de validatie en de migratiestatus bekijken op de pagina met migratiedetails.

Enkele mogelijke migratiestatussen:

Migratiestatussen

Toestand	Beschrijving
Wordt uitgevoerd	De installatie van de migratie-infrastructuur wordt uitgevoerd of de werkelijke gegevensmigratie wordt uitgevoerd.
Geannuleerd	De migratie wordt geannuleerd of verwijderd.
Mislukt	De migratie is mislukt.
Validatie is mislukt	De validatie is mislukt.
Geslaagd	De migratie is voltooid en is voltooid.
WaitingForUserAction	Alleen van toepassing op onlinemigratie. Wacht totdat de actie van de gebruiker cutover uitvoert.

Migratiesubstates

Substate	Beschrijving
PerformingPreRequisiteSteps	De installatie van de infrastructuur wordt uitgevoerd voor gegevensmigratie.
Validatie wordt uitgevoerd	Validatie wordt uitgevoerd.
Gegevens migreren	Gegevensmigratie wordt uitgevoerd.
Voltooien van Migratie	Migratie bevindt zich in de laatste fasen van voltooiing.
Voltooid	De migratie is voltooid.
Mislukt	Migratie is mislukt.

Validatiesubstates

Substate	Beschrijving
Mislukt	Validatie is mislukt.
Geslaagd	Validatie is geslaagd.
Waarschuwing	Validatie is in waarschuwing.

De migratie annuleren

U kunt lopende validaties of migraties annuleren. De werkstroom moet de status InProgress hebben om te worden geannuleerd. U kunt een validatie of migratie die de status Geslaagd of Mislukt heeft niet annuleren.

• Als u een migratie annuleert, wordt verdere migratieactiviteit op uw doelserver gestopt en wordt de status Geannuleerd . Met de actie Annuleren worden alle wijzigingen die door de migratieservice op uw doelserver zijn aangebracht, teruggedraaid.

CLI

In dit artikel wordt beschreven hoe u de Azure CLI gebruikt om uw PostgreSQL-database te migreren van Amazon RDS for PostgreSQL naar Azure Database for PostgreSQL. De Azure CLI biedt een krachtige en flexibele opdrachtregelinterface waarmee u verschillende taken kunt uitvoeren, waaronder databasemigratie. Door de stappen in dit artikel te volgen, kunt u uw database naadloos overdragen naar Azure en profiteren van de krachtige functies en schaalbaarheid.

Voor meer informatie over Azure CLI met de migratieservice gaat u naar Azure CLI instellen voor de migratieservice.

Nadat de CLI is geïnstalleerd, opent u de opdrachtprompt en meldt u zich aan bij uw Azure-account met behulp van de onderstaande opdracht.

az login

De migratietaak configureren

Als u de migratie wilt starten, moet u een JSON-bestand maken met de migratiedetails. Het JSON-bestand bevat de volgende informatie:

• Bewerk de onderstaande tijdelijke aanduidingen << >> in de JSON-regels en sla deze op de lokale computer op als <<filename>>.json waar de CLI wordt aangeroepen. In deze zelfstudie hebben we het bestand opgeslagen in C:\migration-CLI\migration_body.json

{
"properties": {
"SourceDBServerResourceId": "<<source hostname or IP address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<Source Password>>",
                "TargetServerPassword": "<<Target Password>>"
            },
			"targetServerUserName": "<<Target username>>"
        },
        "DBsToMigrate": "<<comma separated list of databases in a array like - ["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "AWS_RDS",
        "sslMode": "Require"
    }
}

• Voer de volgende opdracht uit om te controleren of er migraties worden uitgevoerd. De migratienaam is uniek voor de migraties binnen het flexibele serverdoel van Azure Database for PostgreSQL.

  az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
  

• In de bovenstaande stappen zijn er geen migraties uitgevoerd, zodat we beginnen met de nieuwe migratie door de volgende opdracht uit te voeren

  az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode offline --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
  

• Voer de volgende opdracht uit om de migratiestatus in de vorige stap te starten. U kunt de status van de migratie controleren door de migratienaam op te geven

  az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

• De status van de migratievoortgang wordt weergegeven in de Azure CLI.

• U kunt ook de status van de flexibele Azure Database for PostgreSQL-server bekijken in Azure Portal.

• U kunt lopende migratiepogingen annuleren met behulp van de cancel opdracht. Met deze opdracht wordt de specifieke migratiepoging gestopt en worden alle wijzigingen op de doelserver teruggedraaid. Hier volgt de CLI-opdracht om een migratie te verwijderen:

  az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

De migratie controleren wanneer deze is voltooid

Nadat u de databases hebt voltooid, moet u de gegevens tussen de bron en het doel handmatig valideren en controleren of alle objecten in de doeldatabase zijn gemaakt.

Na de migratie kunt u de volgende taken uitvoeren:

• Controleer de gegevens op uw flexibele server en zorg ervoor dat dit een exacte kopie is van het bronexemplaar.
• Schakel na verificatie de optie voor hoge beschikbaarheid in op uw flexibele server indien nodig.
• Wijzig de SKU van de flexibele server zodat deze overeenkomt met de toepassingsbehoeften. Voor deze wijziging moet de databaseserver opnieuw worden opgestart.
• Als u serverparameters wijzigt van de standaardwaarden in het bronexemplaar, kopieert u die serverparameterwaarden in de flexibele server.
• Kopieer andere serverinstellingen, zoals tags, waarschuwingen en firewallregels (indien van toepassing), van het bronexemplaar naar de flexibele server.
• Breng wijzigingen aan in uw toepassing om de verbindingsreeks s te laten verwijzen naar een flexibele server.
• Bewaak de prestaties van de database nauwkeurig om te zien of er prestatieafstemming nodig is.

Gerelateerde inhoud

• Online migreren vanuit Amazon RDS for PostgreSQL
• Migratieservice
• Migreren van on-premises en Azure-VM's
• Bekende problemen en beperkingen