Distribuera konverterade scheman med Setup Experience

Installationsupplevelsen för schemakonvertering genererar automatiskt instruktioner och skript när konverteringsarbetsflödet har slutförts. Använd dessa filer för att distribuera konverterade scheman till Azure Database for PostgreSQL. Att generera filerna distribuerar inte schemana till målet. Du granskar dem och kör det genererade PowerShell- eller Bash-skriptet i distributionsmiljön.

Anvisningar om hur du öppnar konfigurationsfilerna från en slutförd konvertering finns i Förbereda distribution med installationsupplevelsen i självstudien.

Granska de genererade filerna

Installationskatalogen beror på hur många Oracle-scheman som du väljer att konvertera. Använd den tillämpliga sökvägen i förhållande till arbetsytans rot:

Ersätt <migration-project> med namnet på migreringsprojektets mapp, till exempel Mig001. Om du väljer ett schema ersätter du <schema-name> med det valda oracle-schemamappnamnet, till exempel HR. Om du väljer flera scheman, är _migration det faktiska mappnamnet, inte en platshållare.

Platsen återspeglar de valda Oracle-schemana, inte antalet PostgreSQL-scheman som ingår i paketet. Granska setup_instructions.md för paketets distributionsomfång.

Behåll installationskatalogen inom hela migreringsprojektet. Körarna hänvisar till konverteringssessionens deploy.sql i den närliggande katalogen convert; det räcker inte att bara kopiera installationskatalogen.

Granska de genererade instruktionerna och SQL för distribution innan du kör dem. Kontrollera att SQL-satsen innehåller de objektändringar som du avser att driftsätta. Om du överför projektet till en annan miljö, ska du bevara dess katalogstruktur och följa din organisations datahanteringskrav. Ta bort autentiseringsuppgifter och andra hemligheter från filer som du delar.

Förbered destinationen

Använd kraven i den setup_instructions.md som du har genererat i stället för att kopiera kraven från en annan konvertering:

• Server- och klientversioner. Förbered en flexibel Azure Database for PostgreSQL-server med den nödvändiga PostgreSQL-versionen. Klientens psql huvudversion måste matcha huvudversionen för konverteringsservern som registrerats i det genererade installationspaketet. Installera den klienten på den dator där installationsprogrammet körs och gör den tillgänglig på PATH. Installationsprogrammet kan skapa en databas på din server, men etablerar ingen Azure-server.
• Skal- och filåtkomst. Använd PowerShell 5.1 eller senare på Windows eller Bash i Linux eller macOS. Runnern behöver skrivåtkomst till sina logs- och reports-kataloger.
• Nätverksåtkomst. Tillåt att installationsdatorn ansluter till målservern för Azure Database for PostgreSQL och PostgreSQL-porten.
• Tillägg. Granska de tillägg som krävs och lägg till tillägg som stöds i Azure Database for PostgreSQL-målserverns lista över tillåtna tillägg före distributionen. Se Tillåt tillägg i Azure Database for PostgreSQL.
• Behörigheter. Använd ett konto med behörigheterna att hantera databasen och schemat, skapa objekt och installera tillägg som anges i de genererade anvisningarna. Läget Ny databas kräver också behörighet att skapa databasen.
• Authentication. Använd skriptets dolda lösenordsprompt, en PostgreSQL-lösenordsfil eller organisationens godkända hemlighetshanteringsprocess. Bädda inte in lösenord i distributionsskript.

Bekräfta att klienten är tillgänglig:

psql --version

De genererade instruktionerna återspeglar konverteringsmiljön, inklusive dess krav på PostgreSQL-version och tillägg. Granska eventuella skillnader mellan målmiljöer före distributionen.

Välj ett databasläge

Båda runner-enheterna stöder följande lägen:

För en interaktiv körning frågar skriptet efter värden för värd, användare och databas som saknas. Granska det visade målet, databasläget, scheman och åtgärden innan du bekräftar det.

Kontrollera beredskapen utan att driftsätta

Öppna en terminal i den genererade installationskatalogen. Välj kommandot för ditt operativsystem och det avsedda databasläget:

Läget Endast validering ansluter till servern och skriver lokala rapporter och loggar. Den skapar inte måldatabasen, installerar tillägg eller distribuerar konverterade objekt.

Beredskapskontrollerna omfattar anslutning, PostgreSQL-version, databaskodning och nationella inställningar, behörigheter, målschemats beläggning och tilläggstillgänglighet. Granska varningar och blockerande fel.

I läget för ny databas använder valideringen underhållsdatabasen eftersom måldatabasen inte finns ännu. Kontroller som kräver en måldatabas markeras som överhoppade. En lyckad verifieringskörning är inte en bekräftelse på att de överhoppade kontrollerna klarades.

När valideringen har slutförts granskar du validation_report_<timestamp>.md i reports katalogen. Lös rapporterade problem före driftsättning. Om valideringen stoppas i förtid, kontrollera konsolens utdata först och sedan alla loggar eller rapporter som har skapats.

Distribuera de konverterade scheman

Använd samma mål- och databasläge som du har kontrollerat. Kör lämpligt kommando utan -ValidateOnly (PowerShell) eller --validate-only (Bash) från installationskatalogen:

Runnern förbereder databasen, kontrollerar beredskapen, installerar nödvändiga tillägg som stöds, kör den konverterade driftsättnings-SQL:en och verifierar de resulterande objekten och tilläggen.

Granska distributions-SQL innan du godkänner ett icke-tomt mål eftersom det kan ändra befintliga objekt.

Använd setup_instructions.md för valfria port-, TLS-, språk- och automatiseringsparametrar. För en icke-interaktiv körning anger du information om värd, användare, databas och autentisering i förväg. Ett befintligt mål som inte är tomt kräver också explicit bekräftelse via -AllowNonEmptyExisting på Windows eller --allow-nonempty-existing i Linux eller macOS.

Granska resultat av distribution

Läs resultatet av driftsättningen innan du fortsätter till data- eller applikationsvalidering. Enbart konverteringsstatus bekräftar inte driftsättning till det här målet.

Körningar med endast validering genererar en valideringsrapport i stället för en driftsättningsrapport. Ett tidigt fel, till exempel ett problem med filåtkomst eller shell-version, kan bara lämna konsolutdata.

Använd löparens slutkod tillsammans med följande utdata:

Fortsätt med automatisering endast för avslutskod 0. Om du vill ha annan kod granskar du de tillgängliga utdata och löser de rapporterade problemen innan du fortsätter.

Validera det driftsatta schemat

En lyckad installation innebär inte beteendemässig likvärdighet med Oracle eller att systemet är redo för produktion. Testa datahantering, beroenden, affärslogik och programbeteende separat i målmiljön.

Granska alla objekt eller tillägg som inte har driftsatts och slutför åtgärdandet av dem. Tillämpa separat hanterad säkerhetskonfiguration och återkalla tillfälliga installationsbehörigheter när de inte längre krävs.

Relaterat innehåll

• Tutorial: Konvertera Oracle-scheman till Azure Database for PostgreSQL
• Granska konverterade objekt i Conversion Object Explorer
• Visa HTML-rapporten för Oracle-schemakonvertering
• Bästa praxis för schemakonvertering från Oracle till Azure Database for PostgreSQL