Självstudie: Migrera från Azure Database for PostgreSQL – enskild server till flexibel server med migreringstjänsten

GÄLLER FÖR: Azure Database for PostgreSQL – flexibel server

Med hjälp av Azure Portal kan du migrera en instans av Azure Database for PostgreSQL – enskild server till Azure Database for PostgreSQL – flexibel server. I den här självstudien utför vi migrering av en exempeldatabas från en enskild Azure Database for PostgreSQL-server till en flexibel PostgreSQL-server med hjälp av Azure Portal.

• Konfigurera din flexibla Azure Database for PostgreSQL-server
• Konfigurera migreringsuppgiften
• Övervaka migreringen
• Avbryt migreringen
• Efter migrering

Portal

Du kan migrera med hjälp av Azure Portal.

Offline

Förutsättningar (offline)

Innan du påbörjar migreringen med migreringstjänsten i Azure Database for PostgreSQL måste du uppfylla följande krav, som gäller för offlinemigreringsscenarier.

Verifiera källversionen

PostgreSQL-källversionen ska vara >= 9.5. Om postgreSQL-källversionen är mindre än 9.5uppgraderar du PostgreSQL-källversionen till 9.5 eller högre före migreringen.

Målkonfiguration

• Azure Database for PostgreSQL – flexibel server måste distribueras och konfigureras korrekt i Azure innan du påbörjar migreringsprocessen.

• Den SKU som valts för Azure Database for PostgreSQL ska motsvara specifikationerna för källdatabasen för att säkerställa kompatibilitet och tillräcklig prestanda.

• Detaljerade anvisningar om hur du skapar en ny Azure Database for PostgreSQL finns i följande länk: Snabbstart: Skapa server.

Nätverkskonfiguration

Nätverkskonfigurationen är avgörande för att migreringstjänsten ska fungera korrekt. Se till att PostgreSQL-källservern kan kommunicera med Azure Database for PostgreSQL-målservern. Följande nätverkskonfigurationer är viktiga för en lyckad migrering.

Information om nätverkskonfiguration finns i Nätverksguide för migreringstjänsten.

Aktivera tillägg

För att säkerställa en lyckad migrering med hjälp av migreringstjänsten i Azure Database for PostgreSQL kan du behöva verifiera tillägg till postgreSQL-källinstansen. Tillägg innehåller funktioner och funktioner som kan krävas för ditt program. Kontrollera att du verifierar tilläggen på PostgreSQL-källinstansen innan du påbörjar migreringsprocessen.

I målinstansen av Azure Database for PostgreSQL – flexibel server aktiverar du tillägg som stöds som identifieras i postgreSQL-källinstansen.

Mer information finns i Tillägg i Azure Database for PostgreSQL.

Kommentar

En omstart krävs när du gör ändringar i parametern shared_preload_libraries .

Kontrollera serverparametrarna

Dessa parametrar migreras inte automatiskt till målmiljön och måste konfigureras manuellt.

• Matcha serverparametervärden från PostgreSQL-källdatabasen till Azure Database for PostgreSQL genom att komma åt avsnittet Serverparametrar i Azure Portal och uppdatera värdena manuellt.

• Spara parameterändringarna och starta om den flexibla servern Azure Database for PostgreSQL om du vill tillämpa den nya konfigurationen.

Viktigt!

Ändra password_encryption-serverparametern på den flexibla servern från SCRAM-SHA-256 till MD5 innan du initierar migreringen. Detta är viktigt för att befintliga autentiseringsuppgifter på en enskild server ska fungera på din flexibla server.

Inaktivera hög tillgänglighet (tillförlitlighet) och läsrepliker i målet

• Det är viktigt att inaktivera hög tillgänglighet (tillförlitlighet) och läsrepliker i målmiljön. Dessa funktioner bör aktiveras först när migreringen har slutförts.

• Genom att följa dessa riktlinjer kan du säkerställa en smidig migreringsprocess utan de tillagda variablerna som introduceras med hög tillgänglighet och läsrepliker. När migreringen är klar och databasen är stabil kan du fortsätta med att aktivera dessa funktioner för att förbättra tillgängligheten och skalbarheten för databasmiljön i Azure.

Konfigurera din flexibla Azure Database for PostgreSQL-server

• Skapa den flexibla målservern. Guidade steg finns i snabbstarten Skapa en flexibel Azure Database for PostgreSQL-server med hjälp av portalen.

• Tillåtlistetillägg vars bibliotek måste läsas in vid serverstart. Det är viktigt att tillägget finns på listan över tillåtna innan du påbörjar en migrering.

• Kontrollera om datafördelningen mellan en databas tabeller är skev, med de flesta av de data som finns i en enda (eller några) tabeller. Om den är skev kan migreringshastigheten vara långsammare än förväntat. I det här fallet kan migreringshastigheten ökas genom att den stora tabellen migreras parallellt.

Konfigurera migreringsuppgiften

Migreringstjänsten har en enkel, guidebaserad upplevelse av Azure Portal. Så här börjar du:

1. Öppna webbläsaren och gå till portalen. Om du vill logga in anger du dina autentiseringsuppgifter. Standardvyn är instrumentpanelen.

2. Gå till ditt Azure Database for PostgreSQL–mål för flexibel server.

3. På fliken Översikt på den flexibla servern rullar du ned till Migrering på den vänstra menyn och väljer den.

   

4. Välj knappen Skapa för att starta en migrering från en enskild server till en flexibel server. Om det här är första gången du använder migreringstjänsten visas ett tomt rutnät med en uppmaning om att påbörja din första migrering.

   

   Om du redan har skapat migreringar till ditt mål för flexibel server innehåller rutnätet information om migreringar som har försökt nå det här målet från den enskilda servern.

5. Du går igenom en guidebaserad serie flikar för att skapa en migrering till det här flexibla servermålet från olika möjliga källor. Som standard är källservertypen inställd på Azure Database for PostgreSQL – enskild server, vilket är den som vi är intresserade av för det här scenariot.

Du kan också initiera migreringsprocessen från Azure Database for PostgreSQL – enskild server.

1. Öppna webbläsaren och gå till portalen. Om du vill logga in måste du ange dina autentiseringsuppgifter. Standardvyn är instrumentpanelen.

2. När du väljer enskild server kan du se en migreringsrelaterad banderoll på fliken Översikt. Välj Migrera nu för att komma igång.

   

3. Du tas till en sida med två alternativ. Om du redan har skapat en flexibel server och vill använda den som mål väljer du Välj befintlig och väljer motsvarande information om prenumeration, resursgrupp och servernamn . När valen har gjorts väljer du Gå till migreringsguiden och följer anvisningarna i avsnittet Installation .

   

4. Om du väljer att skapa en ny flexibel server väljer du Skapa ny och väljer Gå för att skapa guiden. Den här åtgärden tar dig genom processen för att skapa flexibel server och distribuerar den flexibla servern.

   

När du har distribuerat den flexibla servern följer du stegen 3 till 5 under Konfigurera migreringsuppgiften.

Ställ in

Den första fliken är Installation. Om du missade det tillåter du nödvändiga tillägg enligt beskrivningen i Konfigurera din flexibla Azure Database for PostgreSQL-server innan du påbörjar en migrering.

Migreringsnamnet är den unika identifieraren för varje migrering till det här målet för flexibel server. Det här fältet accepterar endast alfanumeriska tecken och accepterar inga specialtecken förutom understreck (_) och bindestreck (-). Namnet måste börja med ett alfanumeriskt tecken. Namnet måste också vara unikt för en målserver, eftersom inga två migreringar till samma mål för flexibel server kan ha samma namn.

Källservertypen anger källan. I det här fallet är det Azure Database for PostgreSQL – enskild server

Med migreringsalternativet kan du utföra valideringar innan du utlöser en migrering. Du kan välja något av följande alternativ.

• Verifiera – Kontrollerar serverns och databasens beredskap för migrering till målet.
• Migrera – Hoppar över valideringar och startar migreringen.
• Verifiera och migrera – Utför validering innan en migrering utlöses. Migreringen utlöses endast om det inte finns några valideringsfel.

Det är alltid en bra idé att välja alternativet Verifiera eller verifiera och migrera för att utföra valideringar före migreringen innan du kör migreringen.

Med migreringsläget kan du välja mellan en onlinemigrering och en offlinemigrering, i det här fallet måste den vara inställd på Offline.

Välj knappen Nästa: Välj Körningsserver.

Runtime Server

Migreringskörningsservern är en specialiserad funktion inom migreringstjänsten i Azure Database for PostgreSQL, utformad för att fungera som mellanliggande server under migreringen. Det är en separat Azure Database for PostgreSQL – flexibel serverinstans som inte är målservern, men som används för att underlätta migreringen av databaser från en källmiljö som endast är tillgänglig via ett privat nätverk.

Mer information om Runtime Server finns på Migreringskörningsservern.

Välj knappen Nästa: Anslut till källa.

Ansluta till källan

I avsnittet Källa uppmanas du att ange information om den enskilda servern, som är källan till databaserna.

När du har valt Prenumeration och Resursgrupp visar listrutan för servernamn enskilda servrar under den resursgruppen mellan regioner. Välj den källa som du vill migrera databaser från. Du kan migrera databaser från en enskild server till en flexibel målserver i samma region. Migreringar mellan regioner är endast aktiverade för Servrar i Indien, Kina och Förenade Arabemiraten.

När du har valt enskild serverkälla fylls rutorna Plats och PostgreSQL-version i automatiskt. Kontrollera att du anger autentiseringsuppgifterna för en administratörsroll eftersom det krävs för att migreringstjänsten ska kunna migrera databaserna.

Det anpassade FQDN/IP-fältet är valfritt och kan användas när källan finns bakom en anpassad DNS-server eller har anpassade DNS-namnområden, vilket gör det endast tillgängligt via specifika FQDN eller IP-adresser. Detta kan till exempel innehålla poster som singleserver.example.com, 198.1.0.2eller ett PostgreSQL FQDN, singleserver.postgres.database.azure.comtill exempel , om den anpassade DNS-servern innehåller DNS-zonen postgres.database.azure.com eller vidarebefordrar frågor för den här zonen till 168.63.129.16, där FQDN löses i den offentliga eller privata DNS-zonen i Azure.

När du har fyllt i alla fält väljer du länken Anslut till källa . Detta verifierar att den angivna källserverinformationen är korrekt och att källservern kan nås.

Välj knappen Nästa: Välj migreringsmål för att fortsätta.

Välj migreringsmål

I avsnittet Välj migreringsmål visas metadata för målet flexibel server, till exempel Prenumeration, Resursgrupp, Servernamn, Plats och PostgreSQL-version.

Det anpassade FQDN/IP-fältet är valfritt och kan användas när målet ligger bakom en anpassad DNS-server eller har anpassade DNS-namnområden, vilket gör det endast tillgängligt via specifika FQDN eller IP-adresser. Detta kan till exempel innehålla poster som flexibleserver.example.com, 198.1.0.2eller ett PostgreSQL FQDN, flexibleserver.postgres.database.azure.comtill exempel , om den anpassade DNS-servern innehåller DNS-zonen postgres.database.azure.com eller vidarebefordrar frågor för den här zonen till 168.63.129.16, där FQDN löses i den offentliga eller privata DNS-zonen i Azure.

Välj lämpliga värden för autentiseringsmetod och alla autentiseringsrelaterade fält. Kontrollera att den angivna identiteten är administratörsanvändarens identitet på målservern. När du har fyllt i all nödvändig information väljer du länken Anslut till mål . Detta verifierar att den angivna målserverinformationen är korrekt och att målservern kan nås.

Välj knappen Nästa: Välj databaser för migrering för att välja de databaser som ska migreras.

Välj databaser för migrering

Under den här fliken finns en lista över användardatabaser i den enskilda servern. Du kan välja och migrera upp till åtta databaser i ett enda migreringsförsök. Om det finns fler än åtta användardatabaser upprepas migreringsprocessen mellan käll- och målservrarna för nästa uppsättning databaser. Valda databaser som finns på målservern med exakt samma namn skrivs över.

Välj knappen Nästa: Sammanfattning för att granska informationen.

Sammanfattning

Fliken Sammanfattning sammanfattar all information för att skapa verifieringen eller migreringen. Granska informationen och välj knappen Starta validering och migrering .

Övervaka migreringsportalen

När du har startat migreringen visas ett meddelande om att verifieringen eller migreringen har skapats. Du omdirigeras automatiskt till migreringssidan för flexibel server. Det här har en ny post för den nyligen skapade verifieringen eller migreringen.

Rutnätet som visar migreringarna har följande kolumner: Namn, Status, Migreringsläge, Migreringstyp, Källserver, Källservertyp, Databaser, Starttid och Varaktighet. Posterna visas i fallande ordning på starttiden med den senaste posten överst.

Du kan använda knappen Uppdatera för att uppdatera statusen för valideringen eller migreringen.

Du kan också välja namnet på en viss migrering i rutnätet för att se den associerade informationen.

När verifieringen eller migreringen skapas flyttas den till inprogresstillståndet och performingprerequisiteSteps-undertillståndet. Arbetsflödet tar 2–3 minuter att konfigurera migreringsinfrastrukturen och nätverksanslutningarna.

Låt oss titta på hur du övervakar migreringar för varje migreringsalternativ.

Validera

När undertillståndet PerformingPreRequisiteSteps har slutförts flyttas valideringen till undervärdet Validering pågår där kontroller görs på käll- och målservern för att utvärdera beredskapen för migrering.

Valideringen flyttas till tillståndet Lyckades om alla valideringar antingen är i tillståndet Lyckades eller Varning .

Verifieringsrutnätet har följande information:

• Verifieringsinformation för instans - och valideringsinformation för databasavsnitt, som representerar de verifieringsregler som används för att kontrollera migreringsberedskapen .
• Valideringsnamn – namnet på varje specifik verifieringsregel.
• Valideringsstatus – Representerar resultatet för varje regel och kan ha något av de tre värdena:
  • Lyckades – om inga fel hittades.
  • Misslyckades – om det finns valideringsfel.
  • Varning – Om det finns valideringsvarningar.
• Varaktighet – tidsåtgång för valideringsåtgärden.
• Starttid (UTC) och Sluttid (UTC) – Start- och sluttider för valideringsåtgärden i UTC.

Valideringsstatusen flyttas till Tillståndet Misslyckades om det finns fel i verifieringen. Välj valideringsnamnet eller verifieringen av databasnamn som har misslyckats, och ett fönster med utfällbara fönster innehåller information och den korrigerande åtgärd som du bör vidta för att undvika det här felet.

Migrera

När undertillståndet PerformingPreRequisiteSteps har slutförts flyttas migreringen till undertillståndet Migrera data när kloning/kopiering av databaserna sker. Hur lång tid migreringen ska slutföras beror på storleken och formen på de databaser som du migrerar. Migreringen går snabbt om data mestadels är jämnt fördelade över alla tabeller. Det tar relativt lång tid att använda sneda tabellstorlekar.

När du väljer någon av databaserna under migreringen visas en utspringad fönsterruta. Den har alla tabellantal (kopieras, köas, kopieras och fel) och även databasens migreringsstatus.

Migreringen flyttas till tillståndet Lyckades när tillståndet Migrera data har slutförts. Om det finns ett problem i tillståndet Migrera data flyttas migreringen till ett feltillstånd .

När migreringen övergår till tillståndet Lyckades är schema- och datamigreringen från din enskild server till målet för flexibel server klar. Du kan uppdatera sidan för att kontrollera förloppet.

Verifiera och migrera

I det här alternativet utförs valideringar först innan migreringen startar. När undertillståndet PerformingPreRequisiteSteps har slutförts flyttas arbetsflödet till undertillståndet validering pågår.

• Om verifieringen har fel flyttas migreringen till ett feltillstånd .
• Om verifieringen är klar utan fel startar migreringen och arbetsflödet flyttas till undertillståndet Migrera data.

Du kan se resultatet av Validate and Migrate när åtgärden är klar.

Uppkopplad

Krav (online)

Innan du påbörjar migreringen med migreringstjänsten i Azure Database for PostgreSQL är det viktigt att du uppfyller följande krav, som gäller för offlinemigreringsscenarier.

Verifiera källversionen

PostgreSQL-källversionen ska vara >= 9.5. Om postgreSQL-källversionen är mindre än 9.5uppgraderar du PostgreSQL-källversionen till 9.5 eller högre före migreringen.

Konfigurera onlinemigreringsparametrar

För onlinemigrering bör replikeringsstödet anges till Logiskt under replikeringsinställningarna för PostgreSQL-källservern. Dessutom bör serverparametrar max_wal_senders och max_replication_slots värden vara fler än antalet databaser som behöver migreras. Parametrarna kan anges i Azure Portal under Inställningar-Serverparametrar> eller konfigureras på kommandoraden med hjälp av följande kommandon:

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

Se till att det inte finns några tidskrävande transaktioner. Långvariga transaktioner tillåter inte att replikeringsfack skapas. Skapandet av ett replikeringsfack lyckas om alla långvariga transaktioner checkas in eller återställs. Du måste starta om PostgreSQL-källservern när du har slutfört alla krav för onlinemigrering.

Kommentar

För onlinemigrering med Azure Database for PostgreSQL – enskild server är Azure-replikeringsstödet inställt på logiskt under replikeringsinställningarna för den enskilda serversidan i Azure Portal.

Om du vill förhindra att onlinemigreringen tar slut för lagring för att lagra loggarna kontrollerar du att du har tillräckligt med utrymme för tabellutrymme med hjälp av en etablerad hanterad disk. För att uppnå detta inaktiverar du serverparametern azure.enable_temp_tablespaces_on_local_ssd på den flexibla servern under hela migreringen och återställer den till det ursprungliga tillståndet efter migreringen.

Konfigurera mål

• Azure Database for PostgreSQL måste konfigureras i Azure före migreringen.

• Den SKU som valts för Azure Database for PostgreSQL ska motsvara specifikationerna för källdatabasen för att säkerställa kompatibilitet och tillräcklig prestanda.

• Detaljerade anvisningar om hur du skapar en ny Azure Database for PostgreSQL finns i följande länk: Snabbstart: Skapa server.

• Serverparametern max_replication_slots bör vara mer än det antal databaser som behöver migreras. Den kan anges i Azure Portal under Inställningar-Serverparametrar> eller konfigureras på kommandoraden med hjälp av följande kommando:

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

Viktigt!

Ändra password_encryption-serverparametern på den flexibla servern från SCRAM-SHA-256 till MD5 innan du initierar migreringen. Detta är viktigt för att befintliga autentiseringsuppgifter på en enskild server ska fungera på din flexibla server.

Konfigurera nätverk

Nätverkskonfigurationen är avgörande för att migreringstjänsten ska fungera korrekt. Se till att PostgreSQL-källservern kan kommunicera med Azure Database for PostgreSQL-målservern. Följande nätverkskonfigurationer är viktiga för en lyckad migrering.

Information om nätverkskonfiguration finns i Nätverksguide för migreringstjänsten.

Aktivera tillägg

För att säkerställa en lyckad migrering med hjälp av migreringstjänsten i Azure Database for PostgreSQL kan du behöva verifiera tillägg till postgreSQL-källinstansen. Tillägg innehåller funktioner och funktioner som kan krävas för ditt program. Kontrollera att du verifierar tilläggen på PostgreSQL-källinstansen innan du påbörjar migreringsprocessen.

I målinstansen av Azure Database for PostgreSQL – flexibel server aktiverar du tillägg som stöds som identifieras i postgreSQL-källinstansen.

Mer information finns i Tillägg i Azure Database for PostgreSQL.

Kommentar

En omstart krävs när du gör ändringar i parametern shared_preload_libraries .

Serverparametrar

Dessa parametrar migreras inte automatiskt till målmiljön och måste konfigureras manuellt.

• Matcha serverparametervärden från PostgreSQL-källdatabasen till Azure Database for PostgreSQL genom att komma åt avsnittet "Serverparametrar" i Azure Portal och uppdatera värdena manuellt.

• Spara parameterändringarna och starta om Azure Database for PostgreSQL för att tillämpa den nya konfigurationen om det behövs.

Inaktivera hög tillgänglighet (tillförlitlighet) och läsrepliker i målet

• Det är viktigt att inaktivera hög tillgänglighet (tillförlitlighet) och läsa repliker i målmiljön. Dessa funktioner bör aktiveras först när migreringen har slutförts.

• Genom att följa dessa riktlinjer kan du säkerställa en smidig migreringsprocess utan de tillagda variablerna som introduceras av HA och Read Replicas. När migreringen är klar och databasen är stabil kan du fortsätta med att aktivera dessa funktioner för att förbättra tillgängligheten och skalbarheten för databasmiljön i Azure.

Kommentar

Vissa begränsningar gäller för onlinemigrering som dokumenteras här. Kontrollera att databasen är kompatibel för att köra en onlinemigrering.

Konfigurera din flexibla Azure Database for PostgreSQL-server

• Skapa den flexibla målservern. Guidade steg finns i snabbstarten Skapa en flexibel Azure Database for PostgreSQL-server med hjälp av portalen.

• Tillåtlistetillägg vars bibliotek måste läsas in vid serverstart. Det är viktigt att tillägget finns på listan över tillåtna innan du påbörjar en migrering.

• Kontrollera om datafördelningen mellan en databas tabeller är skev, med de flesta av de data som finns i en enda (eller några) tabeller. Om den är skev kan migreringshastigheten vara långsammare än förväntat. I det här fallet kan migreringshastigheten ökas genom att den stora tabellen migreras parallellt.

Konfigurera migreringsuppgiften

Migreringstjänsten har en enkel, guidebaserad upplevelse av Azure Portal. Så här börjar du:

1. Öppna webbläsaren och gå till portalen. Om du vill logga in anger du dina autentiseringsuppgifter. Standardvyn är instrumentpanelen.

2. Gå till ditt Azure Database for PostgreSQL–mål för flexibel server.

3. På fliken Översikt på den flexibla servern rullar du ned till Migrering på den vänstra menyn och väljer den.

   

4. Välj knappen Skapa för att starta en migrering från en enskild server till en flexibel server. Om det här är första gången du använder migreringstjänsten visas ett tomt rutnät med en uppmaning om att påbörja din första migrering.

   

   Om du redan har skapat migreringar till ditt mål för flexibel server innehåller rutnätet information om migreringar som har försökt nå det här målet från den enskilda servern.

5. Du går igenom en guidebaserad serie flikar för att skapa en migrering till det här flexibla servermålet från olika möjliga källor. Som standard är källservertypen inställd på Azure Database for PostgreSQL – enskild server, vilket är den som vi är intresserade av för det här scenariot.

Du kan också initiera migreringsprocessen från Azure Database for PostgreSQL – enskild server.

1. Öppna webbläsaren och gå till portalen. Om du vill logga in måste du ange dina autentiseringsuppgifter. Standardvyn är instrumentpanelen.

2. När du väljer enskild server kan du se en migreringsrelaterad banderoll på fliken Översikt. Välj Migrera nu för att komma igång.

   

3. Du tas till en sida med två alternativ. Om du redan har skapat en flexibel server och vill använda den som mål väljer du Välj befintlig och väljer motsvarande information om prenumeration, resursgrupp och servernamn . När valen har gjorts väljer du Gå till migreringsguiden och följer anvisningarna i avsnittet Installation .

   

4. Om du väljer att skapa en ny flexibel server väljer du Skapa ny och väljer Gå för att skapa guiden. Den här åtgärden tar dig genom processen för att skapa flexibel server och distribuerar den flexibla servern.

   

När du har distribuerat den flexibla servern följer du stegen 3 till 5 under Konfigurera migreringsuppgiften.

Ställ in

Den första fliken är Installation. Om du missade det tillåter du nödvändiga tillägg enligt beskrivningen i Konfigurera din flexibla Azure Database for PostgreSQL-server innan du påbörjar en migrering.

Migreringsnamnet är den unika identifieraren för varje migrering till det här målet för flexibel server. Det här fältet accepterar endast alfanumeriska tecken och accepterar inga specialtecken förutom understreck (_) och bindestreck (-). Namnet måste börja med ett alfanumeriskt tecken. Namnet måste också vara unikt för en målserver, eftersom inga två migreringar till samma mål för flexibel server kan ha samma namn.

Källservertypen anger källan. I det här fallet är det Azure Database for PostgreSQL – enskild server

Med migreringsalternativet kan du utföra valideringar innan du utlöser en migrering. Du kan välja något av följande alternativ.

• Verifiera – Kontrollerar serverns och databasens beredskap för migrering till målet.
• Migrera – Hoppar över valideringar och startar migreringen.
• Verifiera och migrera – Utför validering innan en migrering utlöses. Migreringen utlöses endast om det inte finns några valideringsfel.

Det är alltid en bra idé att välja alternativet Verifiera eller verifiera och migrera för att utföra valideringar före migreringen innan du kör migreringen.

Med migreringsläget kan du välja mellan en onlinemigrering och en offlinemigrering, i det här fallet måste den vara inställd på Online.

När onlinemigreringsläget är valt måste logisk replikering aktiveras i källan Enskild server. Om den inte är aktiverad aktiverar migreringstjänsten automatiskt logisk replikering på källan Enskild server. Replikering kan också konfigureras manuellt genom att välja replikeringsobjektet under Inställningar på resursmenyn på den enskilda servern och ange stöd för Azure-replikering till LOGISKT. Endera metoden startar om den enskilda källservern.

Välj knappen Nästa: Välj Körningsserver.

Runtime Server

Migreringskörningsservern är en specialiserad funktion inom migreringstjänsten i Azure Database for PostgreSQL, utformad för att fungera som mellanliggande server under migreringen. Det är en separat Azure Database for PostgreSQL – flexibel serverinstans som inte är målservern, men som används för att underlätta migreringen av databaser från en källmiljö som endast är tillgänglig via ett privat nätverk.

Mer information om Runtime Server finns på Migreringskörningsservern.

Välj knappen Nästa: Anslut till källa.

Ansluta till källan

I avsnittet Källa uppmanas du att ange information om den enskilda servern, som är källan till databaserna.

När du har valt Prenumeration och Resursgrupp visar listrutan för servernamn enskilda servrar under den resursgruppen mellan regioner. Välj den källa som du vill migrera databaser från. Du kan migrera databaser från en enskild server till en flexibel målserver i samma region. Migreringar mellan regioner är endast aktiverade för Servrar i Indien, Kina och Förenade Arabemiraten.

När du har valt enskild serverkälla fylls rutorna Plats och PostgreSQL-version i automatiskt. Kontrollera att du anger autentiseringsuppgifterna för en administratörsroll eftersom det krävs för att migreringstjänsten ska kunna migrera databaserna.

När du har fyllt i alla fält väljer du länken Anslut till källa . Detta verifierar att den angivna källserverinformationen är korrekt och att källservern kan nås.

Välj knappen Nästa: Välj migreringsmål för att fortsätta.

Välj migreringsmål

I avsnittet Välj migreringsmål visas metadata för målet flexibel server, till exempel Prenumeration, Resursgrupp, Servernamn, Plats och PostgreSQL-version.

Välj lämpliga värden för autentiseringsmetod och alla autentiseringsrelaterade fält. Kontrollera att den angivna identiteten är administratörsanvändarens identitet på målservern. När du har fyllt i all nödvändig information väljer du länken Anslut till mål . Detta verifierar att den angivna målserverinformationen är korrekt och att målservern kan nås.

Välj knappen Nästa: Välj databaser för migrering för att välja de databaser som ska migreras.

Välj databaser för migrering

Under den här fliken finns en lista över användardatabaser i den enskilda servern. Du kan välja och migrera upp till åtta databaser i ett enda migreringsförsök. Om det finns fler än åtta användardatabaser upprepas migreringsprocessen mellan käll- och målservrarna för nästa uppsättning databaser. Valda databaser som finns på målservern med exakt samma namn skrivs över.

Välj knappen Nästa: Sammanfattning för att granska informationen.

Sammanfattning

Fliken Sammanfattning sammanfattar all information för att skapa verifieringen eller migreringen. Granska informationen och välj knappen Starta validering och migrering .

Övervaka migreringsportalen

När du har startat migreringen visas ett meddelande om att verifieringen eller migreringen har skapats. Du omdirigeras automatiskt till migreringssidan för flexibel server. Det här har en ny post för den nyligen skapade verifieringen eller migreringen.

Rutnätet som visar migreringarna har följande kolumner: Namn, Status, Migreringsläge, Migreringstyp, Källserver, Källservertyp, Databaser, Starttid och Varaktighet. Posterna visas i fallande ordning på starttiden med den senaste posten överst.

Du kan använda knappen Uppdatera för att uppdatera statusen för valideringen eller migreringen.

Du kan också välja namnet på en viss migrering i rutnätet för att se den associerade informationen.

När verifieringen eller migreringen skapas flyttas den till inprogresstillståndet och performingprerequisiteSteps-undertillståndet. Arbetsflödet tar 2–3 minuter att konfigurera migreringsinfrastrukturen och nätverksanslutningarna.

Låt oss titta på hur du övervakar migreringar för varje migreringsalternativ.

Validera

När undertillståndet PerformingPreRequisiteSteps har slutförts flyttas valideringen till undervärdet Validering pågår där kontroller görs på käll- och målservern för att utvärdera beredskapen för migrering.

Valideringen flyttas till tillståndet Lyckades om alla valideringar antingen är i tillståndet Lyckades eller Varning .

Verifieringsrutnätet har följande information:

• Verifieringsinformation för instans - och valideringsinformation för databasavsnitt, som representerar de verifieringsregler som används för att kontrollera migreringsberedskapen .
• Valideringsnamn – namnet på varje specifik verifieringsregel.
• Valideringsstatus – Representerar resultatet för varje regel och kan ha något av de tre värdena:
  • Lyckades – om inga fel hittades.
  • Misslyckades – om det finns valideringsfel.
  • Varning – Om det finns valideringsvarningar.
• Varaktighet – tidsåtgång för valideringsåtgärden.
• Starttid (UTC) och Sluttid (UTC) – Start- och sluttider för valideringsåtgärden i UTC.

Valideringsstatusen flyttas till Tillståndet Misslyckades om det finns fel i verifieringen. Välj valideringsnamnet eller verifieringen av databasnamn som har misslyckats, och ett fönster med utfällbara fönster innehåller information och den korrigerande åtgärd som du bör vidta för att undvika det här felet.

Migrera

När undertillståndet PerformingPreRequisiteSteps har slutförts flyttas migreringen till undertillståndet Migrera data när kloning/kopiering av databaserna sker. Hur lång tid migreringen ska slutföras beror på storleken och formen på de databaser som du migrerar. Migreringen går snabbt om data mestadels är jämnt fördelade över alla tabeller. Det tar relativt lång tid att använda sneda tabellstorlekar.

När du väljer någon av databaserna under migreringen visas en utspringad fönsterruta. Den har alla tabellantal (kopieras, köas, kopieras och fel) och även databasens migreringsstatus.

Migreringen flyttas till tillståndet Lyckades när tillståndet Migrera data har slutförts. Om det finns ett problem i tillståndet Migrera data flyttas migreringen till ett feltillstånd .

När migreringen övergår till tillståndet Lyckades är schema- och datamigreringen från din enskild server till målet för flexibel server klar. Du kan uppdatera sidan för att kontrollera förloppet.

Verifiera och migrera

I det här alternativet utförs valideringar först innan migreringen startar. När undertillståndet PerformingPreRequisiteSteps har slutförts flyttas arbetsflödet till undertillståndet validering pågår.

• Om verifieringen har fel flyttas migreringen till ett feltillstånd .
• Om verifieringen är klar utan fel startar migreringen och arbetsflödet flyttas till undertillståndet Migrera data.

Du kan se resultatet av Validate and Migrate när åtgärden är klar.

Snabb migrering

För migreringsalternativen Migrera och för migrering av verifiera och migrera kräver slutförandet av onlinemigreringen att användaren slutför ett ytterligare steg, vilket är att utlösa snabbåtgärden. När kopieringen/klonen av basdata har slutförts flyttas migreringen till waitingForUserAction-tillståndet och undertillståndet "WaitingForCutoverTrigger ". I det här tillståndet kan användaren utlösa snabbkoppling från portalen genom att välja migreringen och välja knappen Snabb .

Innan du påbörjar cutover är det viktigt att se till att:

• Skrivningar till källan stoppas –Latency (minutes) parametern är 0 eller nära 0 Informationen Latency (minutes) kan hämtas från skärmen för migreringsinformation:

Latency (minutes) parameter anger när målet senast synkroniserades med källan. För databasen Orders ovan är den till exempel 0,333333. Det innebär att de ändringar som har inträffat under de senaste ~0,3 minuterna vid källan ännu inte har skickats över till målet för databasen Orders . 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 (minutes) kan komma nära 0 och först sedan initiera snabbningen. 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 snabbhet även med svarstid som inte är noll stoppas 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 tillämpas på målet. Den tid det tar beror på kvarvarande ändringar som har inträffat under de senaste 15 minuterna. Därför rekommenderar vi att svarstiden är noll eller nära noll innan du utlöser snabbheten.

Migreringen flyttas till tillståndet Lyckades så snart undertillståndet Migrera data eller snabbmigreringen (i onlinemigreringsläget) har slutförts. Om det uppstår ett problem i undertillståndet Migrera data flyttas migreringen till ett feltillstånd .

Möjliga migreringstillstånd är:

• InProgress: Installationen av migreringsinfrastrukturen pågår eller så pågår den faktiska datamigreringen.
• Avbröts: Migreringen avbryts eller tas bort.
• Misslyckades: Migreringen misslyckades.
• Verifieringen misslyckades : Verifieringen misslyckades.
• Lyckades: Migreringen har slutförts.

Möjliga migreringsundertillstånd är:

• PerformingPreRequisiteSteps: Infrastrukturuppsättning pågår för datamigrering.
• Validering pågår: Valideringen pågår.
• MigreraData: Datamigreringen pågår.
• CompletingMigration: Migreringen är i slutfasen av slutförandet.
• Slutförd: Migreringen har slutförts.

Avbryt migreringen med hjälp av portalen

Du kan avbryta pågående valideringar eller migreringar. Arbetsflödet måste vara i tillståndet InProgress för att avbrytas. Du kan inte avbryta en validering eller migrering som är i tillståndet Lyckades eller Misslyckades .

Om du avbryter en validering stoppas all ytterligare valideringsaktivitet och valideringen flyttas till ett avbrutet tillstånd.

Om du avbryter en migrering stoppas ytterligare migreringsaktivitet på målservern och flyttas till ett avbrutet tillstånd. Åtgärden Avbryt återställer alla ändringar som gjorts av migreringstjänsten på målservern.

CLI

Du kan migrera med Hjälp av Azure CLI.

Offline

Förutsättningar (offline)

Innan du påbörjar migreringen med migreringstjänsten i Azure Database for PostgreSQL måste du uppfylla följande krav, som gäller för offlinemigreringsscenarier.

Verifiera källversionen

PostgreSQL-källversionen ska vara >= 9.5. Om postgreSQL-källversionen är mindre än 9.5uppgraderar du PostgreSQL-källversionen till 9.5 eller högre före migreringen.

Målkonfiguration

• Azure Database for PostgreSQL – flexibel server måste distribueras och konfigureras korrekt i Azure innan du påbörjar migreringsprocessen.

• Den SKU som valts för Azure Database for PostgreSQL ska motsvara specifikationerna för källdatabasen för att säkerställa kompatibilitet och tillräcklig prestanda.

• Detaljerade anvisningar om hur du skapar en ny Azure Database for PostgreSQL finns i följande länk: Snabbstart: Skapa server.

Nätverkskonfiguration

Nätverkskonfigurationen är avgörande för att migreringstjänsten ska fungera korrekt. Se till att PostgreSQL-källservern kan kommunicera med Azure Database for PostgreSQL-målservern. Följande nätverkskonfigurationer är viktiga för en lyckad migrering.

Information om nätverkskonfiguration finns i Nätverksguide för migreringstjänsten.

Aktivera tillägg

För att säkerställa en lyckad migrering med hjälp av migreringstjänsten i Azure Database for PostgreSQL kan du behöva verifiera tillägg till postgreSQL-källinstansen. Tillägg innehåller funktioner och funktioner som kan krävas för ditt program. Kontrollera att du verifierar tilläggen på PostgreSQL-källinstansen innan du påbörjar migreringsprocessen.

I målinstansen av Azure Database for PostgreSQL – flexibel server aktiverar du tillägg som stöds som identifieras i postgreSQL-källinstansen.

Mer information finns i Tillägg i Azure Database for PostgreSQL.

Kommentar

En omstart krävs när du gör ändringar i parametern shared_preload_libraries .

Kontrollera serverparametrarna

Dessa parametrar migreras inte automatiskt till målmiljön och måste konfigureras manuellt.

• Matcha serverparametervärden från PostgreSQL-källdatabasen till Azure Database for PostgreSQL genom att komma åt avsnittet Serverparametrar i Azure Portal och uppdatera värdena manuellt.

• Spara parameterändringarna och starta om den flexibla servern Azure Database for PostgreSQL om du vill tillämpa den nya konfigurationen.

Viktigt!

Ändra password_encryption-serverparametern på den flexibla servern från SCRAM-SHA-256 till MD5 innan du initierar migreringen. Detta är viktigt för att befintliga autentiseringsuppgifter på en enskild server ska fungera på din flexibla server.

Inaktivera hög tillgänglighet (tillförlitlighet) och läsrepliker i målet

• Det är viktigt att inaktivera hög tillgänglighet (tillförlitlighet) och läsrepliker i målmiljön. Dessa funktioner bör aktiveras först när migreringen har slutförts.

• Genom att följa dessa riktlinjer kan du säkerställa en smidig migreringsprocess utan de tillagda variablerna som introduceras med hög tillgänglighet och läsrepliker. När migreringen är klar och databasen är stabil kan du fortsätta med att aktivera dessa funktioner för att förbättra tillgängligheten och skalbarheten för databasmiljön i Azure.

Kom igång

1. Om du inte har använt Microsoft Azure tidigare skapar du ett konto för att utvärdera erbjudandena.

2. Installera den senaste Azure CLI för operativsystemet från installationssidan för Azure CLI.

   Om Azure CLI redan är installerat kontrollerar du versionen med hjälp az version av kommandot . Versionen ska vara 2.50.0 eller senare för att använda CLI-kommandon för migrering. Annars uppdaterar du din Azure CLI-version.

3. az login Kör kommandot:

   az login
   

   Ett webbläsarfönster öppnas med azure-inloggningssidan. Ange dina Azure-autentiseringsuppgifter för att utföra en lyckad autentisering. Andra sätt att signera med Azure CLI finns i den här artikeln.

Cli-kommandon för migrering (offline)

Migreringstjänsten levereras med enkla CLI-kommandon för att utföra migreringsrelaterade uppgifter. Alla CLI-kommandon börjar med az postgres flexible-server migration. Det är viktigt att tillåtalistning av tilläggen innan du påbörjar en migrering.

Om du vill ha hjälp med att förstå de alternativ som är associerade med ett kommando och med att utforma rätt syntax kan du använda parametern --help :

az postgres flexible-server migration --help

Om du kör föregående kommando returneras följande utdata:

Utdata visar de migreringskommandon som stöds tillsammans med deras åtgärder. Nu ska vi titta närmare på de här kommandona.

Skapa en migrering med Hjälp av Azure CLI

Kommandot create hjälper dig att skapa en migrering från en källserver till en målserver:

az postgres flexible-server migration create --help

Om du kör föregående kommando returneras följande utdata:

Den visar de förväntade argumenten och har en exempelsyntax för att skapa en migrering från källservern till målservern. Här är CLI-kommandot för att skapa en ny migrering:

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

Parameter	Description
subscription	Prenumerations-ID för målet flexibel server.
resource-group	Resursgrupp för målet flexibel server.
name	Namnet på målet flexibel server.
migration-name	Unik identifierare för varje migrering till det här målet för flexibel server. Det här fältet accepterar endast alfanumeriska tecken och accepterar inga specialtecken förutom understreck (_) och bindestreck (-). Namnet måste börja och sluta med ett alfanumeriskt tecken. Namnet måste också vara unikt för en målserver, eftersom inga två migreringar till samma mål för flexibel server kan ha samma namn.
migration-mode	Det här är en valfri parameter. Standardvärde: Offline. Offlinemigrering innebär att du kopierar dina källdatabaser vid en viss tidpunkt till målservern.
properties	Absolut sökväg till en JSON-fil som innehåller information om källan enskild server.

Till exempel:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode offline

Argumentet migration-name som används i create kommandot används i andra CLI-kommandon, till exempel update, deleteoch show. det identifierar unikt migreringsförsöket i motsvarande åtgärder i alla dessa kommandon.

Slutligen create behöver kommandot att en JSON-fil skickas som en del av argumentet properties .

JSON-strukturen är:

{
	"properties": {
		"sourceDbServerResourceId": "/subscriptions/<subscriptionid>/resourceGroups/<sourceServerResourceGroup>/providers/Microsoft.DBforPostgreSQL/servers/<sourceServer>",
		"secretParameters": {
			"adminCredentials": {
				"sourceServerPassword": "<password>",
				"targetServerPassword": "<password>"
			},
			"sourceServerUserName": "<username>@<servername>",
			"targetServerUserName": "<username>"
		},
		"dbsToMigrate": [
			"<db1>",
			"<db2>"
		],
		"overwriteDbsInTarget": "true"
	}
}

Parametrarna create som går in i JSON-filformatet visas nedan:

Parameter	Typ	Beskrivning
sourceDbServerResourceId	Obligatoriskt	Den här parametern är resurs-ID för enskild serverkälla.
adminCredentials	Obligatoriskt	Den här parametern visar lösenord för administratörsanvändare för både enskild serverkälla och mål för flexibel server. Dessa lösenord hjälper till att autentisera mot käll- och målservrarna.
sourceServerUserName	Obligatoriskt	Standardvärdet är den administratörsanvändare som angavs när en enskild server skapades och det angivna lösenordet används för autentisering med den här användaren. Om du inte använder standardanvändaren är den här parametern användaren eller rollen på källservern för att utföra migreringen. Den här användaren bör ha nödvändiga privilegier och ägarskap för de databasobjekt som ingår i migreringen och bör vara medlem i den azure_pg_admin rollen.
targetServerUserName	Obligatoriskt	Standardvärdet är administratörsanvändaren som skapades när en flexibel server skapades och lösenordet som angavs används för autentisering med den här användaren. Om du inte använder standardanvändaren är den här parametern användaren eller rollen på målservern som används för att utföra migreringen. Den här användaren bör vara medlem i azure_pg_admin, pg_read_all_settings, pg_read_all_stats,pg_stat_scan_tables roller och bör ha skapa roll, Skapa DB-attribut.
dbsToMigrate	Obligatoriskt	Ange listan över databaser som du vill migrera till flexibel server. Endast användardatabaser migreras. Systemdatabaser eller malldatabaser som template0 och template1 migreras inte.
overwriteDbsInTarget	Obligatoriskt	Om målservern är inställd på true och har en befintlig databas med samma namn som den som du försöker migrera skriver migreringstjänsten automatiskt över databasen.
setupLogicalReplicationOnSourceDBIfNeeded	Valfritt	Du kan automatiskt aktivera logisk replikering på källservern genom att ange egenskapen till true. Den här ändringen i serverinställningarna kräver en omstart av servern med två till tre minuters stilleståndstid.
sourceDBServerFullyQualifiedDomainName	Valfritt	Använd den när en anpassad DNS-server används för namnmatchning för ett virtuellt nätverk. Ange FQDN för single server-källan enligt den anpassade DNS-servern för den här egenskapen.
targetDBServerFullyQualifiedDomainName	Valfritt	Använd den när en anpassad DNS-server används för namnmatchning i ett virtuellt nätverk. Ange FQDN för målet flexibel server enligt den anpassade DNS-servern. sourceDBServerFullyQualifiedDomainName och targetDBServerFullyQualifiedDomainName ingår endast som en del av JSON i det sällsynta scenariot att en anpassad DNS-server används för namnmatchning i stället för Azure-tillhandahållen DNS. I annat fall ska du inte ta med dessa parametrar i JSON-filen.

Observera följande viktiga punkter för kommandosvaret:

• create När kommandot utlöses flyttas migreringen till InProgress tillståndet och undertillståndetPerformingPreRequisiteSteps. Migreringsarbetsflödet tar några minuter att distribuera migreringsinfrastrukturen och konfigurera anslutningar mellan källan och målet.
• När undertillståndet PerformingPreRequisiteSteps har slutförts flyttas migreringen till den understat Migrating Data, där kloning/kopiering av databaserna sker.
• Varje databas som migreras har ett eget avsnitt med all migreringsinformation, till exempel antal tabeller, inkrementella infogningar, borttagningar och väntande byte.
• Hur lång tid det tar att slutföra undertillståndet Migrating Data beror på storleken på de databaser som migreras.
• Migreringen flyttas till tillståndet Succeeded så snart undertillståndet Migrating Data har slutförts. Om det uppstår ett problem i undertillståndet Migrating Data flyttas migreringen till ett Failed tillstånd.

Visa en lista över migreringarna

Kommandot list visar alla migreringsförsök som görs till ett mål för flexibel server:

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

Parametern filter har två alternativ:

• Active: Visar en lista över pågående migreringsförsök till målservern. Den innehåller inte de migreringar som har misslyckats, avbrutits eller lyckats.
• All: Visar en lista över alla migreringsförsök till målservern. Detta omfattar både aktiva och slutförda migreringar, oavsett tillstånd.

Mer information om det här kommandot finns i parametern --help :

az postgres flexible-server migration list --help

Övervaka migreringen

Kommandot --show hjälper dig att övervaka pågående migreringar och ger migreringens aktuella tillstånd och undertillstånd.

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

Parametern migration_name är det namn som tilldelats migreringen under create kommandot . Här är en ögonblicksbild av exempelsvaret från CLI-kommandot för att visa information:

Mer information om det här kommandot finns i parametern --help :

 az postgres flexible-server migration show --help

I följande tabeller beskrivs migreringstillstånd och undertillstånd.

Migreringstillstånd	beskrivning
InProgress	Migreringsinfrastrukturen har konfigurerats eller så pågår den faktiska datamigreringen.
Canceled	Migreringen avbryts eller tas bort.
Failed	Migreringen misslyckades.
Succeeded	Migreringen har slutförts.
ValidationFailed	Migreringen misslyckades under valideringen före migreringen.

Undertillstånd för migrering	beskrivning
PerformingPreRequisiteSteps	Infrastrukturen är konfigurerad och förbereds för datamigrering.
MigratingData	Datamigrering pågår.
CompletingMigration	Slutför migreringsprocessen.
Completed	Migreringen är klar, oavsett om den är i ett lyckat tillstånd eller inte.
CancelingRequestedDBMigrations	Avbryter migreringen.
ValidationInProgress	Verifiering pågår.

Uppkopplad

Krav (online)

Innan du påbörjar migreringen med migreringstjänsten i Azure Database for PostgreSQL är det viktigt att du uppfyller följande krav, som gäller för offlinemigreringsscenarier.

Verifiera källversionen

PostgreSQL-källversionen ska vara >= 9.5. Om postgreSQL-källversionen är mindre än 9.5uppgraderar du PostgreSQL-källversionen till 9.5 eller högre före migreringen.

Konfigurera onlinemigreringsparametrar

För onlinemigrering bör replikeringsstödet anges till Logiskt under replikeringsinställningarna för PostgreSQL-källservern. Dessutom bör serverparametrar max_wal_senders och max_replication_slots värden vara fler än antalet databaser som behöver migreras. Parametrarna kan anges i Azure Portal under Inställningar-Serverparametrar> eller konfigureras på kommandoraden med hjälp av följande kommandon:

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

Se till att det inte finns några tidskrävande transaktioner. Långvariga transaktioner tillåter inte att replikeringsfack skapas. Skapandet av ett replikeringsfack lyckas om alla långvariga transaktioner checkas in eller återställs. Du måste starta om PostgreSQL-källservern när du har slutfört alla krav för onlinemigrering.

Kommentar

För onlinemigrering med Azure Database for PostgreSQL – enskild server är Azure-replikeringsstödet inställt på logiskt under replikeringsinställningarna för den enskilda serversidan i Azure Portal.

Om du vill förhindra att onlinemigreringen tar slut för lagring för att lagra loggarna kontrollerar du att du har tillräckligt med utrymme för tabellutrymme med hjälp av en etablerad hanterad disk. För att uppnå detta inaktiverar du serverparametern azure.enable_temp_tablespaces_on_local_ssd på den flexibla servern under hela migreringen och återställer den till det ursprungliga tillståndet efter migreringen.

Konfigurera mål

• Azure Database for PostgreSQL måste konfigureras i Azure före migreringen.

• Den SKU som valts för Azure Database for PostgreSQL ska motsvara specifikationerna för källdatabasen för att säkerställa kompatibilitet och tillräcklig prestanda.

• Detaljerade anvisningar om hur du skapar en ny Azure Database for PostgreSQL finns i följande länk: Snabbstart: Skapa server.

• Serverparametern max_replication_slots bör vara mer än det antal databaser som behöver migreras. Den kan anges i Azure Portal under Inställningar-Serverparametrar> eller konfigureras på kommandoraden med hjälp av följande kommando:

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

Viktigt!

Ändra password_encryption-serverparametern på den flexibla servern från SCRAM-SHA-256 till MD5 innan du initierar migreringen. Detta är viktigt för att befintliga autentiseringsuppgifter på en enskild server ska fungera på din flexibla server.

Konfigurera nätverk

Nätverkskonfigurationen är avgörande för att migreringstjänsten ska fungera korrekt. Se till att PostgreSQL-källservern kan kommunicera med Azure Database for PostgreSQL-målservern. Följande nätverkskonfigurationer är viktiga för en lyckad migrering.

Information om nätverkskonfiguration finns i Nätverksguide för migreringstjänsten.

Aktivera tillägg

För att säkerställa en lyckad migrering med hjälp av migreringstjänsten i Azure Database for PostgreSQL kan du behöva verifiera tillägg till postgreSQL-källinstansen. Tillägg innehåller funktioner och funktioner som kan krävas för ditt program. Kontrollera att du verifierar tilläggen på PostgreSQL-källinstansen innan du påbörjar migreringsprocessen.

I målinstansen av Azure Database for PostgreSQL – flexibel server aktiverar du tillägg som stöds som identifieras i postgreSQL-källinstansen.

Mer information finns i Tillägg i Azure Database for PostgreSQL.

Kommentar

En omstart krävs när du gör ändringar i parametern shared_preload_libraries .

Serverparametrar

Dessa parametrar migreras inte automatiskt till målmiljön och måste konfigureras manuellt.

• Matcha serverparametervärden från PostgreSQL-källdatabasen till Azure Database for PostgreSQL genom att komma åt avsnittet "Serverparametrar" i Azure Portal och uppdatera värdena manuellt.

• Spara parameterändringarna och starta om Azure Database for PostgreSQL för att tillämpa den nya konfigurationen om det behövs.

Inaktivera hög tillgänglighet (tillförlitlighet) och läsrepliker i målet

• Det är viktigt att inaktivera hög tillgänglighet (tillförlitlighet) och läsa repliker i målmiljön. Dessa funktioner bör aktiveras först när migreringen har slutförts.

• Genom att följa dessa riktlinjer kan du säkerställa en smidig migreringsprocess utan de tillagda variablerna som introduceras av HA och Read Replicas. När migreringen är klar och databasen är stabil kan du fortsätta med att aktivera dessa funktioner för att förbättra tillgängligheten och skalbarheten för databasmiljön i Azure.

Kommentar

Vissa begränsningar gäller för onlinemigrering som dokumenteras här. Kontrollera att databasen är kompatibel för att köra en onlinemigrering.

Kom igång

1. Om du inte har använt Microsoft Azure tidigare skapar du ett konto för att utvärdera erbjudandena.

2. Installera den senaste Azure CLI för operativsystemet från installationssidan för Azure CLI.

   Om Azure CLI redan är installerat kontrollerar du versionen med hjälp az version av kommandot . Versionen ska vara 2.50.0 eller senare för att använda CLI-kommandon för migrering. Annars uppdaterar du din Azure CLI-version.

3. az login Kör kommandot:

   az login
   

   Ett webbläsarfönster öppnas med azure-inloggningssidan. Ange dina Azure-autentiseringsuppgifter för att utföra en lyckad autentisering. Andra sätt att signera med Azure CLI finns i den här artikeln.

Cli-kommandon för migrering (online)

Migreringstjänsten levereras med enkla CLI-kommandon för att utföra migreringsrelaterade uppgifter. Alla CLI-kommandon börjar med az postgres flexible-server migration. Det är viktigt att tillåtalistning av tilläggen innan du påbörjar en migrering.

Om du vill ha hjälp med att förstå de alternativ som är associerade med ett kommando och med att utforma rätt syntax kan du använda parametern --help :

az postgres flexible-server migration --help

Om du kör föregående kommando returneras följande utdata:

Utdata visar de migreringskommandon som stöds tillsammans med deras åtgärder. Nu ska vi titta närmare på de här kommandona.

Skapa en migrering med Hjälp av Azure CLI

Kommandot create hjälper dig att skapa en migrering från en källserver till en målserver:

az postgres flexible-server migration create --help

Om du kör föregående kommando returneras följande utdata:

Den visar de förväntade argumenten och har en exempelsyntax för att skapa en migrering från källservern till målservern. Här är CLI-kommandot för att skapa en ny migrering:

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

Parameter	Description
subscription	Prenumerations-ID för målet flexibel server.
resource-group	Resursgrupp för målet flexibel server.
name	Namnet på målet flexibel server.
migration-name	Unik identifierare för varje migrering till det här målet för flexibel server. Det här fältet accepterar endast alfanumeriska tecken och accepterar inga specialtecken förutom understreck (_) och bindestreck (-). Namnet måste börja och sluta med ett alfanumeriskt tecken. Namnet måste också vara unikt för en målserver, eftersom inga två migreringar till samma mål för flexibel server kan ha samma namn.
migration-mode	Det här är en valfri parameter. Standardvärdet är Offline. För onlinemigreringar måste du skicka Online.
properties	Absolut sökväg till en JSON-fil som innehåller information om källan enskild server.

Till exempel:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode online

Argumentet migration-name som används i create kommandot används i andra CLI-kommandon, till exempel update, deleteoch show. det identifierar unikt migreringsförsöket i motsvarande åtgärder i alla dessa kommandon.

Slutligen create behöver kommandot att en JSON-fil skickas som en del av argumentet properties .

JSON-strukturen är:

{
  "properties": {
    "sourceDbServerResourceId": "/subscriptions/<subscriptionid>/resourceGroups/<sourceServerResourceGroup>/providers/Microsoft.DBforPostgreSQL/servers/<sourceServer>",
    "secretParameters": {
      "adminCredentials": {
        "sourceServerPassword": "<password>",
        "targetServerPassword": "<password>"
      }
    },
    "sourceServerUserName": "<username>@<servername>",
    "targetServerUserName": "<username>",
    "dbsToMigrate": ["<db1>", "<db2>"],
    "overwriteDbsInTarget": "true"
  }
}

Parametrarna create som går in i JSON-filformatet visas nedan:

Parameter	Typ	Beskrivning
sourceDbServerResourceId	Obligatoriskt	Den här parametern är resurs-ID för enskild serverkälla.
adminCredentials	Obligatoriskt	Den här parametern visar lösenord för administratörsanvändare för både enskild serverkälla och mål för flexibel server. Dessa lösenord hjälper till att autentisera mot käll- och målservrarna.
sourceServerUserName	Obligatoriskt	Standardvärdet är den administratörsanvändare som angavs när en enskild server skapades och det angivna lösenordet används för autentisering med den här användaren. Om du inte använder standardanvändaren är den här parametern användaren eller rollen på källservern för att utföra migreringen. Den här användaren bör ha nödvändiga privilegier och ägarskap för de databasobjekt som ingår i migreringen och bör vara medlem i den azure_pg_admin rollen.
targetServerUserName	Obligatoriskt	Standardvärdet är administratörsanvändaren som skapades när en flexibel server skapades och lösenordet som angavs används för autentisering med den här användaren. Om du inte använder standardanvändaren är den här parametern användaren eller rollen på målservern som används för att utföra migreringen. Den här användaren bör vara medlem i azure_pg_admin, pg_read_all_settings, pg_read_all_stats,pg_stat_scan_tables roller och bör ha skapa roll, Skapa DB-attribut.
dbsToMigrate	Obligatoriskt	Ange listan över databaser som du vill migrera till flexibel server. Endast användardatabaser migreras. Systemdatabaser eller malldatabaser som template0 och template1 migreras inte.
overwriteDbsInTarget	Obligatoriskt	Om målservern är inställd på true och har en befintlig databas med samma namn som den som du försöker migrera skriver migreringstjänsten automatiskt över databasen.
setupLogicalReplicationOnSourceDBIfNeeded	Valfritt	Du kan automatiskt aktivera logisk replikering på källservern genom att ange egenskapen till true. Den här ändringen i serverinställningarna kräver en omstart av servern med två till tre minuters stilleståndstid.
sourceDBServerFullyQualifiedDomainName	Valfritt	Använd den när en anpassad DNS-server används för namnmatchning för ett virtuellt nätverk. Ange FQDN för single server-källan enligt den anpassade DNS-servern för den här egenskapen.
targetDBServerFullyQualifiedDomainName	Valfritt	Använd den när en anpassad DNS-server används för namnmatchning i ett virtuellt nätverk. Ange FQDN för målet flexibel server enligt den anpassade DNS-servern. sourceDBServerFullyQualifiedDomainName och targetDBServerFullyQualifiedDomainName ingår endast som en del av JSON i det sällsynta scenariot att en anpassad DNS-server används för namnmatchning i stället för Azure-tillhandahållen DNS. I annat fall ska du inte ta med dessa parametrar i JSON-filen.

Observera följande viktiga punkter för kommandosvaret:

• create När kommandot utlöses flyttas migreringen till InProgress tillståndet och undertillståndetPerformingPreRequisiteSteps. Migreringsarbetsflödet tar några minuter att distribuera migreringsinfrastrukturen och konfigurera anslutningar mellan källan och målet.
• När undertillståndet PerformingPreRequisiteSteps har slutförts flyttas migreringen till den understat Migrating Data, där kloning/kopiering av databaserna sker.
• Varje databas som migreras har ett eget avsnitt med all migreringsinformation, till exempel antal tabeller, inkrementella infogningar, borttagningar och väntande byte.
• Hur lång tid det tar att slutföra undertillståndet Migrating Data beror på storleken på de databaser som migreras.
• Migreringen flyttas till tillståndet Succeeded så snart undertillståndet Migrating Data har slutförts. Om det uppstår ett problem i undertillståndet Migrating Data flyttas migreringen till ett Failed tillstånd.

Konfigurera replikering

För onlinemigreringsläge måste logisk replikering vara aktiverad i källan Enskild server. Om den inte är aktiverad aktiverar migreringstjänsten automatiskt logisk replikering på källan Enskild server när parametern setupLogicalReplicationOnSourceDBIfNeeded skickas med värdet true i den tillhörande JSON-filen. Replikering kan också konfigureras manuellt vid källan när migreringen har startats med hjälp av kommandot nedan. Endera metoden för att aktivera logisk replikering startar om källan Enskild server.

Till exempel:

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

Det här kommandot krävs för att påskynda migreringen när den flexibla servern väntar i tillståndet WaitingForLogicalReplicationSetupRequestOnSourceDB .

Så här utför du onlinemigrering:

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --properties "./migrationBody.json" --migration-mode online

Visa en lista över migreringarna

Kommandot list visar alla migreringsförsök som görs till ett mål för flexibel server:

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

Parametern filter har två alternativ:

• Active: Visar en lista över pågående migreringsförsök till målservern. Den innehåller inte de migreringar som har misslyckats, avbrutits eller lyckats.
• All: Visar en lista över alla migreringsförsök till målservern. Detta omfattar både aktiva och slutförda migreringar, oavsett tillstånd.

Mer information om det här kommandot finns i parametern --help :

az postgres flexible-server migration list --help

Övervaka migreringarna

Kommandot show hjälper dig att övervaka pågående migreringar och ger migreringens aktuella tillstånd och undertillstånd.

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

Parametern migration_name är det namn som tilldelats migreringen under create kommandot . Här är en ögonblicksbild av exempelsvaret från CLI-kommandot för att visa information:

Mer information om det här kommandot finns i parametern --help :

 az postgres flexible-server migration show --help

I följande tabeller beskrivs migreringstillstånd och undertillstånd.

Migreringstillstånd	beskrivning
InProgress	Migreringsinfrastrukturen har konfigurerats eller så pågår den faktiska datamigreringen.
Canceled	Migreringen avbryts eller tas bort.
Failed	Migreringen misslyckades.
Succeeded	Migreringen har slutförts.
ValidationFailed	Migreringen misslyckades under valideringen före migreringen.

Undertillstånd för migrering	beskrivning
PerformingPreRequisiteSteps	Infrastrukturen är konfigurerad och förbereds för datamigrering.
MigratingData	Datamigrering pågår.
WaitingForCutoverTrigger	Datamigreringsuppgiften har slutförts och väntar på att användaren ska utlösa snabb information.
CompletingMigration	Slutför migreringsprocessen.
Completed	Migreringen är klar, oavsett om den är i ett lyckat tillstånd eller inte.
CancelingRequestedDBMigrations	Avbryter migreringen.
ValidationInProgress	Verifiering pågår.

Minska migreringarna

När den grundläggande datamigreringen har slutförts i onlinemigreringar flyttas migreringsuppgiften till WaitingForCutoverTrigger undertillstånd. I det här tillståndet kan användaren utlösa snabb användning via CLI med hjälp av kommandot nedan. Snabbkopplingen kan också utlösas från portalen genom att välja migreringsnamnet i migreringsrutnätet.

Till exempel:

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

Innan du påbörjar cutover är det viktigt att se till att:

• Skrivningar till källan stoppas –latency parametern är 0 eller nära 0

latency parameter anger när målet senast synkroniserades med källan. Här är det till exempel 201 och 202 för de två databaserna enligt bilden nedan. Det innebär att de ändringar som har inträffat under de senaste ~200 sekunderna vid källan ännu inte har synkroniserats med målet. 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 initiera snabbning. 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 ändringsdata under de senaste 15 minuterna gäller för målet. Den tid det tar beror på kvarvarande ändringar som har inträffat under de senaste 15 minuterna. Därför rekommenderar vi att svarstiden går till noll eller nära noll innan du utlöser snabbheten. Informationen latency kan hämtas med hjälp av kommandot migreringsvisning.

Här är en ögonblicksbild av migreringen innan du påbörjar snabbningen:

När snabbinitieringen har initierats kopieras alla transaktioner som gjordes under baskopian sekventiellt till målet och migreringen slutförs.

Om snabbåtgärden inte lyckas flyttas migreringen till tillståndet Failed .

Mer information om det här kommandot finns i parametern --help :

 az postgres flexible-server migration update --help

Avbryt migreringen med CLI

Du kan avbryta alla pågående migreringsförsök med hjälp cancel av kommandot . Det här kommandot stoppar det specifika migreringsförsöket och återställer alla ändringar på målservern. Här är CLI-kommandot för att avbryta en migrering:

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

Till exempel:

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

Mer information om det här kommandot finns i parametern --help :

 az postgres flexible-server migration update cancel --help

Kommandot ger dig följande utdata:

Kontrollera migreringen när den är klar

Efter en lyckad migrering ser du till att du kan logga in på din flexibla server med samma autentiseringsuppgifter som på den enskilda servern. Om du stöter på autentiseringsfel på den flexibla servern efter migrering från en enskild server kan det bero på att den flexibla serverns virtuella dator är FIPS-kompatibel eller använder en annan algoritm för lösenordskryptering (SCRAM-SHA-256) jämfört med den enskilda serverns MD5-kryptering. Om du vill åtgärda problemet följer du de här stegen:

1. Ändra password_encryption-serverparametern på den flexibla servern från SCRAM-SHA-256 till MD5.
2. Initiera migreringen från den enskilda servern till den flexibla servern igen.
3. Om autentiseringsproblem kvarstår tar du bort den befintliga flexibla servern och etablerar en ny. Upprepa steg 1 och 2 för att lösa problemet.

Detta bör lösa autentiseringsfelen.

Efter migreringen kan du utföra följande uppgifter:

• Verifiera data på den flexibla servern och se till att det är en exakt kopia av källinstansen.

• Efter verifiering aktiverar du alternativet för hög tillgänglighet på den flexibla servern efter behov.

• Ändra SKU:n för den flexibla servern så att den matchar programbehoven. Den här ändringen kräver en omstart av databasservern.

• Om du ändrar några serverparametrar från deras standardvärden i källinstansen kopierar du dessa serverparametervärden på den flexibla servern.

• Kopiera andra serverinställningar som taggar, aviseringar och brandväggsregler (om tillämpligt) från källinstansen till den flexibla servern.

• Gör ändringar i ditt program för att peka anslutningssträng till en flexibel server.

• Övervaka databasens prestanda noggrant för att se om det kräver prestandajustering.

Relaterat innehåll

• Migreringstjänst
• Migrera från AWS RDS
• Bästa praxis
• Kända problem och begränsningar
• Nätverkskonfiguration
• Validering av förflyttning