Utvärdering av databasmigrering för Oracle-tillägg

Database Migration Assessment for Oracle-tillägget i Azure Data Studio hjälper dig att utvärdera en Oracle-arbetsbelastning för migrering till Azure SQL och Azure Database for PostgreSQL. Tillägget identifierar ett lämpligt Azure SQL- eller PostgreSQL-mål med rätt storleksrekommendationer och hur komplex migreringen kan vara.

Förutsättningar

Installera Azure Data Studio-tillägget

Följ de här stegen för att installera Database Migration Assessment for Oracle-tillägget i Azure Data Studio.

  1. Öppna tilläggshanteraren i Azure Data Studio. Du kan välja tilläggsikonen eller välja Tillägg på menyn Visa.

  2. Skriv Oracle i sökfältet.

  3. Välj Database Migration Assessment for Oracle-tillägget och visa dess information.

  4. Välj Installera.

    Screenshot of installing the extension.

Konfigurera tilläggsinställningar

Du kan konfigurera flera tilläggsinställningar när du har installerat tillägget.

  1. Gå till tillägg och välj Utvärdering av databasmigrering för Oracle, välj ikonen Hantera inställningar och välj sedan tilläggsinställningar.

    Screenshot of extension.

  2. Under tilläggsinställningar redigerar du eventuella tilläggsinställningar för att uppfylla miljöns krav.

    Screenshot of extension properties settings.

    Kommentar

    För att utföra Oracle till PostgreSQL-kodutvärdering är Oracle-klientens hemsökväg och Ora2Pg-installationssökväg obligatoriska parametrar.

Kör utvärdering

När utvärderingstillägget har installerats är nästa steg att ansluta till Oracle-databasen, samla in metadatainformation från Oracle-instansen och generera en utvärderingsrapport.

  1. Gå till anslutningsikonen i menyraden.

    Screenshot of connections menu bar.

  2. I Anslut ionsinformation fyller du i fälten.

    1. I fältet Anslut ionstyp väljer du Oracle.
    2. I fältet Datakälla skriver du in oracle-servernamnet och -instansen.
      1. Du kan också ange TNS-namnet. (Kontrollera att ORACLE_HOME miljövariabeln har angetts och att TNSNAMES.ORA filen finns i <ORACLE_HOME>/network/admin folder.)
      2. För containerdatabasen kan du antingen ansluta containerrotdatabasen med hjälp av CDB-tjänst-ID:t eller använda det anslutningsbara databastjänstnamnet för att ansluta till en pluggbar databas.
    3. Ange databasens användarnamn i fältet Användar-ID .
    4. Ange databaslösenordet i fältet Lösenord .

    Screenshot of connection details.

  3. Välj Anslut.

  4. Nu visas en ny anslutning på menyn för anslutningsinformation.

  5. Högerklicka på Oracle-anslutningen och välj Hantera.

    Screenshot showing the Manage database screen.

  6. Välj Migreringsutvärdering.

    Screenshot showing the Migration Assessment database screen.

  7. Välj Kör ny utvärdering.

    Screenshot showing the Run new Assessment screen.

  8. Ange din utvärderingsinformation.

    1. I fältet Utvärderingsnamn anger du en rubrik, till exempel demo1.
    2. Ange din utvärderingsinställning.
      1. Ange målmigreringsdatabasen i fältet Målplattform . För närvarande har den stöd för Azure SQL och PostgreSQL som mål.

        Kommentar

        PostgreSQL-målet är i förhandsversion. Det här målalternativet upphör att gälla. Du bör exportera eventuella tidigare utvärderingar.

      2. I avsnittet Prestandadatainsamling väljer du antingen Kör insamling av prestandadata på Oracle-databas (ansluten) eller Lägg till AWR-rapport.

        Rekommendationen är att använda det anslutna alternativet om du kör det här verktyget under en hög eller realistisk belastning. Annars anger du de AWR-rapporter som genererats tidigare för prestanda- och storleksrekommendationer.

        Kommentar

        Alternativet AWR-rapportutvärdering är inte aktiverat för pluggbar databas.

      3. Ange multiplikatorvärdet i fältet Skalningsfaktor .

        • Om den rekommenderade SKU:n behöver ta hänsyn till andra belastningar bör skalningsfaktormultiplikatorn vara större än 1. Till exempel burst-belastning, säsongsanvändning och framtida kapacitetsplanering. När en partiell Oracle-schemaarbetsbelastning migreras bör multiplikatorn vara mindre än 1.
      4. I fältet Percentilanvändning anger du percentilvärdet för storleksändring av Azure-målet.

        • Percentilvärdet för prestandaexemplet som ska beaktas för storleksändring av Azure-målet.

    Screenshot showing the assessment details screen.

  9. Det finns två typer av utvärderingar:

    • Utvärdering av arbetsbelastning. I den här utvärderingen utför Oracle-utvärderingsmodulen en enkel identifiering av schemaobjekten och kategoriserar schemakomplexiteten för migrering till olika kategorier med en uppskattning på hög nivå för konverteringstimmar. Den här förstudien hjälper dig att hitta möjligheten att migrera till målplattformen.

    • Kodutvärdering. Kodutvärderingen utför en djupgående utvärdering av Oracle-schemaobjekten och föreslår sedan en övergripande beredskap för kodobjekten med objekten "ready", "need review" och "not ready" på en detaljerad nivå och dess associerade konverteringstimmar med högre noggrannhet.

      Kommentar

      Tillägget använder ora2Pg-schemakonverteraren med öppen källkod för kodutvärderingar.

      Om Oracle-klienten och/eller Ora2Pg inte är installerade på samma dator som Azure Data Studio installerar du dem manuellt eller använder Installationsskriptet för Ora2Pg från GitHub.

      Om Oracle-klienten och Ora2Pg är installerade kontrollerar du att Oracle-klientens hemsökväg och Ora2Pg-installationssökvägen uppdateras i tilläggsinställningarna.

      • När du väljer Kodutvärdering för SQL-scenarier väljer du de scheman som du vill komma åt för Oracle till SQL-konvertering och migrering. Som standard väljs alla berättigade scheman för utvärderingen.
  10. Välj Kör validering för att utföra förutsättningarna och olika valideringsregler som rör säkerhetsbehörigheter, konfigurationsinställningar osv. Om verifieringen misslyckas måste du åtgärda felen för att fortsätta.

  11. När valideringen har slutförts kan du välja Kör utvärdering.

  12. Nu visas den nya utvärderingen i avsnittet "Senaste fem utvärderingarna".

    Screenshot showing the option to name the assessment.

  13. Välj utvärderingslänken för att visa sidan med utvärderingsinformation. Du kan visa den senaste utvärderingsstatusen.

    Screenshot showing the latest assessment status.

  14. Välj Uppdatera eller vänta tills utvärderingen har slutförts. Som standard uppdateras utvärderingsstatussidan var 15:e sekund. Statusen visar en av fyra statusar: lyckades, misslyckades, pågår eller avbröts.

Visa utvärderingen

När utvärderingen är klar genereras en konsoliderad utdata med kort för antingen varje Azure SQL-mål: SQL Server på virtuella Azure-datorer, Azure SQL Database och Azure SQL Managed Instance eller Azure Database for PostgreSQL – flexibel server.

Screenshot of the view assessment option.

Varje kort har flera avsnitt. Kortet visar den övergripande genomförbarheten av migreringen till målet. Du kan öka detaljnivån för olika arbetsbelastningar under olika migreringskomplexitetskategorier:

  • Avsnittet om funktionskompatibilitet innehåller granskningsresultatet för funktionsutvärderingen.
  • SKU-rekommendationen ger rätt storlek på målet.
  • Kodutvärderingen ger kodkomplexiteten för databasobjekt.

När du väljer Visa rapportinformation visas först utvärderingssammanfattningen.

Screenshot showing assessment summary.

Om det valda målet är Database for Azure PostgreSQL visas fliken Databasinformation eller Fliken Kodutvärdering baserat på valet av utvärderingstyp.

På följande databasinformationsflik visas uppdelningen per schemabas. Den visar listan över identifierade scheman, migreringsmöjligheten och den beräknade tiden för att konvertera schemat i timmar.

Screenshot showing the breakdown per schema basis.

Den här uppskattningen baseras på en statistisk modell som gäller för antalet objekt, kodrader, aktiverade funktioner och databasens storlek. Om du vill ha en mer exakt uppskattning av kodkonverteringen använder du kodutvärdering.

Kommentar

Följande system- eller Oracle-inbyggda scheman undantas från arbetsbelastningsutvärderingen:

APEX, APPQOSSYS, AUDSYS, CSMIG, CTXSYS, DBMS_PRIVILEGE_CAPTURE, DBSFWUSER, DBSNMP, DIP, DMSYS, DVF, DVSYS, EXFSYS, FLOW_, , GSMADMIN_INTERNAL, LBACSYS, MDSYSODMMGMT_VIEWMDDATAMTMSYSMGDSYS, ODM_MTR, ORDPLUGINSORACLE_OCMOJVMSYSORDSYSOSE$HTTP$ADMINOUTLNORDDATAOLAPSYS, OWBSYSSI_INFORMTN_SCHEMASDEPERFSTATOWBSYS_AUDIT, , SPATIAL_CSW_ADMIN_USR, , SQLTXPLAINSPATIAL_WFS_ADMIN_USR, SYSTEMSYSSYSMAN, TRACESRV, TSMSYS, , WKSYSXDBWKPROXYWK_PROXYWK_TESTWMSYSWEBSYSXS$NULL

SKU-rekommendationen innehåller följande:

  • Det lämpliga Azure-målet.

  • Tjänstnivån.

  • Måtttrösklarna används för att tillhandahålla den rekommenderade SKU:n.

    Screenshot showing SKU recommendations.

SKU-rekommendationen utvärderar olika prestandamått, till exempel CPU, minne, IOPS, svarstid och lagring. Baserat på användnings- och konfigurationsdata tillhandahåller rekommenderaren lämpligt mål och lämplig tjänstnivå. SKU-rekommendationen baseras på containerrotinstansen eller den pluggbara databasanvändningen. Schemaval ignoreras och gäller inte för SKU-storleksändringen.

Kommentar

Om funktionen för automatisk arbetsbelastningslagringsplats (AWR) är aktiverad på Oracle-instansen använder SKU-rekommenderaren vyerna DBA_HIST_ för att samla in metadata för prestandamått. I annat fall använder rekommenderaren serverkonfiguration och annan systemvyinformation för storleksändring av Azure SQL-målet.

Kodkompatibiliteten (endast för PostgreSQL-mål) innehåller en sammanfattning av schemaobjekt som kan konverteras till Azure-målet. Rapporten innehåller uppbrytningen av de objekt som kan konverteras automatiskt, redo med villkor och måste åtgärdas och konverteras manuellt.

Screenshot showing the code compatibility report.

Rapporten visar det totala antalet objekt och de konverteringstimmar som krävs för att migrera kod till Azure PostgreSQL-databasen. Den grafiska bilden innehåller uppbrytningen för varje schemaobjekttyp, till exempel tabeller, vyer och kluster. Arbetet kategoriseras som "Klar – konverteras automatiskt", "Behöver granskas" och "Inte redo – kräver manuell konvertering".

En detaljnivå för avsnitten "Inte redo" och "Behöver granskas" innehåller en lista över reparationsuppgifter och arbetstimmarna för varje aktivitet.

Screenshot showing the remediation task.

Funktionsutvärderingen tillhandahåller mappade funktioner för Oracle till Azure-datamål och den ansträngning som krävs för att migrera dessa funktioner till Azure-målet.

Screenshot showing the mapped assessment.

Du kan ladda ned rapporten för offlinevisning genom att välja Ladda ned kombinerade rapporter eller Ladda ned enskilda rapporter.

Screenshot showing the download assessment report option.

Du kan också avbryta en pågående utvärdering, ta bort en utvärdering och flytta utvärderingar till en annan katalog.

Ändra utvärderingssökväg

  1. Gå till marknadsplatsen för tillägget och sök efter Database Migration Assessment for Oracle.
  2. Välj ikonen Hantera och välj Tilläggsinställningar.
  3. Ange den nya utvärderingssökvägen under Oracle Assessment: Assessment Path.

Screenshot showing the Change assessment path option.

Felsöka

Loggar

Tillägget lagrar fel, varningar och andra diagnostikloggar i standardloggkatalogen:

  • Windows – C:\Users\<username>.dmaoracle\logs\
  • Linux- ~/.dmaoracle/logs
  • Macos- /Users/<username>/.dmaoracle/logs

Kommentar

Som standard lagrar tillägget de senaste sju loggfilerna.

Om du vill ändra loggkatalogen uppdaterar du LogDirectory egenskapen i filen med tilläggsinställningar.

Operativsystem Sökväg
Windows C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux ~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS /Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

Mer information om felsökningsproblem finns i Felsöka utvärdering av databasmigrering för Oracle-tilläggsfel.

Kända problem och begränsningar

  • Den angivna sökvägen finns inte.

    Orsak: Filer saknas eller behörighet saknas i utvärderingsmappen.

    Möjlig lösning:

    • Användaren har läs- och skrivbehörighet i utvärderingsmappen.
    • Om det saknas en fil eller mapp tar du bort utvärderingen och genererar en ny utvärdering.
  • Det uppstod ett undantag för tidsgränsen för anslutningen vid interaktion med Oracle.

    Orsak: Det gick inte att ansluta till Oracle-instansen.

    Möjlig lösning:

    • Kontrollera om brandväggsregler blockerar Oracles lyssningsport.
    • Kör tnsping och se om tjänst-ID:t löses.

Kontakta Microsoft om du vill ha hjälp

Kontakta @dmasupport om du behöver ytterligare hjälp från Microsoft. För snabbare vändning kan du bifoga loggarna från standardloggkatalogen.