Dela via

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

  • Artikel

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.

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

az login

Migrera kommandon

Migreringstjänsten innehåller följande kommandon som hjälper dig att migrera dina PostgreSQL-instanser till Azure Database for PostgreSQL – flexibel 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-målinstans – 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 har initierats, 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 har slutförts.
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 har slutförts.
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 rekommenderar vi att du stoppar skrivningar först så att du Latency kan komma nära 0 och sedan initieras en snabb användning.
      • 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 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 inga två migreringar till ett mål för flexibel server 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. Nedan visas 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 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>>
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