Delen via

Azure CLI instellen voor migratieservice in Azure Database for PostgreSQL flexibele server

De Azure CLI is een set opdrachten die worden gebruikt in Azure-services voor het maken en beheren van resources. Het biedt dezelfde mogelijkheden als Azure Portal, maar is geoptimaliseerd voor gebruikers die liever in een opdrachtregelomgeving werken. Als u wilt migreren met behulp van Azure CLI, moet u de Azure CLI installeren op uw lokale computer.

Vereisten

  • Azure CLI installeren: afhankelijk van uw besturingssysteem downloadt en installeert u de Azure CLI. Deze is beschikbaar voor Windows, macOS en Linux.

  • Installatiehandleiding voor Azure CLI: volg de instructies in de officiële Azure-documentatie voor het installeren van de Azure CLI: de Azure CLI installeren.

  • Controleer de Azure CLI-versie: zorg ervoor dat uw Azure CLI-versie ten minste 2.56.0 of hoger is, omdat dit vereist is voor de migratieservice. Gebruik de opdracht az --version om uw huidige versie te controleren.

  • Meld u aan bij Azure: Voer na de installatie uit az login om te verifiëren. Hiermee opent u uw standaardbrowser om het aanmeldingsproces met uw Azure-referenties te voltooien.

Met deze stappen bereidt u uw omgeving voor op het gebruik van de Azure CLI om de migratieservice in Azure Database for PostgreSQL effectief te beheren. Raadpleeg altijd de meest recente Azure-documentatie voor updates of wijzigingen in het installatieproces.

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.

Stappen voor het instellen van CLI-opdrachten

  1. Azure CLI installeren: volg de instructies in de officiële Azure-documentatie om de Azure CLI te installeren: de Azure CLI installeren.

  2. Controleer de Azure CLI-versie: zorg ervoor dat uw Azure CLI-versie ten minste 2.56.0 of hoger is. Gebruik de opdracht az --version om uw huidige versie te controleren.

  3. Meld u aan bij Azure: Voer na de installatie uit az login om te verifiëren. Hiermee opent u uw standaardbrowser om het aanmeldingsproces met uw Azure-referenties te voltooien.

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

az login

Opdrachten migreren

De migratieservice biedt de volgende opdrachten om u te helpen bij het migreren van uw PostgreSQL-exemplaren naar een flexibele Azure Database for PostgreSQL-server.

Help-opdracht

De --help opdracht in Azure CLI is een waardevolle optie die gedetailleerde documentatie biedt over de opdrachten en de bijbehorende subopdrachten, inclusief de vereiste werkwoorden voor bewerkingen. Met –-helpde opdracht worden de benodigde opdrachten en de bijbehorende acties voor de migratieservice in Azure Database for PostgreSQL weergegeven.

az postgres flexible-server migration –-help

De uitvoer begeleidt u bij de benodigde stappen en parameters die nodig zijn om uw databasemigraties effectief te beheren met behulp van de Azure CLI.

Opdracht Maken

De az postgres flexible-server migration create opdracht in Azure CLI wordt gebruikt om een nieuwe migratiewerkstroom te starten. Het maakt de migratie van databases eenvoudiger van een PostgreSQL-broninstantie naar een doelinstantie van Azure Database voor PostgreSQL Flexibele Server. Met deze opdracht stelt u de benodigde parameters en configuraties in om een soepel en efficiënt migratieproces te garanderen.

Zie az postgres flexible-server migration create voor meer informatie

Opdracht Lijst

De az postgres flexible-server migration list opdracht wordt gebruikt om alle migratiepogingen weer te geven die zijn uitgevoerd naar een Azure Database for PostgreSQL-doel. Deze opdracht biedt een overzicht van de migraties die zijn gestart, zodat u de status en details van elke migratiepoging kunt bijhouden.

Zie az postgres flexible-server migration list (Az postgres flexible-server migration list) voor meer informatie

Opdracht Weergeven

De az postgres flexible-server migration 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.

Zie az postgres flexible-server migration show (Az postgres flexible-server migration show) voor meer informatie

Enkele mogelijke migratiestatussen:

Migratiestatussen

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

Migratiesubstates

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

Validatiesubstates

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

Opdracht Bijwerken

De az postgres flexible-server migration update opdracht wordt gebruikt voor het beheren van het migratieproces naar een flexibele Azure Database for PostgreSQL-server. Het kan met name worden gebruikt voor het volgende:

  • Een cutover uitvoeren: hiermee wordt het migratieproces voltooid door het databaseverkeer van de bronserver over te schakelen naar de flexibele doelserver.

    • Nadat de basisgegevensmigratie is voltooid, wordt de migratietaak verplaatst naar de WaitingForCutoverTrigger substatus. In deze status kunnen gebruikers de cutover activeren vanuit de portal door de migratienaam in het migratieraster of via de CLI te selecteren.
    • Voordat u cutover start, is het belangrijk om ervoor te zorgen dat:
      • Schrijfbewerkingen naar de bron worden gestopt
      • latency de waarde afneemt tot 0 of dicht bij 0
      • latency waarde geeft aan wanneer het doel voor het laatst is gesynchroniseerd met de bron. Op dit moment kunnen schrijfbewerkingen naar de bron worden gestopt en cutover geïnitieerd. Als er veel verkeer bij de bron is, moet u eerst schrijfbewerkingen stoppen, zodat deze Latency dicht bij 0 kunnen komen en er vervolgens een cutover wordt gestart.
      • De cutover-bewerking past alle wijzigingen in behandeling van de bron toe op het doel en voltooit de migratie. 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 vervolgens op het doel wordt toegepast. Stel dat een latentie 15 minuten was op het cutover-punt, zodat alle gewijzigde gegevens in de afgelopen 15 minuten van toepassing zijn op het doel.

  • De migratie annuleren: indien nodig kunt u met deze optie het migratieproces stoppen.

  • Logische replicatie instellen bij de bron: dit is handig wanneer de bronserver een Azure Database for PostgreSQL - Enkele server is, omdat deze de server voorbereidt op gegevensreplicatie naar de flexibele server.

Zie az postgres flexible-server migration update (Az postgres flexible-server migration update) voor meer informatie

Samenvatting

De volgende tabel bevat een overzicht van de parameters die worden gebruikt door de migratieopdrachten:

Parameter Relevante opdrachten Beschrijving
subscription maken, weergeven, bijwerken Abonnements-id van PostgreSQL Flexibele server
resource-group maken, weergeven, bijwerken Resourcegroep van PostgreSQL Flexibele server
name maken, weergeven, weergeven Naam van de Flexibele PostgreSQL-server
migration-name maken, weergeven, bijwerken Er is een unieke id voor migraties geprobeerd om een flexibele server te maken. 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 flexibele serverdoel dezelfde naam hebben.
filter lijst Voor het filteren van migraties worden twee waarden ondersteund: Actief en Alle
help maken, weergeven, bijwerken Bevat informatie over elke opdracht.
migration-mode maken Dit is een optionele parameter. Toegestane waarden zijn : offline, online. Standaardwaarde: Offline.
migration-option maken Hiermee kunt u validaties uitvoeren voordat u een migratie activeert. De standaardwaarde is ValidateAndMigrate. Toegestane waarden zijn: Migreren, Valideren, ValidateAndMigrate.
properties maken Absoluut pad naar een JSON-bestand met de informatie over de bron, doelserver, databases die moeten worden gemigreerd, SSL-modi, brontypen definiëren

Details van het JSON-bestand

Voor az postgres flexible-server migration create de opdracht is een JSON-bestandspad vereist als onderdeel van --properties de parameter, die configuratiegegevens voor de migratie bevat, zoals de brondatabaseserverresource-id, beheerdersreferenties, databases die moeten worden gemigreerd en andere belangrijke instellingen. Hier volgen de verschillende eigenschappen:

Eigenschapsnaam Beschrijving
sourceDbServerResourceId Bronserverdetails in de indeling voor on-premises, virtuele machines (VM's), cloudgebaseerde PostgreSQL-service - <<hostname or IP address>>:<<port>>@<<username>>. Als de bronserver Azure Database for PostgreSQL - Enkele server is, heeft de resource-id de indeling - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Deze parameter bevat wachtwoorden voor beheerdersgebruikers voor zowel de bronserver als de doelpostgreSQL flexibele server. Deze wachtwoorden helpen bij het verifiëren bij de bron- en doelservers. Het omvat twee subproperties en sourceServerPasswordtargetServerPassword
targetServerUserName De standaardwaarde is de gebruiker met beheerdersrechten die is gemaakt tijdens het maken van de flexibele PostgreSQL-doelserver en het opgegeven wachtwoord wordt gebruikt voor verificatie voor deze gebruiker.
dbsToMigrate Geef de lijst op met databases die u wilt migreren naar een flexibele server. U kunt maximaal acht databasenamen tegelijk opnemen. Geef de lijst met databases op in matrixindeling.
overwriteDBsInTarget Als deze is ingesteld op true (standaard), als de doelserver een bestaande database heeft met dezelfde naam als de database die u probeert te migreren, overschrijft de migratieservice de database automatisch
migrationRuntimeResourceId Vereist als een runtimeserver moet worden gebruikt voor migratie. De notatie is - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL flexible server name>>
sourceDBServerFullyQualifiedDomainName Alleen vereist als de bron een enkele server is en zich achter een aangepaste DNS-server, aangepaste DNS-naamruimten, aangepaste FQDN bevindt of toegankelijk moet zijn via IP.
targetDBServerFullyQualifiedDomainName Alleen vereist als het doel zich achter een aangepaste DNS-server bevindt, aangepaste DNS-naamruimten, aangepaste FQDN's of toegankelijk moet zijn via IP.
sourceType Vereiste parameter. Waarden kunnen zijn: on-premises, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode SSL-modi voor migratie. De SSL-modus voor PostgreSQLSingleServer is VerifyFull and Prefer/Require voor andere brontypen.

Gerelateerde inhoud