Zelfstudie: Migreren van Azure Database for PostgreSQL - Enkele server naar Azure Database for PostgreSQL - Flexible Server met behulp van de migratieservice

VAN TOEPASSING OP: Azure Database for PostgreSQL - Flexibele server

Met behulp van Azure Portal kunt u een exemplaar van Azure Database for PostgreSQL – Enkele server migreren naar Azure Database for PostgreSQL – Flexible Server. In deze zelfstudie voeren we een migratie uit van een voorbeelddatabase van een Azure Database for PostgreSQL enkele server naar een flexibele PostgreSQL-server met behulp van Azure Portal.

• Uw Flexibele Azure Database for PostgreSQL-server configureren
• De migratietaak configureren
• De migratie bewaken
• De migratie annuleren
• Na de migratie

Portal

U kunt migreren met behulp van Azure Portal.

Offline

Vereisten (offline)

Voordat u met de migratieservice in Azure Database for PostgreSQL begint, moet u voldoen aan de volgende vereisten, die van toepassing zijn op offlinemigratiescenario's.

De bronversie controleren

De bronversie van PostgreSQL moet zijn >= 9.5. Als de postgreSQL-bronversie kleiner is dan 9.5, voert u vóór de migratie een upgrade uit van de PostgreSQL-bronversie naar 9.5 of hoger.

Doelinstallatie

• Azure Database for PostgreSQL moet vóór de migratie worden ingesteld 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.

• Raadpleeg de volgende koppeling voor gedetailleerde instructies voor het maken van een nieuwe Azure Database for PostgreSQL: Quickstart: Server maken.

Netwerk instellen

De juiste netwerkconfiguratie is essentieel voor een geslaagde verbinding tussen de bron en het doel tijdens de migratie. Hier volgt een handleiding voor het tot stand brengen van de netwerkverbinding voor verschillende scenario's:

Netwerkvereisten voor migratie:

• ExpressRoute/IPsec VPN/VPN-tunneling: bij het verbinden van uw on-premises/AWS-bron met Azure moet u mogelijk een ExpressRoute-, IPsec-VPN- of VPN-tunneling instellen om beveiligde gegevensoverdracht te vergemakkelijken.

• VNET-peering: Peering van virtuele netwerken tot stand brengen tussen de twee afzonderlijke VNets om directe netwerkconnectiviteit mogelijk te maken, een vereiste voor migratie tussen de Virtuele Azure-machine en de Azure Database for PostgreSQL.

Verbinding maken iviteitsscenario's:

De volgende tabel kan helpen bij het instellen van het netwerk tussen de bron en het doel.

Source	Target	Verbinding maken iviteitstips
Openbaar	Openbaar	Er is geen andere actie vereist als de bron is opgenomen in de firewallregels van het doel.
Privé	Openbaar	Deze configuratie wordt niet ondersteund; gebruik pg_dump/pg_restore voor gegevensoverdracht.
Openbaar	Persoonlijk	Er is geen andere actie vereist als de bron is opgenomen in de firewallregels van het doel.
Privé	Privé	Stel een ExpressRoute-, IPsec-VPN-, VPN-tunneling of peering van virtuele netwerken tussen de bron en het doel in.
Privé	Privé-eindpunt	Deze configuratie wordt niet ondersteund; neem contact op met Microsoft Ondersteuning.

Aanvullende aandachtspunten voor netwerken:

• pg_hba.conf-configuratie: om connectiviteit tussen de bron- en doelexemplaren van PostgreSQL te vergemakkelijken, is het essentieel om het bestand pg_hba.conf te verifiëren en te wijzigen. Dit bestand bevat clientverificatie en moet zo worden geconfigureerd dat de doelpostgreSQL verbinding kan maken met de bron. Voor wijzigingen in het bestand pg_hba.conf moet doorgaans opnieuw worden opgestart van het PostgreSQL-bronexemplaren.

Notitie

Het bestand pg_hba.conf bevindt zich in de gegevensmap van de PostgreSQL-installatie. Dit bestand moet worden gecontroleerd en geconfigureerd als de brondatabase een on-premises PostgreSQL-server of een PostgreSQL-server is die wordt gehost op een Azure-VM. Voor PostgreSQL-exemplaren op AWS RDS of vergelijkbare beheerde services is het bestand pg_hba.conf niet rechtstreeks toegankelijk of van toepassing. In plaats daarvan wordt de toegang beheerd via de geleverde beveiligings- en netwerktoegangsconfiguraties van de service.

Ga naar de netwerkhandleiding voor migratieservice in Azure Database for PostgreSQL - Flexible Server voor meer informatie over het instellen van netwerken.

Uitbreidingen

Extensies zijn extra functies die kunnen worden toegevoegd aan PostgreSQL om de functionaliteit ervan te verbeteren. Extensies worden ondersteund in Azure Database for PostgreSQL, maar moeten handmatig worden ingeschakeld. Volg deze stappen om extensies in te schakelen:

• Gebruik de opdracht Selecteren in de bron om alle extensies weer te geven die worden gebruikt - select extname,extversion from pg_extension;

• Zoek naar de serverparameter azure.extensions op de pagina Serverparameter op uw Azure Database for PostgreSQL. Schakel de extensies in de bron in PostgreSQL in.

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

  

• Controleer of de lijst een van de volgende extensies bevat:

  • PG_CRON
  • PG_HINT_PLAN
  • PG_PARTMAN_BGW
  • PG_PREWARM
  • PG_STAT_STATEMENTS
  • PG_AUDIT
  • PGLOGICAL
  • WAL2JSON

Zo ja, zoekt u op de pagina met serverparameters naar de parameter shared_preload_libraries. Deze parameter geeft de set extensiebibliotheken aan die vooraf zijn geladen bij het opnieuw opstarten van de server.

Serverparameters

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.

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.

Uw Flexibele Azure Database for PostgreSQL-server configureren

• Maak de flexibele doelserver. Raadpleeg de quickstart Een flexibele Azure Database for PostgreSQL-server maken met behulp van de portal voor begeleide stappen.

• Allowlist-extensies waarvan de bibliotheken moeten worden geladen bij het starten van de server. Het is essentieel dat de extensie op de acceptatielijst staat voordat u een migratie start.

• Controleer of de gegevensdistributie tussen de tabellen van een database scheef is, waarbij de meeste gegevens in één (of weinig) tabellen aanwezig zijn. Als deze scheef is, kan de migratiesnelheid langzamer zijn dan verwacht. In dit geval kan de migratiesnelheid worden verhoogd door de grote tabel parallel te migreren.

De migratietaak configureren

De migratieservice wordt geleverd met een eenvoudige, wizardgebaseerde ervaring in Azure Portal. Ga als volgt te werk:

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 Azure Database for PostgreSQL Flexible Server-doel.

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 een migratie van één server naar een flexibele server te starten. Als dit de eerste keer is dat u de migratieservice gebruikt, wordt er een leeg raster weergegeven met een prompt om uw eerste migratie te starten.

   

   Als u al migraties naar uw flexibele serverdoel hebt gemaakt, bevat het raster informatie over migraties die zijn geprobeerd om dit doel te bereiken vanaf de enkele server.

5. Selecteer de knop Migreren van één server . U doorloopt een reeks tabbladen op basis van een wizard om een migratie naar dit flexibele serverdoel te maken vanaf een bronserver met één server.

U kunt het migratieproces ook starten vanaf de Azure Database for PostgreSQL Enkele server.

1. Open uw webbrowser en ga naar de portal. Als u zich wilt aanmelden, moet u uw referenties invoeren. De standaardweergave is uw service-dashboard.

2. Wanneer u de enkele server selecteert, kunt u een banner met betrekking tot migratie bekijken op het tabblad Overzicht. Selecteer Nu migreren om aan de slag te gaan.

   

3. U gaat naar een pagina met twee opties. Als u al een flexibele server hebt gemaakt en deze wilt gebruiken als doel, kiest u Bestaande selecteren en selecteert u de bijbehorende details van het abonnement, de resourcegroep en de servernaam. Zodra de selecties zijn gemaakt, selecteert u de wizard Naar migratie gaan en gaat u verder met de instructies in de sectie Setup van deze pagina.

   

4. Als u een nieuwe flexibele server wilt maken, selecteert u Nieuwe maken en selecteert u Ga naar de wizard Maken. Met deze actie wordt u door het proces voor het maken van flexibele servers geleid en wordt de flexibele server geïmplementeerd.

   

Nadat u de flexibele server hebt geïmplementeerd, volgt u de stappen 3 tot en met 5 onder De migratietaak configureren.

Tabblad Setup

Het eerste tabblad is Setup. Als u dit hebt gemist, moet u de toegestane extensies toestaan, zoals wordt weergegeven in Het is essentieel om deze extensies toe te staan voordat u een migratie start.

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.

Het bronservertype geeft de bron aan. In dit geval is het Azure Database for PostgreSQL Enkele server

Met migratieoptie 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. Migratie wordt alleen geactiveerd als er geen validatiefouten zijn.

Het is altijd een goed idee om de optie Valideren of Valideren en migreren te kiezen om premigratievalidaties uit te voeren voordat u de migratie uitvoert.

Als de preview-versie van de onlinemigratie is geselecteerd, moet logische replicatie zijn ingeschakeld op de bronserver met één server. Als deze niet is ingeschakeld, schakelt de migratieservice automatisch logische replicatie in op de bronserver met één server. Replicatie kan ook handmatig worden ingesteld op het tabblad Replicatie in het deelvenster Eén server door het ondersteuningsniveau voor Azure-replicatie in te stellen op Logisch. Bij beide benaderingen wordt de bronserver met één server opnieuw opgestart.

Selecteer de knop Volgende: Verbinding maken naar bron.

Tabblad Bron

Op het tabblad Bron wordt u gevraagd om details te geven met betrekking tot de enkele server. Dit is de bron van de databases.

Nadat u het abonnement en de resourcegroep hebt geselecteerd, wordt in de vervolgkeuzelijst voor servernamen enkele servers weergegeven onder die resourcegroep in verschillende regio's. Selecteer de bron waaruit u databases wilt migreren. U kunt databases migreren van één server naar een flexibele doelserver in dezelfde regio. Migraties tussen regio's zijn alleen ingeschakeld voor India-, China- en UAE-servers.

Nadat u de bron voor één server hebt gekozen, worden de aanmeldingsnaamvakken Location, PostgreSQL en Server admin automatisch ingevuld. De aanmeldingsnaam van de serverbeheerder is de gebruikersnaam van de beheerder die wordt gebruikt om de enkele server te maken. Voer in het vak Wachtwoord het wachtwoord in voor die gebruiker met beheerdersrechten. De migratieservice migreert individuele serverdatabases als de beheerder.

Nadat u alle velden hebt ingevuld, selecteert u de Verbinding maken naar de bronkoppeling. Hiermee wordt gecontroleerd of de ingevoerde bronservergegevens juist zijn en of de bronserver bereikbaar is.

Selecteer de knop Volgende: Selecteer de knop Migratiedoel om door te gaan.

Doeltabblad

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

Voor de aanmeldingsnaam van de serverbeheerder geeft het tabblad de gebruikersnaam van de beheerder weer die wordt gebruikt tijdens het maken van het flexibele serverdoel. Voer het bijbehorende wachtwoord in voor de gebruiker met beheerdersrechten. Nadat u het wachtwoord hebt ingevuld, selecteert u de Verbinding maken om de doelkoppeling te koppelen. Hiermee wordt gecontroleerd of de opgegeven doelservergegevens juist zijn en de doelserver bereikbaar is.

Selecteer de knop Volgende om de databases te selecteren die u wilt migreren.

Selecteer Databases voor het migratietabblad

Op dit tabblad ziet u een lijst met gebruikersdatabases in de enkele server. U kunt maximaal acht databases selecteren en migreren in één migratiepoging. Als er meer dan acht gebruikersdatabases zijn, wordt het migratieproces herhaald tussen de bron- en doelservers voor de volgende set databases. Standaard worden geselecteerde databases met dezelfde naam op het doel overschreven.

Selecteer de knop Volgende om de details te bekijken.

Samenvatting

Het tabblad Samenvatting bevat een overzicht van alle details voor het maken van de validatie of migratie. Controleer de details en selecteer op de startknop.

De migratieportal bewaken

Nadat u de startknop hebt geselecteerd, wordt er binnen een paar seconden een melding weergegeven om te zeggen dat de validatie of het maken van de migratie is geslaagd. U wordt automatisch omgeleid naar de pagina Migratie van Flexibele server. Dit heeft een nieuwe vermelding voor de onlangs gemaakte validatie of migratie.

Het raster met de migraties bevat deze kolommen: Naam, Status, Migratietype, Migratiemodus, Bronserver, Bronservertype, Databases, Begintijd en Duur. 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 migratie te vernieuwen. U kunt ook de migratienaam in het raster selecteren om de bijbehorende details te bekijken.

Wanneer de validatie of migratie is gemaakt, wordt deze verplaatst naar de status InProgress en de substatus PerformingPreRequisiteSteps . De werkstroom duurt 2-3 minuten om de migratie-infrastructuur en netwerkverbindingen in te stellen.

Laten we eens kijken hoe u migraties kunt bewaken voor elke migratieoptie.

Valideren

Nadat de substatus PerformingPreRequisiteSteps is voltooid, wordt de validatie verplaatst naar de substatus van validatie die wordt uitgevoerd op de bron- en doelserver om de gereedheid voor migratie te beoordelen.

De validatie wordt verplaatst naar de status Geslaagd als alle validaties de status Geslaagd of Waarschuwing hebben.

Het validatieraster heeft de

• Validatiedetails voor bijvoorbeeld en validatiedetails voor databasessecties , die de validatieregels vertegenwoordigen die worden gebruikt om de gereedheid van de migratie te controleren.
• Validatiestatus : vertegenwoordigt het resultaat voor elke regel en kan een van de drie waarden hebben
  • Geslaagd: als er geen fouten zijn gevonden.
  • Mislukt : als er validatiefouten zijn.
  • Waarschuwing: als er validatiewaarschuwingen zijn.
• Duur : de tijd die nodig is voor de validatiebewerking.
• Begin- en eindtijd : begin- en eindtijd van de validatiebewerking in UTC.

De validatiestatus wordt verplaatst naar de status Mislukt als er fouten zijn in de validatie. Selecteer de validatienaam of databasenaamvalidatie die is mislukt en een uitwaaiervenster bevat de details en de corrigerende actie die u moet ondernemen om deze fout te voorkomen.

Migrate

Nadat het substraat PerformingPreRequisiteSteps is voltooid, wordt de migratie verplaatst naar het substraat van De migratie van gegevens wanneer het klonen/kopiëren van de databases plaatsvindt. De tijd die nodig is om de migratie te voltooien, is afhankelijk van de grootte en vorm van de databases die u migreert. De migratie is snel als de gegevens meestal gelijkmatig zijn verdeeld over alle tabellen. Scheve tabelgrootten duren relatief langer.

Wanneer u een van de databases in de migratie selecteert, wordt er een uitwaaiervenster weergegeven. Het bevat het aantal tabellen: gekopieerd, in de wachtrij geplaatst, kopiëren en fouten, afgezien van de status van de databasemigratie.

De migratie wordt verplaatst naar de status Geslaagd wanneer de status Gegevens migreren is voltooid. Als er een probleem is met de status Gegevens migreren, wordt de migratie verplaatst naar de status Mislukt .

Zodra de migratie is verplaatst naar de status Geslaagd , zijn schema's en gegevensmigratie van uw enkele server naar uw flexibele serverdoel voltooid. U kunt de knop Vernieuwen op de pagina gebruiken om hetzelfde te bevestigen.

Valideren en migreren

In deze optie worden validaties eerst uitgevoerd voordat de migratie wordt gestart. Nadat de substatus PerformingPreRequisiteSteps is voltooid, wordt de werkstroom verplaatst naar de substatus van validatie die wordt uitgevoerd.

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

U kunt de resultaten van Valideren en Migreren zien zodra de bewerking is voltooid.

Online (preview)

Vereisten (online)

Voordat u met de migratieservice in Azure Database for PostgreSQL begint, moet u voldoen aan de volgende vereisten, die van toepassing zijn op offlinemigratiescenario's.

De bronversie controleren

De bronversie van PostgreSQL moet zijn >= 9.5. Als de postgreSQL-bronversie kleiner is dan 9.5, voert u vóór de migratie een upgrade uit van de PostgreSQL-bronversie naar 9.5 of hoger.

Onlinemigratieparameters instellen

Voor onlinemigratie moet de ondersteuning voor replicatie worden ingesteld op Logisch onder replicatie-instellingen van de postgreSQL-bronserver. Bovendien moeten de serverparameters max_wal_senders en max_replication_slots -waarden groter zijn dan het aantal databases dat moet worden gemigreerd. De parameters kunnen worden ingesteld in Azure Portal onder Instellingen-serverparameters> of geconfigureerd in de opdrachtregel met behulp van de volgende opdrachten:

• ALTER SYSTEM SET wal_level = logisch;
• ALTER SYSTEM SET max_wal_senders = number of databases to migrate + 1;
• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Zorg ervoor dat er geen langlopende transacties zijn. Langlopende transacties staan het maken van replicatiesites niet toe. Het maken van een replicatiesite slaagt als alle langlopende transacties worden doorgevoerd of teruggedraaid. U moet de PostgreSQL-bronserver opnieuw starten nadat u alle vereisten voor onlinemigratie hebt voltooid.

Notitie

Voor onlinemigratie met azure Database for PostgreSQL enkele server is de ondersteuning voor Azure-replicatie ingesteld op logisch onder de replicatie-instellingen van de pagina met één server in Azure Portal.

Doelinstallatie

• Azure Database for PostgreSQL moet vóór de migratie worden ingesteld 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.

• Raadpleeg de volgende koppeling voor gedetailleerde instructies voor het maken van een nieuwe Azure Database for PostgreSQL: Quickstart: Server maken.

• De serverparameter max_replication_slots moet meer zijn dan het aantal databases dat moet worden gemigreerd. Het kan worden ingesteld in Azure Portal onder Instellingen-serverparameters> of geconfigureerd in de opdrachtregel met behulp van de volgende opdracht:

• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Netwerk instellen

De juiste netwerkconfiguratie is essentieel voor een geslaagde verbinding tussen de bron en het doel tijdens de migratie. Hier volgt een handleiding voor het tot stand brengen van de netwerkverbinding voor verschillende scenario's:

Netwerkvereisten voor migratie:

• ExpressRoute/IPsec VPN/VPN-tunneling: bij het verbinden van uw on-premises/AWS-bron met Azure moet u mogelijk een ExpressRoute-, IPsec-VPN- of VPN-tunneling instellen om beveiligde gegevensoverdracht te vergemakkelijken.

• VNET-peering: Peering van virtuele netwerken tot stand brengen tussen de twee afzonderlijke VNets om directe netwerkconnectiviteit mogelijk te maken, een vereiste voor migratie tussen de Virtuele Azure-machine en de Azure Database for PostgreSQL.

Verbinding maken iviteitsscenario's:

De volgende tabel kan helpen bij het instellen van het netwerk tussen de bron en het doel.

Source	Target	Verbinding maken iviteitstips
Openbaar	Openbaar	Er is geen andere actie vereist als de bron wordt vermeld in de firewallregels van het doel.
Privé	Openbaar	Deze configuratie wordt niet ondersteund; gebruik pg_dump/pg_restore voor gegevensoverdracht.
Openbaar	Persoonlijk	Er is geen andere actie vereist als de bron wordt vermeld in de firewallregels van het doel.
Privé	Privé	Stel een ExpressRoute-, IPsec-VPN-, VPN-tunneling of peering van virtuele netwerken tussen de bron en het doel in.
Privé	Privé-eindpunt	Deze configuratie wordt niet ondersteund; neem contact op met Microsoft Ondersteuning.

Ga naar de netwerkhandleiding voor migratieservice in Azure Database for PostgreSQL - Flexible Server voor meer informatie over het instellen van netwerken.

Uitbreidingen

Extensies zijn extra functies die kunnen worden toegevoegd aan PostgreSQL om de functionaliteit ervan te verbeteren. Extensies worden ondersteund in Azure Database for PostgreSQL, maar moeten handmatig worden ingeschakeld. Volg deze stappen om extensies in te schakelen:

• Gebruik de opdracht Selecteren in de bron om alle extensies weer te geven die worden gebruikt - select extname,extversion from pg_extension;

• Zoek naar de serverparameter azure.extensions op de pagina Serverparameter op uw Azure Database for PostgreSQL. Schakel de extensies in de bron in PostgreSQL in.

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

  

• Controleer of de lijst een van de volgende extensies bevat:

  • PG_CRON
  • PG_HINT_PLAN
  • PG_PARTMAN_BGW
  • PG_PREWARM
  • PG_STAT_STATEMENTS
  • PG_AUDIT
  • PGLOGICAL
  • WAL2JSON

Zo ja, zoekt u op de pagina met serverparameters naar de parameter shared_preload_libraries. Deze parameter geeft de set extensiebibliotheken aan die vooraf zijn geladen bij het opnieuw opstarten van de server.

Serverparameters

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.

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.

Uw Flexibele Azure Database for PostgreSQL-server configureren

• Maak de flexibele doelserver. Raadpleeg de quickstart Een flexibele Azure Database for PostgreSQL-server maken met behulp van de portal voor begeleide stappen.

• Allowlist-extensies waarvan de bibliotheken moeten worden geladen bij het starten van de server. Het is essentieel dat de extensie op de acceptatielijst staat voordat u een migratie start.

• Controleer of de gegevensdistributie tussen de tabellen van een database scheef is, waarbij de meeste gegevens in één (of weinig) tabellen aanwezig zijn. Als deze scheef is, kan de migratiesnelheid langzamer zijn dan verwacht. In dit geval kan de migratiesnelheid worden verhoogd door de grote tabel parallel te migreren.

De migratietaak configureren

De migratieservice wordt geleverd met een eenvoudige, wizardgebaseerde ervaring in Azure Portal. Ga als volgt te werk:

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 Azure Database for PostgreSQL Flexible Server-doel.

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 een migratie van één server naar een flexibele server te starten. Als dit de eerste keer is dat u de migratieservice gebruikt, wordt er een leeg raster weergegeven met een prompt om uw eerste migratie te starten.

   

   Als u al migraties naar uw flexibele serverdoel hebt gemaakt, bevat het raster informatie over migraties die zijn geprobeerd om dit doel te bereiken vanaf de enkele server.

5. Selecteer de knop Migreren van één server . U doorloopt een reeks tabbladen op basis van een wizard om een migratie naar dit flexibele serverdoel te maken vanaf een bronserver met één server.

U kunt het migratieproces ook starten vanaf de Azure Database for PostgreSQL Enkele server.

1. Open uw webbrowser en ga naar de portal. Als u zich wilt aanmelden, moet u uw referenties invoeren. De standaardweergave is uw service-dashboard.

2. Wanneer u de enkele server selecteert, kunt u een banner met betrekking tot migratie bekijken op het tabblad Overzicht. Selecteer Nu migreren om aan de slag te gaan.

   

3. U gaat naar een pagina met twee opties. Als u al een flexibele server hebt gemaakt en deze wilt gebruiken als doel, kiest u Bestaande selecteren en selecteert u de bijbehorende details van het abonnement, de resourcegroep en de servernaam. Zodra de selecties zijn gemaakt, selecteert u de wizard Naar migratie gaan en gaat u verder met de instructies in de sectie Setup van deze pagina.

   

4. Als u een nieuwe flexibele server wilt maken, selecteert u Nieuwe maken en selecteert u Ga naar de wizard Maken. Met deze actie wordt u door het proces voor het maken van flexibele servers geleid en wordt de flexibele server geïmplementeerd.

   

Nadat u de flexibele server hebt geïmplementeerd, volgt u de stappen 3 tot en met 5 onder De migratietaak configureren.

Tabblad Setup

Het eerste tabblad is Setup. Als u dit hebt gemist, moet u de toegestane extensies toestaan, zoals wordt weergegeven in Het is essentieel om deze extensies toe te staan voordat u een migratie start.

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.

Het bronservertype geeft de bron aan. In dit geval is het Azure Database for PostgreSQL Enkele server

Met migratieoptie 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. Migratie wordt alleen geactiveerd als er geen validatiefouten zijn.

Het is altijd een goed idee om de optie Valideren of Valideren en migreren te kiezen om premigratievalidaties uit te voeren voordat u de migratie uitvoert.

Als de preview-versie van de onlinemigratie is geselecteerd, moet logische replicatie zijn ingeschakeld op de bronserver met één server. Als deze niet is ingeschakeld, schakelt de migratieservice automatisch logische replicatie in op de bronserver met één server. Replicatie kan ook handmatig worden ingesteld op het tabblad Replicatie in het deelvenster Eén server door het ondersteuningsniveau voor Azure-replicatie in te stellen op Logisch. Bij beide benaderingen wordt de bronserver met één server opnieuw opgestart.

Selecteer de knop Volgende: Verbinding maken naar bron.

Tabblad Bron

Op het tabblad Bron wordt u gevraagd om details te geven met betrekking tot de enkele server. Dit is de bron van de databases.

Nadat u het abonnement en de resourcegroep hebt geselecteerd, wordt in de vervolgkeuzelijst voor servernamen enkele servers weergegeven onder die resourcegroep in verschillende regio's. Selecteer de bron waaruit u databases wilt migreren. U kunt databases migreren van één server naar een flexibele doelserver in dezelfde regio. Migraties tussen regio's zijn alleen ingeschakeld voor India-, China- en UAE-servers.

Nadat u de bron voor één server hebt gekozen, worden de aanmeldingsnaamvakken Location, PostgreSQL en Server admin automatisch ingevuld. De aanmeldingsnaam van de serverbeheerder is de gebruikersnaam van de beheerder die wordt gebruikt om de enkele server te maken. Voer in het vak Wachtwoord het wachtwoord in voor die gebruiker met beheerdersrechten. De migratieservice migreert individuele serverdatabases als de beheerder.

Nadat u alle velden hebt ingevuld, selecteert u de Verbinding maken naar de bronkoppeling. Hiermee wordt gecontroleerd of de ingevoerde bronservergegevens juist zijn en of de bronserver bereikbaar is.

Selecteer de knop Volgende: Selecteer de knop Migratiedoel om door te gaan.

Doeltabblad

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

Voor de aanmeldingsnaam van de serverbeheerder geeft het tabblad de gebruikersnaam van de beheerder weer die wordt gebruikt tijdens het maken van het flexibele serverdoel. Voer het bijbehorende wachtwoord in voor de gebruiker met beheerdersrechten. Nadat u het wachtwoord hebt ingevuld, selecteert u de Verbinding maken om de doelkoppeling te koppelen. Hiermee wordt gecontroleerd of de opgegeven doelservergegevens juist zijn en de doelserver bereikbaar is.

Selecteer de knop Volgende om de databases te selecteren die u wilt migreren.

Selecteer Databases voor het migratietabblad

Op dit tabblad ziet u een lijst met gebruikersdatabases in de enkele server. U kunt maximaal acht databases selecteren en migreren in één migratiepoging. Als er meer dan acht gebruikersdatabases zijn, wordt het migratieproces herhaald tussen de bron- en doelservers voor de volgende set databases. Standaard worden geselecteerde databases met dezelfde naam op het doel overschreven.

Selecteer de knop Volgende om de details te bekijken.

Samenvatting

Het tabblad Samenvatting bevat een overzicht van alle details voor het maken van de validatie of migratie. Controleer de details en selecteer op de startknop.

De migratie bewaken met behulp van Azure Portal

Nadat u de startknop hebt geselecteerd, wordt er binnen een paar seconden een melding weergegeven om te zeggen dat de validatie of het maken van de migratie is geslaagd. U wordt automatisch omgeleid naar de pagina Migratie van Flexibele server. Dit heeft een nieuwe vermelding voor de onlangs gemaakte validatie of migratie.

Het raster met de migraties bevat deze kolommen: Naam, Status, Migratietype, Migratiemodus, Bronserver, Bronservertype, Databases, Begintijd en Duur. 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 migratie te vernieuwen. U kunt ook de migratienaam in het raster selecteren om de bijbehorende details te bekijken.

Wanneer de validatie of migratie is gemaakt, wordt deze verplaatst naar de status InProgress en de substatus PerformingPreRequisiteSteps . De werkstroom duurt 2-3 minuten om de migratie-infrastructuur en netwerkverbindingen in te stellen.

Laten we eens kijken hoe u migraties kunt bewaken voor elke migratieoptie.

Valideren

Nadat de substatus PerformingPreRequisiteSteps is voltooid, wordt de validatie verplaatst naar de substatus van validatie die wordt uitgevoerd op de bron- en doelserver om de gereedheid voor migratie te beoordelen.

De validatie wordt verplaatst naar de status Geslaagd als alle validaties de status Geslaagd of Waarschuwing hebben.

Het validatieraster heeft de

• Validatiedetails voor bijvoorbeeld en validatiedetails voor databasessecties , die de validatieregels vertegenwoordigen die worden gebruikt om de gereedheid van de migratie te controleren.
• Validatiestatus : vertegenwoordigt het resultaat voor elke regel en kan een van de drie waarden hebben
  • Geslaagd: als er geen fouten zijn gevonden.
  • Mislukt : als er validatiefouten zijn.
  • Waarschuwing: als er validatiewaarschuwingen zijn.
• Duur : de tijd die nodig is voor de validatiebewerking.
• Begin- en eindtijd : begin- en eindtijd van de validatiebewerking in UTC.

De validatiestatus wordt verplaatst naar de status Mislukt als er fouten zijn in de validatie. Selecteer de validatienaam of databasenaamvalidatie die is mislukt en een uitwaaiervenster bevat de details en de corrigerende actie die u moet ondernemen om deze fout te voorkomen.

Migrate

Nadat het substraat PerformingPreRequisiteSteps is voltooid, wordt de migratie verplaatst naar het substraat van De migratie van gegevens wanneer het klonen/kopiëren van de databases plaatsvindt. De tijd die nodig is om de migratie te voltooien, is afhankelijk van de grootte en vorm van de databases die u migreert. De migratie is snel als de gegevens meestal gelijkmatig zijn verdeeld over alle tabellen. Scheve tabelgrootten duren relatief langer.

Wanneer u een van de databases in de migratie selecteert, wordt er een uitwaaiervenster weergegeven. Het bevat het aantal tabellen: gekopieerd, in de wachtrij geplaatst, kopiëren en fouten, afgezien van de status van de databasemigratie.

De migratie wordt verplaatst naar de status Geslaagd wanneer de status Gegevens migreren is voltooid. Als er een probleem is met de status Gegevens migreren, wordt de migratie verplaatst naar de status Mislukt .

Zodra de migratie is verplaatst naar de status Geslaagd , zijn schema's en gegevensmigratie van uw enkele server naar uw flexibele serverdoel voltooid. U kunt de knop Vernieuwen op de pagina gebruiken om hetzelfde te bevestigen.

Valideren en migreren

In deze optie worden validaties eerst uitgevoerd voordat de migratie wordt gestart. Nadat de substatus PerformingPreRequisiteSteps is voltooid, wordt de werkstroom verplaatst naar de substatus van validatie die wordt uitgevoerd.

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

U kunt de resultaten van Valideren en Migreren zien zodra de bewerking is voltooid.

Cutover-migratie

Als er zowel migreren als valideren en migreren is, is voor het voltooien van de onlinemigratie een andere stap vereist: een Cutover-actie is vereist van de gebruiker. Nadat het kopiëren/klonen van de basisgegevens is voltooid, wordt de migratie verplaatst naar de WaitingForUserAction status en het WaitingForCutoverTrigger substraat. In deze status kan de gebruiker cutover activeren vanuit de portal door de migratie te selecteren.

Voordat u cutover start, is het essentieel om ervoor te zorgen dat:

• Schrijfbewerkingen naar de bron worden gestopt:Latency (minutes) parameter is 0 of dicht bij 0. De Latency (minutes) informatie kan worden verkregen via het scherm met migratiedetails, zoals hieronder wordt weergegeven:

Latency (minutes) parameter geeft aan wanneer het doel voor het laatst is gesynchroniseerd met de bron. Voor de bovenstaande ordersdatabase is dit bijvoorbeeld 0,33333. Dit betekent dat de wijzigingen die zijn opgetreden in de afgelopen ~0,3 minuten op de bron nog moeten worden gesynchroniseerd met het doel, voor de ordersdatabase. Op dit moment kunnen schrijfbewerkingen naar de bron worden gestopt en cutover geïnitieerd. Als er veel verkeer bij de bron is, is het raadzaam om eerst schrijfbewerkingen te stoppen, zodat Latency (minutes) deze dicht bij 0 kunnen komen en er vervolgens een cutover wordt gestart. Met de cutover-bewerking worden alle wijzigingen in behandeling van de bron toegepast op het doel en wordt de migratie voltooid. Als u een cutover activeert, zelfs met niet-nul latentie, stopt de replicatie tot dat tijdstip. Alle gegevens op de bron totdat het cutover-punt wordt toegepast op het doel. Stel dat een latentie 15 minuten was op het cutover-punt, dus alle wijzigingsgegevens in de afgelopen 15 minuten worden toegepast op het doel. De tijd die nodig is, is afhankelijk van de achterstand van wijzigingen die in de afgelopen 15 minuten zijn opgetreden. Daarom wordt aanbevolen dat de latentie naar nul of bijna nul gaat voordat de cutover wordt geactiveerd.

De migratie wordt verplaatst naar de Succeeded status zodra de Migrating Data substatus of de cutover (in onlinemigratie) is voltooid. Als er een probleem is met de Migrating Data substatus, wordt de migratie verplaatst naar een Failed status.

Mogelijke migratiestatussen zijn:

• InProgress: 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 mislukt : de validatie is mislukt.
• Geslaagd: de migratie is voltooid en is voltooid.

Mogelijke migratiesubstates zijn:

• PerformingPreRequisiteSteps: De infrastructuur die is ingesteld, wordt uitgevoerd voor gegevensmigratie.
• Validatie wordt uitgevoerd: validatie wordt uitgevoerd.
• MigrationingData: Gegevensmigratie wordt uitgevoerd.
• CompletingMigration: Migratie bevindt zich in de laatste fasen van voltooiing.
• Voltooid: de migratie is voltooid.

De migratie annuleren met behulp van de portal

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 validatie annuleert, wordt verdere validatieactiviteit gestopt en wordt de validatie verplaatst naar de status Geannuleerd. 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

U kunt migreren met behulp van Azure CLI.

Offline

Vereisten (offline)

Voordat u met de migratieservice in Azure Database for PostgreSQL begint, moet u voldoen aan de volgende vereisten, die van toepassing zijn op offlinemigratiescenario's.

De bronversie controleren

De bronversie van PostgreSQL moet zijn >= 9.5. Als de postgreSQL-bronversie kleiner is dan 9.5, voert u vóór de migratie een upgrade uit van de PostgreSQL-bronversie naar 9.5 of hoger.

Doelinstallatie

• Azure Database for PostgreSQL moet vóór de migratie worden ingesteld 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.

• Raadpleeg de volgende koppeling voor gedetailleerde instructies voor het maken van een nieuwe Azure Database for PostgreSQL: Quickstart: Server maken.

Netwerk instellen

De juiste netwerkconfiguratie is essentieel voor een geslaagde verbinding tussen de bron en het doel tijdens de migratie. Hier volgt een handleiding voor het tot stand brengen van de netwerkverbinding voor verschillende scenario's:

Netwerkvereisten voor migratie:

• ExpressRoute/IPsec VPN/VPN-tunneling: bij het verbinden van uw on-premises/AWS-bron met Azure moet u mogelijk een ExpressRoute-, IPsec-VPN- of VPN-tunneling instellen om beveiligde gegevensoverdracht te vergemakkelijken.

• VNET-peering: Peering van virtuele netwerken tot stand brengen tussen de twee afzonderlijke VNets om directe netwerkconnectiviteit mogelijk te maken, een vereiste voor migratie tussen de Virtuele Azure-machine en de Azure Database for PostgreSQL.

Verbinding maken iviteitsscenario's:

De volgende tabel kan helpen bij het instellen van het netwerk tussen de bron en het doel.

Source	Target	Verbinding maken iviteitstips
Openbaar	Openbaar	Er is geen andere actie vereist als de bron is opgenomen in de firewallregels van het doel.
Privé	Openbaar	Deze configuratie wordt niet ondersteund; gebruik pg_dump/pg_restore voor gegevensoverdracht.
Openbaar	Persoonlijk	Er is geen andere actie vereist als de bron is opgenomen in de firewallregels van het doel.
Privé	Privé	Stel een ExpressRoute-, IPsec-VPN-, VPN-tunneling of peering van virtuele netwerken tussen de bron en het doel in.
Privé	Privé-eindpunt	Deze configuratie wordt niet ondersteund; neem contact op met Microsoft Ondersteuning.

Aanvullende aandachtspunten voor netwerken:

• pg_hba.conf-configuratie: om connectiviteit tussen de bron- en doelexemplaren van PostgreSQL te vergemakkelijken, is het essentieel om het bestand pg_hba.conf te verifiëren en te wijzigen. Dit bestand bevat clientverificatie en moet zo worden geconfigureerd dat de doelpostgreSQL verbinding kan maken met de bron. Voor wijzigingen in het bestand pg_hba.conf moet doorgaans opnieuw worden opgestart van het PostgreSQL-bronexemplaren.

Notitie

Het bestand pg_hba.conf bevindt zich in de gegevensmap van de PostgreSQL-installatie. Dit bestand moet worden gecontroleerd en geconfigureerd als de brondatabase een on-premises PostgreSQL-server of een PostgreSQL-server is die wordt gehost op een Azure-VM. Voor PostgreSQL-exemplaren op AWS RDS of vergelijkbare beheerde services is het bestand pg_hba.conf niet rechtstreeks toegankelijk of van toepassing. In plaats daarvan wordt de toegang beheerd via de geleverde beveiligings- en netwerktoegangsconfiguraties van de service.

Ga naar de netwerkhandleiding voor migratieservice in Azure Database for PostgreSQL - Flexible Server voor meer informatie over het instellen van netwerken.

Uitbreidingen

Extensies zijn extra functies die kunnen worden toegevoegd aan PostgreSQL om de functionaliteit ervan te verbeteren. Extensies worden ondersteund in Azure Database for PostgreSQL, maar moeten handmatig worden ingeschakeld. Volg deze stappen om extensies in te schakelen:

• Gebruik de opdracht Selecteren in de bron om alle extensies weer te geven die worden gebruikt - select extname,extversion from pg_extension;

• Zoek naar de serverparameter azure.extensions op de pagina Serverparameter op uw Azure Database for PostgreSQL. Schakel de extensies in de bron in PostgreSQL in.

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

  

• Controleer of de lijst een van de volgende extensies bevat:

  • PG_CRON
  • PG_HINT_PLAN
  • PG_PARTMAN_BGW
  • PG_PREWARM
  • PG_STAT_STATEMENTS
  • PG_AUDIT
  • PGLOGICAL
  • WAL2JSON

Zo ja, zoekt u op de pagina met serverparameters naar de parameter shared_preload_libraries. Deze parameter geeft de set extensiebibliotheken aan die vooraf zijn geladen bij het opnieuw opstarten van de server.

Serverparameters

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.

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.

Aan de slag

1. Als u niet eerder met Microsoft Azure werkt, maakt u een account om de aanbiedingen te evalueren.

2. Installeer de nieuwste Azure CLI voor uw besturingssysteem vanaf de azure CLI-installatiepagina.

   Als de Azure CLI al is geïnstalleerd, controleert u de versie met behulp van de az version opdracht. De versie moet 2.50.0 of hoger zijn om de CLI-opdrachten voor migratie te gebruiken. Als dat niet het is, werkt u de Azure CLI-versie bij.

3. Voer de az login opdracht uit:

   az login
   

   Er wordt een browservenster geopend met de aanmeldingspagina van Azure. Geef uw Azure-referenties op om een geslaagde verificatie uit te voeren. Raadpleeg dit artikel voor andere manieren om u aan te melden met de Azure CLI.

CLI-opdrachten voor migratie (offline)

De migratieservice wordt geleverd met gebruiksvriendelijke CLI-opdrachten voor het uitvoeren van migratiegerelateerde taken. Alle CLI-opdrachten beginnen met az postgres flexible-server migration. Het is belangrijk om de extensies toe te staan voordat u een migratie start.

Voor hulp bij het begrijpen van de opties die zijn gekoppeld aan een opdracht en bij het inlijsten van de juiste syntaxis, kunt u de help parameter gebruiken:

az postgres flexible-server migration --help

Met de bovenstaande opdracht krijgt u de volgende uitvoer:

De uitvoer bevat de ondersteunde migratieopdrachten, samen met hun acties. Laten we deze opdrachten in detail bekijken.

Een migratie maken met behulp van de Azure CLI

De create opdracht helpt bij het maken van een migratie van een bronserver naar een doelserver:

az postgres flexible-server migration create -- help

Met de bovenstaande opdracht krijgt u het volgende resultaat:

Het bevat de verwachte argumenten en heeft een voorbeeldsyntaxis voor het maken van een migratie van de bronserver naar de doelserver. Hier volgt de CLI-opdracht voor het maken van een nieuwe migratie:

az postgres flexible-server migration create [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]
                                            [--migration-mode]
                                            [--properties]

Parameter	Description
subscription	Abonnements-id van het doel flexibele server.
resource-group	Resourcegroep van het doel flexibele server.
name	Naam van het flexibele serverdoel.
migration-name	Er is een unieke id voor migraties geprobeerd naar Flexibele server te gaan. Dit veld accepteert alleen alfanumerieke tekens en accepteert geen speciale tekens, behalve een afbreekstreepje (-). De naam kan niet beginnen met -en er kunnen geen twee migraties naar een flexible server-doel dezelfde naam hebben.
migration-mode	Dit is een optionele parameter. Standaardwaarde: Offline. Offlinemigratie omvat het kopiëren van uw brondatabases op een bepaald moment naar uw doelserver.
properties	Absoluut pad naar een JSON-bestand met de informatie over de bron van één server.

Voorbeeld:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode offline

Het migration-name argument dat in de create opdracht wordt gebruikt, wordt gebruikt in andere CLI-opdrachten, zoals update, deleteen show. het identificeert de migratiepoging in de bijbehorende acties in al deze opdrachten.

Ten slotte moet voor de create opdracht een JSON-bestand worden doorgegeven als onderdeel van het properties argument.

De structuur van de JSON is:

{
"properties": {
 "sourceDbServerResourceId":"/subscriptions/<subscriptionid>/resourceGroups/<src_ rg_name>/providers/Microsoft.DBforPostgreSQL/servers/<source server name>",
"secretParameters": {
    "adminCredentials":
    {
      "sourceServerPassword": "<password>",
      "targetServerPassword": "<password>"
    },
   "sourceServerUserName": "<username>@<servername>",
   "targetServerUserName": "<username>"
},

"dbsToMigrate":
   [
   "<db1>","<db2>"
   ],

"overwriteDbsInTarget":"true"

}
}

De create parameters die naar de JSON-bestandsindeling gaan, zijn zoals hieronder wordt weergegeven:

Parameter	Type	Beschrijving
sourceDbServerResourceId	Vereist	Deze parameter is de resource-id van de bron enkele server en is verplicht.
adminCredentials	Vereist	Deze parameter bevat wachtwoorden voor beheerdersgebruikers voor zowel de bron van één server als het doel van de flexibele server. Deze wachtwoorden helpen bij het verifiëren bij de bron- en doelservers.
sourceServerUserName	Vereist	De standaardwaarde is de gebruiker met beheerdersrechten die is gemaakt tijdens het maken van één server en het opgegeven wachtwoord wordt gebruikt voor verificatie bij deze gebruiker. Als u de standaardgebruiker niet gebruikt, is deze parameter de gebruiker of rol op de bronserver voor het uitvoeren van de migratie. Deze gebruiker moet over de benodigde bevoegdheden en het eigendom van de databaseobjecten beschikken die betrokken zijn bij de migratie en moet lid zijn van de azure_pg_admin rol.
targetServerUserName	Vereist	De standaardwaarde is de beheerder die is gemaakt tijdens het maken van een flexibele server en het opgegeven wachtwoord wordt gebruikt voor verificatie bij deze gebruiker. Als u de standaardgebruiker niet gebruikt, is deze parameter de gebruiker of rol op de doelserver die wordt gebruikt voor het uitvoeren van de migratie. Deze gebruiker moet lid zijn van azure_pg_admin, pg_read_all_settings, pg_read_all_stats,pg_stat_scan_tables rollen en moet de rol Maken, DB-kenmerken maken hebben.
dbsToMigrate	Vereist	Geef de lijst op met databases die u wilt migreren naar Flexible Server. Alleen gebruikersdatabases worden gemigreerd. Systeemdatabases of sjabloondatabases, zoals template0 en template1, worden niet gemigreerd.
overwriteDbsInTarget	Vereist	Als de doelserver een bestaande database heeft met dezelfde naam als de database die u wilt migreren, overschrijft de migratieservice de database automatisch als waar.
SetupLogicalReplicationOnSourceDBIfNeeded	Optioneel	U kunt logische replicatie automatisch inschakelen op de bronserver door deze eigenschap in te stellen op true. Voor deze wijziging in de serverinstellingen moet de server opnieuw worden opgestart met twee tot drie minuten downtime.
SourceDBServerFullyQualifiedDomainName	Optioneel	Gebruik deze wanneer een aangepaste DNS-server wordt gebruikt voor naamomzetting voor een virtueel netwerk. Geef de FQDN-naam van de bron met één server op volgens de aangepaste DNS-server voor deze eigenschap.
TargetDBServerFullyQualifiedDomainName	Optioneel	Gebruik deze wanneer een aangepaste DNS-server wordt gebruikt voor naamomzetting in een virtueel netwerk. Geef de FQDN-naam van het flexibele-serverdoel op volgens de aangepaste DNS-server. SourceDBServerFullyQualifiedDomainName en TargetDBServerFullyQualifiedDomainName worden opgenomen als onderdeel van de JSON alleen in het zeldzame scenario dat een aangepaste DNS-server wordt gebruikt voor naamomzetting in plaats van door Azure geleverde DNS. Neem anders deze parameters niet op in het JSON-bestand.

Let op deze essentiële punten voor het opdrachtantwoord:

• Wanneer de create opdracht wordt geactiveerd, wordt de migratie verplaatst naar de InProgress status en het PerformingPreRequisiteSteps substraat. Het duurt enkele minuten voordat de migratiewerkstroom de migratie-infrastructuur implementeert en verbindingen tussen de bron en het doel instelt.
• Nadat de PerformingPreRequisiteSteps substatus is voltooid, wordt de migratie verplaatst naar het substraat waar Migrating Data, het klonen/kopiëren van de databases plaatsvindt.
• Elke gemigreerde database heeft een eigen sectie met alle migratiedetails, zoals het aantal tabellen, incrementele invoegingen, verwijderingen en wachtende bytes.
• De tijd die nodig is om de Migrating Data substaat te voltooien, is afhankelijk van de grootte van de gemigreerde databases.
• De migratie wordt verplaatst naar de Succeeded status zodra de Migrating Data substatus is voltooid. Als er een probleem is met de Migrating Data substatus, wordt de migratie verplaatst naar een Failed status.

Replicatie instellen

Als de preview-versie van de onlinemigratie is geselecteerd, moet logische replicatie zijn ingeschakeld op de bronserver met één server. Als deze niet is ingeschakeld, schakelt de migratieservice automatisch logische replicatie in op de bronserver met één server wanneer de SetupLogicalReplicationOnSourceDBIfNeeded parameter wordt doorgegeven met een waarde in true het bijbehorende JSON-bestand. Replicatie kan ook handmatig worden ingesteld bij de bron na het starten van de migratie met behulp van de onderstaande opdracht. Bij beide benaderingen voor het inschakelen van logische replicatie wordt de bronserver met één server opnieuw gestart.

Voorbeeld:

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --setup-replication

Deze opdracht is vereist om de migratie door te voeren wanneer de flexibele server in de WaitingForLogicalReplicationSetupRequestOnSourceDB status wacht.

Als u onlinemigratie wilt uitvoeren in een van de bovenstaande regio's, gebruikt u:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode online

De migraties vermelden

De list opdracht geeft een overzicht van alle migratiepogingen die zijn uitgevoerd naar een flexibele serverdoel:

az postgres flexible-server migration list [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--filter]

De filter parameter heeft twee opties:

• Active: geeft een lijst weer van de huidige actieve migratiepogingen (wordt uitgevoerd) naar de doelserver. Het bevat niet de migraties die zijn mislukt, geannuleerd of geslaagd.
• All: geeft een lijst weer van alle migratiepogingen naar de doelserver. Dit omvat zowel de actieve als eerdere migraties, ongeacht de status.

Gebruik de help parameter voor meer informatie over deze opdracht:

az postgres flexible-server migration list -- help

De migratie bewaken

De show opdracht helpt u bij het bewaken van lopende migraties en geeft de huidige status en substatus van de migratie. Deze details bevatten informatie over de huidige status en substatus van de migratie.

az postgres flexible-server migration show [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]

De migration_name parameter is de naam die tijdens de opdracht aan de create migratie is toegewezen. Hier volgt een momentopname van het voorbeeldantwoord van de CLI-opdracht voor het weergeven van details:

Gebruik de help parameter voor meer informatie over deze opdracht:

 az postgres flexible-server migration show -- help

In de volgende tabellen worden de migratiestatussen en substatussen beschreven.

Migratiestatus	Beschrijving
InProgress	De migratie-infrastructuur is ingesteld of de werkelijke gegevensmigratie wordt uitgevoerd.
Canceled	De migratie wordt geannuleerd of verwijderd.
Failed	De migratie is mislukt.
Succeeded	De migratie is voltooid en is voltooid.

Migratiesubstate	Beschrijving
PerformingPreRequisiteSteps	De infrastructuur is ingesteld en wordt voorbereid voor gegevensmigratie.
MigratingData	Gegevensmigratie wordt uitgevoerd.
CompletingMigration	De migratie-cutover wordt uitgevoerd.
Completed	cutover is geslaagd en de migratie is voltooid.

Online (preview)

Vereisten (online)

Voordat u met de migratieservice in Azure Database for PostgreSQL begint, moet u voldoen aan de volgende vereisten, die van toepassing zijn op offlinemigratiescenario's.

De bronversie controleren

De bronversie van PostgreSQL moet zijn >= 9.5. Als de postgreSQL-bronversie kleiner is dan 9.5, voert u vóór de migratie een upgrade uit van de PostgreSQL-bronversie naar 9.5 of hoger.

Onlinemigratieparameters instellen

Voor onlinemigratie moet de ondersteuning voor replicatie worden ingesteld op Logisch onder replicatie-instellingen van de postgreSQL-bronserver. Bovendien moeten de serverparameters max_wal_senders en max_replication_slots -waarden groter zijn dan het aantal databases dat moet worden gemigreerd. De parameters kunnen worden ingesteld in Azure Portal onder Instellingen-serverparameters> of geconfigureerd in de opdrachtregel met behulp van de volgende opdrachten:

• ALTER SYSTEM SET wal_level = logisch;
• ALTER SYSTEM SET max_wal_senders = number of databases to migrate + 1;
• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Zorg ervoor dat er geen langlopende transacties zijn. Langlopende transacties staan het maken van replicatiesites niet toe. Het maken van een replicatiesite slaagt als alle langlopende transacties worden doorgevoerd of teruggedraaid. U moet de PostgreSQL-bronserver opnieuw starten nadat u alle vereisten voor onlinemigratie hebt voltooid.

Notitie

Voor onlinemigratie met azure Database for PostgreSQL enkele server is de ondersteuning voor Azure-replicatie ingesteld op logisch onder de replicatie-instellingen van de pagina met één server in Azure Portal.

Doelinstallatie

• Azure Database for PostgreSQL moet vóór de migratie worden ingesteld 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.

• Raadpleeg de volgende koppeling voor gedetailleerde instructies voor het maken van een nieuwe Azure Database for PostgreSQL: Quickstart: Server maken.

• De serverparameter max_replication_slots moet meer zijn dan het aantal databases dat moet worden gemigreerd. Het kan worden ingesteld in Azure Portal onder Instellingen-serverparameters> of geconfigureerd in de opdrachtregel met behulp van de volgende opdracht:

• ALTER SYSTEM SET max_replication_slots = number of databases to migrate + 1;

Netwerk instellen

De juiste netwerkconfiguratie is essentieel voor een geslaagde verbinding tussen de bron en het doel tijdens de migratie. Hier volgt een handleiding voor het tot stand brengen van de netwerkverbinding voor verschillende scenario's:

Netwerkvereisten voor migratie:

• ExpressRoute/IPsec VPN/VPN-tunneling: bij het verbinden van uw on-premises/AWS-bron met Azure moet u mogelijk een ExpressRoute-, IPsec-VPN- of VPN-tunneling instellen om beveiligde gegevensoverdracht te vergemakkelijken.

• VNET-peering: Peering van virtuele netwerken tot stand brengen tussen de twee afzonderlijke VNets om directe netwerkconnectiviteit mogelijk te maken, een vereiste voor migratie tussen de Virtuele Azure-machine en de Azure Database for PostgreSQL.

Verbinding maken iviteitsscenario's:

De volgende tabel kan helpen bij het instellen van het netwerk tussen de bron en het doel.

Source	Target	Verbinding maken iviteitstips
Openbaar	Openbaar	Er is geen andere actie vereist als de bron wordt vermeld in de firewallregels van het doel.
Privé	Openbaar	Deze configuratie wordt niet ondersteund; gebruik pg_dump/pg_restore voor gegevensoverdracht.
Openbaar	Persoonlijk	Er is geen andere actie vereist als de bron wordt vermeld in de firewallregels van het doel.
Privé	Privé	Stel een ExpressRoute-, IPsec-VPN-, VPN-tunneling of peering van virtuele netwerken tussen de bron en het doel in.
Privé	Privé-eindpunt	Deze configuratie wordt niet ondersteund; neem contact op met Microsoft Ondersteuning.

Ga naar de netwerkhandleiding voor migratieservice in Azure Database for PostgreSQL - Flexible Server voor meer informatie over het instellen van netwerken.

Uitbreidingen

Extensies zijn extra functies die kunnen worden toegevoegd aan PostgreSQL om de functionaliteit ervan te verbeteren. Extensies worden ondersteund in Azure Database for PostgreSQL, maar moeten handmatig worden ingeschakeld. Volg deze stappen om extensies in te schakelen:

• Gebruik de opdracht Selecteren in de bron om alle extensies weer te geven die worden gebruikt - select extname,extversion from pg_extension;

• Zoek naar de serverparameter azure.extensions op de pagina Serverparameter op uw Azure Database for PostgreSQL. Schakel de extensies in de bron in PostgreSQL in.

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

  

• Controleer of de lijst een van de volgende extensies bevat:

  • PG_CRON
  • PG_HINT_PLAN
  • PG_PARTMAN_BGW
  • PG_PREWARM
  • PG_STAT_STATEMENTS
  • PG_AUDIT
  • PGLOGICAL
  • WAL2JSON

Zo ja, zoekt u op de pagina met serverparameters naar de parameter shared_preload_libraries. Deze parameter geeft de set extensiebibliotheken aan die vooraf zijn geladen bij het opnieuw opstarten van de server.

Serverparameters

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.

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.

Aan de slag

1. Als u niet eerder met Microsoft Azure werkt, maakt u een account om de aanbiedingen te evalueren.

2. Installeer de nieuwste Azure CLI voor uw besturingssysteem vanaf de azure CLI-installatiepagina.

   Als de Azure CLI al is geïnstalleerd, controleert u de versie met behulp van de az version opdracht. De versie moet 2.50.0 of hoger zijn om de CLI-opdrachten voor migratie te gebruiken. Als dat niet het is, werkt u de Azure CLI-versie bij.

3. Voer de az login opdracht uit:

   az login
   

   Er wordt een browservenster geopend met de aanmeldingspagina van Azure. Geef uw Azure-referenties op om een geslaagde verificatie uit te voeren. Raadpleeg dit artikel voor andere manieren om u aan te melden met de Azure CLI.

CLI-opdrachten voor migratie (online)

De migratieservice wordt geleverd met gebruiksvriendelijke CLI-opdrachten voor het uitvoeren van migratiegerelateerde taken. Alle CLI-opdrachten beginnen met az postgres flexible-server migration. Het is belangrijk om de extensies toe te staan voordat u een migratie start.

Voor hulp bij het begrijpen van de opties die zijn gekoppeld aan een opdracht en bij het inlijsten van de juiste syntaxis, kunt u de help parameter gebruiken:

az postgres flexible-server migration --help

Met de bovenstaande opdracht krijgt u de volgende uitvoer:

De uitvoer bevat de ondersteunde migratieopdrachten, samen met hun acties. Laten we deze opdrachten in detail bekijken.

Een migratie maken met behulp van de Azure CLI

De create opdracht helpt bij het maken van een migratie van een bronserver naar een doelserver:

az postgres flexible-server migration create -- help

Met de bovenstaande opdracht krijgt u het volgende resultaat:

Het bevat de verwachte argumenten en heeft een voorbeeldsyntaxis voor het maken van een migratie van de bronserver naar de doelserver. Hier volgt de CLI-opdracht voor het maken van een nieuwe migratie:

az postgres flexible-server migration create [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]
                                            [--migration-mode]
                                            [--properties]

Parameter	Description
subscription	Abonnements-id van het doel flexibele server.
resource-group	Resourcegroep van het doel flexibele server.
name	Naam van het flexibele serverdoel.
migration-name	Er is een unieke id voor migraties geprobeerd naar Flexibele server te gaan. Dit veld accepteert alleen alfanumerieke tekens en accepteert geen speciale tekens, behalve een afbreekstreepje (-). De naam kan niet beginnen met -en er kunnen geen twee migraties naar een flexible server-doel dezelfde naam hebben.
migration-mode	Dit is een optionele parameter. Standaardwaarde: Offline. Offlinemigratie omvat het kopiëren van uw brondatabases op een bepaald moment naar uw doelserver.
properties	Absoluut pad naar een JSON-bestand met de informatie over de bron van één server.

Voorbeeld:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode offline

Het migration-name argument dat in de create opdracht wordt gebruikt, wordt gebruikt in andere CLI-opdrachten, zoals update, deleteen show. het identificeert de migratiepoging in de bijbehorende acties in al deze opdrachten.

Ten slotte moet voor de create opdracht een JSON-bestand worden doorgegeven als onderdeel van het properties argument.

De structuur van de JSON is:

{
"properties": {
 "sourceDbServerResourceId":"/subscriptions/<subscriptionid>/resourceGroups/<src_ rg_name>/providers/Microsoft.DBforPostgreSQL/servers/<source server name>",
"secretParameters": {
    "adminCredentials":
    {
      "sourceServerPassword": "<password>",
      "targetServerPassword": "<password>"
    },
   "sourceServerUserName": "<username>@<servername>",
   "targetServerUserName": "<username>"
},

"dbsToMigrate":
   [
   "<db1>","<db2>"
   ],

"overwriteDbsInTarget":"true"

}
}

De create parameters die naar de JSON-bestandsindeling gaan, zijn zoals hieronder wordt weergegeven:

Parameter	Type	Beschrijving
sourceDbServerResourceId	Vereist	Deze parameter is de resource-id van de bron enkele server en is verplicht.
adminCredentials	Vereist	Deze parameter bevat wachtwoorden voor beheerdersgebruikers voor zowel de bron van één server als het doel van de flexibele server. Deze wachtwoorden helpen bij het verifiëren bij de bron- en doelservers.
sourceServerUserName	Vereist	De standaardwaarde is de gebruiker met beheerdersrechten die is gemaakt tijdens het maken van één server en het opgegeven wachtwoord wordt gebruikt voor verificatie bij deze gebruiker. Als u de standaardgebruiker niet gebruikt, is deze parameter de gebruiker of rol op de bronserver voor het uitvoeren van de migratie. Deze gebruiker moet over de benodigde bevoegdheden en het eigendom van de databaseobjecten beschikken die betrokken zijn bij de migratie en moet lid zijn van de azure_pg_admin rol.
targetServerUserName	Vereist	De standaardwaarde is de beheerder die is gemaakt tijdens het maken van een flexibele server en het opgegeven wachtwoord wordt gebruikt voor verificatie bij deze gebruiker. Als u de standaardgebruiker niet gebruikt, is deze parameter de gebruiker of rol op de doelserver die wordt gebruikt voor het uitvoeren van de migratie. Deze gebruiker moet lid zijn van azure_pg_admin, pg_read_all_settings, pg_read_all_stats,pg_stat_scan_tables rollen en moet de rol Maken, DB-kenmerken maken hebben.
dbsToMigrate	Vereist	Geef de lijst op met databases die u wilt migreren naar Flexible Server. Alleen gebruikersdatabases worden gemigreerd. Systeemdatabases of sjabloondatabases, zoals template0 en template1, worden niet gemigreerd.
overwriteDbsInTarget	Vereist	Als de doelserver een bestaande database heeft met dezelfde naam als de database die u wilt migreren, overschrijft de migratieservice de database automatisch als waar.
SetupLogicalReplicationOnSourceDBIfNeeded	Optioneel	U kunt logische replicatie automatisch inschakelen op de bronserver door deze eigenschap in te stellen op true. Voor deze wijziging in de serverinstellingen moet de server opnieuw worden opgestart met twee tot drie minuten downtime.
SourceDBServerFullyQualifiedDomainName	Optioneel	Gebruik deze wanneer een aangepaste DNS-server wordt gebruikt voor naamomzetting voor een virtueel netwerk. Geef de FQDN-naam van de bron met één server op volgens de aangepaste DNS-server voor deze eigenschap.
TargetDBServerFullyQualifiedDomainName	Optioneel	Gebruik deze wanneer een aangepaste DNS-server wordt gebruikt voor naamomzetting in een virtueel netwerk. Geef de FQDN-naam van het flexibele-serverdoel op volgens de aangepaste DNS-server. SourceDBServerFullyQualifiedDomainName en TargetDBServerFullyQualifiedDomainName worden opgenomen als onderdeel van de JSON alleen in het zeldzame scenario dat een aangepaste DNS-server wordt gebruikt voor naamomzetting in plaats van door Azure geleverde DNS. Neem anders deze parameters niet op in het JSON-bestand.

Let op deze essentiële punten voor het opdrachtantwoord:

• Wanneer de create opdracht wordt geactiveerd, wordt de migratie verplaatst naar de InProgress status en het PerformingPreRequisiteSteps substraat. Het duurt enkele minuten voordat de migratiewerkstroom de migratie-infrastructuur implementeert en verbindingen tussen de bron en het doel instelt.
• Nadat de PerformingPreRequisiteSteps substatus is voltooid, wordt de migratie verplaatst naar het substraat waar Migrating Data, het klonen/kopiëren van de databases plaatsvindt.
• Elke gemigreerde database heeft een eigen sectie met alle migratiedetails, zoals het aantal tabellen, incrementele invoegingen, verwijderingen en wachtende bytes.
• De tijd die nodig is om de Migrating Data substaat te voltooien, is afhankelijk van de grootte van de gemigreerde databases.
• De migratie wordt verplaatst naar de Succeeded status zodra de Migrating Data substatus is voltooid. Als er een probleem is met de Migrating Data substatus, wordt de migratie verplaatst naar een Failed status.

Replicatie instellen

Als de preview-versie van de onlinemigratie is geselecteerd, moet logische replicatie zijn ingeschakeld op de bronserver met één server. Als deze niet is ingeschakeld, schakelt de migratieservice automatisch logische replicatie in op de bronserver met één server wanneer de SetupLogicalReplicationOnSourceDBIfNeeded parameter wordt doorgegeven met een waarde in true het bijbehorende JSON-bestand. Replicatie kan ook handmatig worden ingesteld bij de bron na het starten van de migratie met behulp van de onderstaande opdracht. Bij beide benaderingen voor het inschakelen van logische replicatie wordt de bronserver met één server opnieuw gestart.

Voorbeeld:

az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name CLIMigrationExample --setup-replication

Deze opdracht is vereist om de migratie door te voeren wanneer de flexibele server in de WaitingForLogicalReplicationSetupRequestOnSourceDB status wacht.

Als u onlinemigratie wilt uitvoeren in een van de bovenstaande regio's, gebruikt u:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode online

De migraties vermelden

De list opdracht geeft een overzicht van alle migratiepogingen die zijn uitgevoerd naar een flexibele serverdoel:

az postgres flexible-server migration list [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--filter]

De filter parameter heeft twee opties:

• Active: geeft een lijst weer van de huidige actieve migratiepogingen (wordt uitgevoerd) naar de doelserver. Het bevat niet de migraties die zijn mislukt, geannuleerd of geslaagd.
• All: geeft een lijst weer van alle migratiepogingen naar de doelserver. Dit omvat zowel de actieve als eerdere migraties, ongeacht de status.

Gebruik de help parameter voor meer informatie over deze opdracht:

az postgres flexible-server migration list -- help

De migratie bewaken

De show opdracht helpt u bij het bewaken van lopende migraties en geeft de huidige status en substatus van de migratie. Deze details bevatten informatie over de huidige status en substatus van de migratie.

az postgres flexible-server migration show [--subscription]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]

De migration_name parameter is de naam die tijdens de opdracht aan de create migratie is toegewezen. Hier volgt een momentopname van het voorbeeldantwoord van de CLI-opdracht voor het weergeven van details:

Gebruik de help parameter voor meer informatie over deze opdracht:

 az postgres flexible-server migration show -- help

In de volgende tabellen worden de migratiestatussen en substatussen beschreven.

Migratiestatus	Beschrijving
InProgress	De migratie-infrastructuur is ingesteld of de werkelijke gegevensmigratie wordt uitgevoerd.
Canceled	De migratie wordt geannuleerd of verwijderd.
Failed	De migratie is mislukt.
Succeeded	De migratie is voltooid en is voltooid.

Migratiesubstate	Beschrijving
PerformingPreRequisiteSteps	De infrastructuur is ingesteld en wordt voorbereid voor gegevensmigratie.
MigratingData	Gegevensmigratie wordt uitgevoerd.
CompletingMigration	De migratie-cutover wordt uitgevoerd.
Completed	cutover is geslaagd en de migratie is voltooid.

Cutover de migratie

Nadat de basisgegevensmigratie is voltooid, wordt de migratietaak in onlinemigratie verplaatst naar WaitingForCutoverTrigger substatus. In deze status kan de gebruiker cutover activeren via CLI met behulp van de onderstaande opdracht. De cutover kan ook worden geactiveerd vanuit de portal door de migratienaam in het migratieraster te selecteren.

Voorbeeld:

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

Voordat u cutover start, is het belangrijk om ervoor te zorgen dat:

• Schrijfbewerkingen naar de bron worden gestopt:latency parameter neemt af tot 0 of dicht bij 0

latency parameter geeft aan wanneer het doel voor het laatst is gesynchroniseerd met de bron. Hier is het bijvoorbeeld 201 en 202 voor de twee databases, zoals wordt weergegeven in de onderstaande afbeelding. Dit betekent dat de wijzigingen die in de afgelopen ~200 seconden bij de bron zijn opgetreden, nog moeten worden gesynchroniseerd met het doel. Op dit moment kunnen schrijfbewerkingen naar de bron worden gestopt en cutover geïnitieerd. Als er veel verkeer bij de bron is, is het raadzaam om eerst schrijfbewerkingen te stoppen, zodat Latency deze dicht bij 0 kunnen komen en vervolgens cutover wordt gestart. Met de cutover-bewerking worden alle wijzigingen in behandeling van de bron toegepast op het doel en wordt de migratie voltooid. Als u een cutover activeert, zelfs met niet-nul Latency, stopt de replicatie tot dat tijdstip. Alle gegevens op de bron totdat het cutover-punt wordt toegepast op het doel. Stel dat een latentie 15 minuten was op het cutover-punt, dus alle wijzigingsgegevens in de afgelopen 15 minuten zijn van toepassing op het doel. De tijd die nodig is, is afhankelijk van de achterstand van wijzigingen die in de afgelopen 15 minuten zijn opgetreden. Daarom wordt aanbevolen dat de latentie naar nul of bijna nul gaat voordat de cutover wordt geactiveerd. De latency informatie kan worden verkregen met behulp van de opdracht migratievoorstelling. Hier volgt een momentopname van de migratie voordat u de cutover start:

Nadat de cutover is gestart, worden alle transacties die tijdens de basiskopie zijn uitgevoerd, opeenvolgend naar het doel gekopieerd en wordt de migratie voltooid.

Als de cutover niet lukt, wordt de migratie verplaatst naar de Failed status.

Gebruik de help parameter voor meer informatie over deze opdracht:

 az postgres flexible-server migration update -- help

De migratie annuleren met CLI

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]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]

Voorbeeld:

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

Gebruik de help parameter voor meer informatie over deze opdracht:

 az postgres flexible-server migration update cancel -- help

Met de opdracht krijgt u de volgende uitvoer:

Na de migratie

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

• Migratieservice
• Migreren van AWS RDS
• Aanbevolen procedures
• Bekende problemen en beperkingen
• Netwerkinstallatie
• Premigratievalidaties