Zelfstudie: Migreren van AWS RDS PostgreSQL naar Azure Database for PostgreSQL met behulp van de migratieservice

VAN TOEPASSING OP: Azure Database for PostgreSQL - Flexibele server

In deze zelfstudie wordt u begeleid bij het migreren van een PostgreSQL-exemplaar van uw AWS RDS naar Azure Database for a PostgreSQL flexibele server met behulp van Azure Portal en Azure CLI.

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 flexibele Azure Database for PostgreSQL-server te vereenvoudigen.

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

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.

Gebruikers en rollen

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.

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.

Portal

U kunt migreren met behulp van Azure Portal.

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 van AWS RDS naar een flexibele server te migreren.

   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

Het eerste tabblad is het tabblad Setup.

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 AWS 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. Migratie wordt geactiveerd als er geen validatiefouten zijn.
    • Het kiezen van de optie Valideren of Valideren en migreren is altijd een goede gewoonte om premigratievalidaties uit te voeren 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 naar bron.

Verbinding maken naar de bron

De Verbinding maken naar het tabblad Bron vraagt u om details te geven met betrekking tot de bron die is geselecteerd op het tabblad Setup, 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.

• Test Verbinding maken ion: voert de connectiviteitstest tussen doel en bron uit. Zodra de verbinding tot stand is gebracht, 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. Testverbinding duurt enkele minuten om een verbinding tot stand te brengen tussen het doel en de bron.

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

Verbinding maken naar het doel

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

• Beheer gebruikersnaam - Beheer gebruikersnaam van de PostgreSQL-doelserver

• Wachtwoord - Wachtwoord van de PostgreSQL-doelserver

• Test Verbinding maken ion: voert de connectiviteitstest tussen doel en 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 voor 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

Databases 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 automatisch omgeleid naar de pagina Migratie van flexibele server. 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 waarin de migraties worden weergegeven, bevat deze 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, bronversie, dat wil gezegd PostgreSQL-versie >= 9.5, serverparametercontrole, dat wil gezegd, 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.

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.
• WaitingForUserAction: alleen van toepassing voor onlinemigratie. Wacht totdat de actie van de gebruiker cutover uitvoert.

Mogelijke migratiesubstates zijn:

• PerformingPreRequisiteSteps: De installatie van de infrastructuur 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.
• Mislukt: migratie is mislukt.

Mogelijke validatiesubstates zijn:

• Mislukt: validatie is mislukt.
• Geslaagd: validatie is geslaagd.
• Waarschuwing: validatie bevindt zich in Waarschuwing. Waarschuwingen zijn informatieve berichten die u moet onthouden tijdens het plannen van de migratie.

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.

Als u wilt migreren met behulp van Azure CLI, moet u de Azure CLI installeren op uw lokale computer.

Azure CLI instellen voor migratieservice in Azure Database for PostgreSQL - Flexibele server

• Installeer de Azure CLI, afhankelijk van het besturingssysteem om de CLI-opdrachten uit te voeren.
• Azure CLI kan worden geïnstalleerd vanuit : De Azure CLI installeren.
• Als Azure CLI al is geïnstalleerd, controleert u de versie door de opdracht az version uit te geven. De versie moet ten minste 2.56.0 of hoger zijn om de migratieservice te gebruiken.
• Nadat de installatie is uitgevoerd, voert u de opdracht az sign in uit. Hiermee opent u de standaardbrowser en laadt u een Azure-aanmeldingspagina om te verifiëren. Geef uw Azure-referenties door om een geslaagde verificatie uit te voeren. Ga naar deze koppeling voor andere manieren om u aan te melden met Azure CLI.

CLI-opdrachten instellen voor de migratieservice

Alle CLI-opdrachten beginnen met az postgres flexible-server migration. Er zijn ook help-instructies die u helpen bij het begrijpen van de verschillende opties en het inlijsten van de juiste syntaxis voor de CLI-opdrachten.

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

Voorbeeld met Windows-opdrachtprompt: az login.

Opdrachten voor gebruik met de migratieservice

De migratieservice biedt de volgende opdrachten om u te helpen bij het migreren van uw PostgreSQL-databases naar Azure Database for PostgreSQL - Flexible Server.

De Help-opdracht

De opdracht az postgres flexible-server migration –-help bevat de naam en de bijbehorende werkwoorden.

De opdracht maken

Met de opdracht maken kunt u migreren van een bronserver naar een doelserver.

Met de Help-opdracht kunnen gebruikers de verschillende argumenten begrijpen die worden gebruikt voor het maken en initiëren van de migratie az postgres flexible-server migration create --help.

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

Er zijn verschillende substatesstroom wanneer de opdracht maken wordt geactiveerd.

• De migratie wordt verplaatst naar de status InProgress en de substate PerformingPreRequisiteSteps.

• Nadat de substatus PerformingPreRequisiteSteps is voltooid, wordt de migratie verplaatst naar de substatus van De migratie van gegevens, waar het klonen/kopiëren van de databases plaatsvindt.

• Elke gemigreerde database heeft de sectie met alle migratiedetails, zoals het aantal tabellen, incrementele invoegingen, verwijderingen en wachtende bytes.

• De tijd die nodig is om de substaat Gegevens migreren te voltooien, is afhankelijk van de grootte van de databases die worden gemigreerd.

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

Laten we de details begrijpen van elke parameter die wordt gebruikt in de opdracht maken.

Parameternaam	Beschrijving
subscription	Abonnements-id van PostgreSQL Flexibele server
resource-group	Resourcegroep van PostgreSQL Flexibele server
name	Naam van de Flexibele PostgreSQL-server
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.
migration-option	Hiermee kunt u validaties uitvoeren voordat u een migratie activeert. De standaardwaarde is ValidateAndMigrate. Toegestane waarden zijn: Migreren, Valideren, ValidateAndMigrate.
properties	Absoluut pad naar een JSON-bestand met de informatie over de bronserver

U moet een JSON-bestand opgeven met het absolute pad als parameter tijdens het initiëren van de migratie.

Het JSON-bestand bevat de volgende informatie:

Eigenschapsnaam	Beschrijving
sourceDbServerResourceId	Details van de bronserver in de indeling voor on-premises, virtuele Azure-machines (VM's), AWS - <<hostname or IP address>>:<<port>>@<<username>>
AdminCredentials	Deze parameter bevat wachtwoorden voor beheerdersgebruikers voor zowel de bronserver als de doelpostgreSQL flexibele server. Deze wachtwoorden helpen bij het verifiëren van de bron- en doelservers
targetServerUserName	De standaardwaarde is de beheerder die is gemaakt tijdens het maken van de 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 voor migratie. Deze gebruiker moet lid zijn van azure_pg_admin, pg_read_all_settings, pg_read_all_stats en pg_stat_scan_tables rollen en moet de rol Maken hebben, DB-kenmerken maken
dbsToMigrate	Geef de lijst op met databases die u wilt migreren naar Flexible Server. U kunt maximaal acht databasenamen tegelijk opnemen. De lijst met DB's opgegeven in matrixindeling.
OverwriteDBsInTarget	Als deze optie is ingesteld op true (standaard), als de doelserver een bestaande database heeft met dezelfde naam als de database die u wilt migreren, overschrijft het migratieprogramma de database automatisch
MigrationMode	Modus van de migratie. De ondersteunde waarde is 'Offline'
sourceType	Vereiste parameter. Waarden kunnen zijn: OnPremises, AWS, AzureVM, PostgreSQLSingleServer
sslMode	SSL-modi voor migratie. DE SSL-modus voor PostgreSQLSingleServer is VerifyFull en Vereist voor andere brontypen

De lijstopdracht

De lijstopdracht bevat alle migratiepogingen die zijn uitgevoerd naar een Azure Database for PostgreSQL-doel.

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

Parameternaam	Beschrijving
subscription	Abonnements-id van PostgreSQL Flexible-serverdoel
resource-group	Resourcegroep van PostgreSQL Flexible Server-doel
name	Naam van het PostgreSQL Flexible-serverdoel
filter	Voor het filteren van migraties worden twee waarden ondersteund: Actief en Alle

De opdracht Show

Met de opdracht Show kunt u lopende migraties bewaken en krijgt u 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]

Parameternaam	Beschrijving
subscription	Abonnements-id van PostgreSQL Flexible-serverdoel
resource-group	Resourcegroep van PostgreSQL Flexible Server-doel
name	Naam van het PostgreSQL Flexible-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.

Verschillende statussen die worden ondersteund in de opdracht Show

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
WaitingForUserAction	Alleen van toepassing op onlinemigratie. Wachten op actie van de gebruiker om cutover uit te voeren
ValidationFailed	De validatie op database- of serverniveau is mislukt

Verschillende substatussen die worden ondersteund in de showopdracht voor migratie

Migratiesubstate	Beschrijving
PerformingPreRequisiteSteps	Infrastructuur is ingesteld en wordt voorbereid voor gegevensmigratie
MigratingData	Gegevensmigratie wordt uitgevoerd
Completed	Migratie is voltooid
Failed	Migratie is mislukt
Validation in Progress	Validatie wordt uitgevoerd
CompletingMigration	Migratie bevindt zich in de laatste fasen van voltooiing

Validatiedetails bevinden zich op exemplaar- en databaseniveau

• Validatie op exemplaarniveau

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

• Validatie op databaseniveau

  • Bevat validatie van de afzonderlijke databases met betrekking tot extensies, sorteringsondersteuning in Azure Database for PostgreSQL - flexibele server.

Verschillende substatussen die worden ondersteund in de showopdracht voor validatie.

Validatiesubstate	Beschrijving
Failed	Validatie is mislukt
Succeeded	Validatie is geslaagd
Warning	Validatie bevindt zich in Waarschuwing. Waarschuwingen zijn informatieve berichten die u moet onthouden tijdens het plannen van de migratie

De migratie annuleren

U kunt lopende migratiepogingen annuleren met behulp van de cancel opdracht. Met deze opdracht wordt de specifieke migratiepoging gestopt, maar worden wijzigingen op de doelserver niet verwijderd of 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

Verbinding maken naar de bron

• Voor deze zelfstudie migreren we 'ticketdb', 'inventorydb' en 'timedb' naar een flexibele Azure Database for PostgreSQL-server.

Migratie uitvoeren met CLI

• Open de opdrachtprompt en meld u aan bij Azure met behulp van de az login opdracht

  

• 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 like - "ticketdb","timedb","inventorydb">>"
        ],
        "OverwriteDBsInTarget": "true",
        "MigrationMode": "Offline",
        "sourceType": "AWS",
        "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 <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible  Server>> --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 <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --migration-name <<Unique Migration Name>> --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 <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --migration-name <<Migration ID>>
  

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

  

• U kunt ook de status van de flexibele PostgreSQL-serverportal bekijken in de Azure Database.

  

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 on-premises en Azure-VM's
• Aanbevolen procedures
• Bekende problemen en beperkingen
• Netwerkinstallatie
• premigratievalidaties