Dela via

Så här konfigurerar du Azure CLI för migreringstjänsten i Azure Database for PostgreSQL – flexibel server

Azure CLI är en uppsättning kommandon som används i Azure-tjänster för att skapa och hantera resurser. Den har samma funktioner som Azure Portal men är optimerad för användare som föredrar att arbeta i en kommandoradsmiljö. Om du vill börja migrera med Azure CLI måste du installera Azure CLI på den lokala datorn.

Förutsättningar

  • Installera Azure CLI: Beroende på ditt operativsystem laddar du ned och installerar Azure CLI. Den är tillgänglig för Windows, macOS och Linux.

  • Installationsguide för Azure CLI: Följ anvisningarna i den officiella Azure-dokumentationen för att installera Azure CLI – Installera Azure CLI.

  • Kontrollera Azure CLI-versionen: Kontrollera att din Azure CLI-version är minst 2.56.0 eller senare, eftersom detta krävs för migreringstjänsten. Använd kommandot az --version för att kontrollera din aktuella version.

  • Logga in på Azure: Kör efter installationen az login för att autentisera. Då öppnas standardwebbläsaren för att slutföra inloggningsprocessen med dina Azure-autentiseringsuppgifter.

De här stegen förbereder din miljö för att använda Azure CLI för att hantera migreringstjänsten i Azure Database for PostgreSQL effektivt. Se alltid den senaste Azure-dokumentationen för uppdateringar eller ändringar i installationsprocessen.

Konfigurera CLI-kommandon för migreringstjänsten

Alla CLI-kommandon börjar med az postgres flexible-server migration. Det finns också hjälpinstruktioner som hjälper dig att förstå de olika alternativen och utforma rätt syntax för CLI-kommandona.

Steg för att konfigurera CLI-kommandon

  1. Installera Azure CLI: Följ anvisningarna i den officiella Azure-dokumentationen för att installera Azure CLI – Så här installerar du Azure CLI.

  2. Kontrollera Azure CLI-versionen: Kontrollera att din Azure CLI-version är minst 2.56.0 eller senare. Använd kommandot az --version för att kontrollera din aktuella version.

  3. Logga in på Azure: Kör efter installationen az login för att autentisera. Då öppnas standardwebbläsaren för att slutföra inloggningsprocessen med dina Azure-autentiseringsuppgifter.

När CLI har installerats öppnar du kommandotolken och loggar in på Azure-kontot med hjälp av följande kommando.

az login

Migrera kommandon

Migreringstjänsten tillhandahåller följande kommandon som hjälper dig att migrera dina PostgreSQL-instanser till en flexibel Azure Database for PostgreSQL-server.

Hjälpkommando

Kommandot --help i Azure CLI är ett värdefullt alternativ som innehåller detaljerad dokumentation om kommandona och deras underkommandon, inklusive nödvändiga verb för åtgärder. Kommandot –-helpvisar nödvändiga kommandon och deras associerade åtgärder för migreringstjänsten i Azure Database for PostgreSQL.

az postgres flexible-server migration –-help

Utdata vägleder dig genom de steg och parametrar som krävs för att hantera dina databasmigreringar effektivt med hjälp av Azure CLI.

Skapa kommando

Kommandot az postgres flexible-server migration create i Azure CLI används för att initiera ett nytt migreringsarbetsflöde. Det underlättar migreringen av databaser från en PostgreSQL-källinstans till en Azure Database for PostgreSQL-instans för flexibel server. Det här kommandot konfigurerar nödvändiga parametrar och konfigurationer för att säkerställa en smidig och effektiv migreringsprocess.

Mer information finns i az postgres flexible-server migration create

Listkommando

Kommandot az postgres flexible-server migration list används för att lista alla migreringsförsök som görs till ett Azure Database for PostgreSQL-mål. Det här kommandot ger en översikt över de migreringar som initierades, så att du kan spåra status och information om varje migreringsförsök.

Mer information finns i az postgres flexible-server migration list

Visa kommando

Kommandot az postgres flexible-server migration show hjälper dig att övervaka pågående migreringar och ger migreringens aktuella tillstånd och undertillstånd. Den här informationen innehåller information om migreringens aktuella tillstånd och undertillstånd.

Mer information finns i az postgres flexible-server migration show

Några möjliga migreringstillstånd:

Migreringstillstånd

Stat/län beskrivning
InProgress Installationen av migreringsinfrastrukturen pågår eller så pågår den faktiska datamigreringen.
Avbruten Migreringen avbryts eller tas bort.
Misslyckades Migreringen misslyckades.
Verifieringen misslyckades Verifieringen misslyckades.
Lyckades Migreringen lyckades och är klar.
WaitingForUserAction Gäller endast för onlinemigrering. Väntar på att användaråtgärden ska utföra snabb användning.

Undertillstånd för migrering

Undertillstånd beskrivning
PerformingPreRequisiteSteps Infrastrukturkonfiguration pågår för datamigrering.
Validering pågår Verifiering pågår.
MigreraData Datamigrering pågår.
Slutföra migrering Migreringen är i slutfasen av slutförandet.
Slutförd Migreringen är klar.
Misslyckades Migreringen misslyckades.

Undertillstånd för validering

Undertillstånd beskrivning
Misslyckades Verifieringen misslyckades.
Lyckades Valideringen har slutförts.
Varning! Verifieringen är i varningstext.

Kommandot Uppdatera

Kommandot az postgres flexible-server migration update används för att hantera migreringsprocessen till en flexibel Azure Database for PostgreSQL-server. Mer specifikt kan det användas för att:

  • Utför en snabb åtgärd: Detta slutför migreringsprocessen genom att växla databastrafiken från källservern till den flexibla målservern.

    • När basdatamigreringen är klar flyttas migreringsuppgiften till undertillståndet WaitingForCutoverTrigger . I det här tillståndet kan användarna utlösa snabbkopplingen från portalen genom att välja migreringsnamnet i migreringsrutnätet eller via CLI.
    • Innan du påbörjar cutover är det viktigt att se till att:
      • Skrivningar till källan stoppas
      • latency värdet minskar till 0 eller nära 0
      • latency värdet anger när målet senast synkroniserades med källan. Nu kan skrivningar till källan stoppas och snabbinitieras. Om det finns tung trafik vid källan bör du först stoppa skrivningar så att Latency kan komma nära 0, och sedan initieras en övergång.
      • Snabbåtgärden tillämpar alla väntande ändringar från källan till målet och slutför migreringen. Om du utlöser en "cutover" även med nonzero Latencystoppas replikeringen till den tidpunkten. Alla data på källan tills brytpunkten sedan tillämpas på målet. Anta att svarstiden var 15 minuter vid snabbpunkten, så alla ändrade data under de senaste 15 minuterna gäller för målet.

  • Avbryt migreringen: Om det behövs kan du stoppa migreringsprocessen med det här alternativet.

  • Konfigurera logisk replikering vid källan: Detta är användbart när källservern är en Azure Database for PostgreSQL – enskild server, eftersom den förbereder servern för datareplikering till den flexibla servern.

Mer information finns i az postgres flexible-server migration update

Sammanfattning

I följande tabell sammanfattas de parametrar som används av migreringskommandona:

Parameter Relevanta kommandon beskrivning
subscription skapa, lista, visa, uppdatera Prenumerations-ID för Flexibel PostgreSQL-server
resource-group skapa, lista, visa, uppdatera Resursgrupp för Flexibel PostgreSQL-server
name skapa, lista, visa Namn på PostgreSQL – flexibel server
migration-name skapa, visa, uppdatera Unik identifierare för migreringar som har försökt till en flexibel server. Det här fältet accepterar endast alfanumeriska tecken och accepterar inte några specialtecken förutom ett bindestreck (-). Namnet kan inte börja med - och inte två migreringar till en flexibel serverdestination kan ha samma namn.
filter lista För att filtrera migreringar stöds två värden – Aktiv och Alla
help skapa, lista, visa, uppdatera Innehåller information om varje kommando.
migration-mode skapa Det här är en valfri parameter. Tillåtna värden är – offline, online. Standardvärde: Offline.
migration-option skapa Gör att du kan utföra valideringar innan du utlöser en migrering. Standardvärdet är ValidateAndMigrate. Tillåtna värden är – Migrera, Verifiera, ValideraOchMigrera.
properties skapa Absolut sökväg till en JSON-fil som har information om källan, målservern, databaser som ska migreras, SSL-lägen, definiera källtyper

Information om JSON-filen

Kommandot az postgres flexible-server migration create kräver en JSON-filsökväg som en del av --properties parametern, som innehåller konfigurationsinformation för migreringen, till exempel källdatabasserverns resurs-ID, administratörsautentiseringsuppgifter, databaser som ska migreras och andra viktiga inställningar. Följande är de olika egenskaperna:

Egenskapsnamn beskrivning
sourceDbServerResourceId Källserverinformation i formatet för lokala, virtuella datorer (VM), molnbaserad PostgreSQL-tjänst – <<hostname or IP address>>:<<port>>@<<username>>. Om källservern är Azure Database for PostgreSQL – enskild server är resurs-ID:t i formatet - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Den här parametern visar lösenord för administratörsanvändare för både källservern och postgreSQL-målservern. Dessa lösenord hjälper till att autentisera mot käll- och målservrarna. Den innehåller två underegenskaper och sourceServerPasswordtargetServerPassword
targetServerUserName Standardvärdet är den administratörsanvändare som skapades när postgreSQL-målservern skapades och lösenordet som angavs används för autentisering mot den här användaren.
dbsToMigrate Ange listan över databaser som du vill migrera till en flexibel server. Du kan inkludera högst åtta databasnamn åt gången. Ange listan över databaser i matrisformat.
overwriteDBsInTarget Om värdet är true (standard) skriver migreringstjänsten automatiskt över databasen om målservern råkar ha en befintlig databas med samma namn som den som du försöker migrera.
migrationRuntimeResourceId Krävs om en körningsserver behöver användas för migrering. Formatet är - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL flexible server name>>
sourceDBServerFullyQualifiedDomainName Krävs endast om källan är en enskild server och finns bakom en anpassad DNS-server, anpassade DNS-namnområden, anpassat FQDN eller måste vara tillgänglig via IP.
targetDBServerFullyQualifiedDomainName Krävs endast om målet ligger bakom en anpassad DNS-server, anpassade DNS-namnområden, anpassat FQDN eller behöver vara tillgängligt via IP.
sourceType Obligatorisk parameter. Värden kan vara – lokalt, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode SSL-lägen för migrering. SSL-läget för PostgreSQLSingleServer är VerifyFull och Prefer/Require för andra källtyper.

Relaterat innehåll