Database Migration Assessment voor Oracle-extensie

Met de Database Migration Assessment for Oracle-extensie in Azure Data Studio kunt u een Oracle-workload evalueren voor migratie naar Azure SQL en Azure Database for PostgreSQL. De extensie identificeert een geschikt Azure SQL- of PostgreSQL-doel met aanbevelingen voor de juiste grootte en hoe complex de migratie kan zijn.

Vereisten

Azure Data Studio-extensie installeren

Volg deze stappen om de Database Migration Assessment for Oracle-extensie te installeren in Azure Data Studio.

  1. Open de uitbreidingsmanager in Azure Data Studio. U kunt het uitbreidingspictogram selecteren of Extensies selecteren in het menu Weergave.

  2. Typ Oracle in de zoekbalk.

  3. Selecteer de Database Migration Assessment voor Oracle-extensie en bekijk de details.

  4. Selecteer Installeren.

    Screenshot of installing the extension.

Extensie-instellingen configureren

U kunt verschillende extensie-instellingen configureren nadat u de extensie hebt geïnstalleerd.

  1. Ga naar extensies en selecteer Database Migration Assessment voor Oracle, selecteer het pictogram Instellingen beheren en selecteer vervolgens extensie-instellingen.

    Screenshot of extension.

  2. Bewerk onder extensie-instellingen alle extensie-instellingen om te voldoen aan de vereisten van de omgeving.

    Screenshot of extension properties settings.

    Notitie

    Om Oracle naar PostgreSQL-codebeoordeling uit te voeren, zijn het homepad van de Oracle-client en het Ora2Pg-installatiepad verplichte parameters.

Evaluatie uitvoeren

Zodra de evaluatie-extensie is geïnstalleerd, is de volgende stap het maken van verbinding met Oracle uw database, het verzamelen van metagegevens van uw Oracle-exemplaar en het genereren van een evaluatierapport.

  1. Ga naar het verbindingspictogram in de menubalk.

    Screenshot of connections menu bar.

  2. Vul in de Verbinding maken ion Details de velden in.

    1. Selecteer Oracle in het veld Verbinding maken iontype.
    2. Typ in het veld Gegevensbron de naam en het exemplaar van uw Oracle-server.
      1. U kunt ook de TNS-naam opgeven. (Zorg ervoor dat de ORACLE_HOME omgevingsvariabele is ingesteld en het TNSNAMES.ORA bestand zich in de <ORACLE_HOME>/network/admin folder.)
      2. Voor containerdatabase kunt u de hoofddatabase van de container verbinden met behulp van de CDB-service-id of de naam van de pluggable databaseservice gebruiken om verbinding te maken met een pluggable database.
    3. Geef de gebruikersnaam van de database op in het veld Gebruikers-id .
    4. Geef het databasewachtwoord op in het veld Wachtwoord .

    Screenshot of connection details.

  3. Selecteer Verbinding maken.

  4. Er wordt nu een nieuwe verbinding weergegeven in het menu Verbindingsdetails.

  5. Klik met de rechtermuisknop op de Oracle-verbinding en selecteer Beheren.

    Screenshot showing the Manage database screen.

  6. Selecteer Migratie-evaluatie.

    Screenshot showing the Migration Assessment database screen.

  7. Selecteer Nieuwe evaluatie uitvoeren.

    Screenshot showing the Run new Assessment screen.

  8. Geef uw evaluatiegegevens op.

    1. Voer in het veld Evaluatienaam een titel in, demo1bijvoorbeeld.
    2. Voer uw evaluatie-instelling in.
      1. Voer de doelmigratiedatabase in het veld Doelplatform in. Op dit moment worden Azure SQL en PostgreSQL als doelen ondersteund.

        Notitie

        Het PostgreSQL-doel is in preview. Deze doeloptie wordt stopgezet. U moet eventuele eerdere evaluaties exporteren.

      2. Selecteer in de sectie Prestatiegegevensverzameling de optie Prestatiegegevensverzameling uitvoeren op Oracle-database (verbonden) of AWR-rapport toevoegen.

        De aanbeveling is om de verbonden optie te gebruiken als u dit hulpprogramma uitvoert tijdens een piek of realistische belasting. Geef anders de AWR-rapporten op die in het verleden zijn gegenereerd voor aanbevelingen voor prestaties en grootte.

        Notitie

        De evaluatieoptie AWR-rapport is niet ingeschakeld voor pluggable database.

      3. Voer de vermenigvuldigerwaarde in het veld Schaalfactor in.

        • Als de aanbevolen SKU andere piekbelastingen moet overwegen, moet de schaalfactor-vermenigvuldiger groter zijn dan 1. Bijvoorbeeld Burst Load, Seizoensgebonden gebruik en toekomstige capaciteitsplanning. Wanneer een gedeeltelijke Oracle-schemaworkload wordt gemigreerd, moet de vermenigvuldiger kleiner zijn dan 1.
      4. Voer in het veld Percentielgebruik de percentielwaarde in voor het bepalen van de grootte van het Azure-doel.

        • De percentielwaarde van de prestatievoorbeeldenset die moet worden overwogen voor het aanpassen van de grootte van het Azure-doel.

    Screenshot showing the assessment details screen.

  9. Er zijn twee soorten evaluatie:

    • Workloadevaluatie. In deze evaluatie voert de Oracle-evaluatiemodule een lichtgewicht detectie van de schemaobjecten uit en categoriseert de schemacomplexiteit voor migratie naar verschillende categorieën met een schatting op hoog niveau voor conversieuren. Deze evaluatie helpt bij het vinden van de haalbaarheid van de migratie naar het doelplatform.

    • Code-evaluatie. De code-evaluatie voert een diepgaande evaluatie uit van de Oracle-schemaobjecten en stelt vervolgens een algemene gereedheid voor de codeobjecten voor met 'ready', 'need review' en 'not ready'-objecttypen op een gedetailleerd niveau en de bijbehorende conversieuren met een hogere nauwkeurigheid.

      Notitie

      De extensie maakt gebruik van het opensource Ora2Pg-schemaconversieprogramma voor code-evaluaties.

      Als de Oracle-client en/of Ora2Pg niet op dezelfde computer als Azure Data Studio is geïnstalleerd, installeert u deze handmatig of gebruikt u het Ora2Pg-installatiescript vanuit GitHub.

      Als de Oracle-client en Ora2Pg zijn geïnstalleerd, moet u ervoor zorgen dat het homepad van de Oracle-client en het Ora2Pg-installatiepad worden bijgewerkt in de extensie-instellingen.

      • Wanneer u Code-evaluatie voor SQL-scenario's selecteert, selecteert u de schema's die u wilt openen voor Oracle naar SQL-conversie en -migratie. Standaard worden alle in aanmerking komende schema's geselecteerd voor de evaluatie.
  10. Kies Validatie uitvoeren om de vereisten en verschillende validatieregels met betrekking tot beveiligingsmachtigingen, configuratie-instellingen, enzovoort uit te voeren. Als de validatie mislukt, moet u de fouten oplossen om verder te gaan.

  11. Wanneer de validatie is geslaagd, kunt u Evaluatie uitvoeren selecteren.

  12. U ziet nu de nieuwe evaluatie in de sectie 'Laatste vijf evaluaties'.

    Screenshot showing the option to name the assessment.

  13. Selecteer de evaluatiekoppeling om de pagina met evaluatiedetails weer te geven. U kunt de meest recente evaluatiestatus bekijken.

    Screenshot showing the latest assessment status.

  14. Selecteer Vernieuwen of wacht totdat de evaluatie is voltooid. De evaluatiestatuspagina wordt standaard elke 15 seconden vernieuwd. De status toont een van de vier statussen: geslaagd, mislukt, wordt uitgevoerd of geannuleerd.

De evaluatie weergeven

Zodra de evaluatie is voltooid, wordt een geconsolideerde uitvoer met behulp van kaarten gegenereerd voor elk Azure SQL-doel: SQL Server op Azure Virtual Machines, Azure SQL Database en Azure SQL Managed Instance, of Azure Database for PostgreSQL - Flexibele server.

Screenshot of the view assessment option.

Elke kaart heeft meerdere secties. De kaart toont de algehele haalbaarheid van de migratie naar het doel. U kunt inzoomen op verschillende workloads onder verschillende migratiecomplexiteitscategorieën:

  • De sectie over functiecompatibiliteit biedt het resultaat van de beoordeling van de functiebeoordeling.
  • SKU-aanbeveling biedt de juiste grootte van het doel.
  • De code-evaluatie biedt de codecomplexiteit van databaseobjecten.

Wanneer u Rapportdetails weergeven selecteert, wordt eerst de evaluatiesamenvatting weergegeven.

Screenshot showing assessment summary.

Als het geselecteerde doel Database for Azure PostgreSQL is, is het tabblad Databasegegevens of het tabblad Code-evaluatie zichtbaar op basis van de selectie van het evaluatietype.

Het volgende tabblad Databasedetails bevat de uitsplitsing per schemabasis. Hier ziet u de lijst met gedetecteerde schema's, de haalbaarheid van de migratie en de geschatte tijd voor het converteren van het schema in uren.

Screenshot showing the breakdown per schema basis.

Deze schatting is gebaseerd op een statistisch model dat van toepassing is op het aantal objecten, regels code, ingeschakelde functies en de grootte van de database. Gebruik code-evaluatie voor een nauwkeurigere schatting van de codeconversie.

Notitie

Het volgende systeem of ingebouwde Oracle-schema's worden uitgesloten van de workloadevaluatie:

APEX, APPQOSSYS, AUDSYS, CSMIG, CTXSYS, DBMS_PRIVILEGE_CAPTURE, DBSFWUSER, DBSNMP, DIP, DMSYS, DVF, DVSYS, EXFSYS, FLOW_, GSMADMIN_INTERNAL, LBACSYS, MDDATA, MDSYS, MGDSYS, MGMT_VIEW, MTMSYS, ODM, ODM_MTR, OJVMSYS, OLAPSYS, ORACLE_OCM, ORDDATA, ORDPLUGINS, ORDSYS, OSE$HTTP$ADMIN, OUTLN, OWBSYS, OWBSYS_AUDIT, PERFSTAT, SDE, SI_INFORMTN_SCHEMA, SPATIAL_CSW_ADMIN_USR, SPATIAL_WFS_ADMIN_USR, SQLTXPLAIN, SYS, SYSMAN, SYSTEM, TRACESRV, TSMSYS, WEBSYS, WKPROXY, WKSYS, WK_PROXY, WK_TEST, WMSYS, XDB, XS$NULL

De SKU-aanbeveling bevat de volgende items:

  • Het geschikte Azure-doel.

  • De servicelaag.

  • De metrische drempelwaarden worden gebruikt om de aanbevolen SKU te bieden.

    Screenshot showing SKU recommendations.

De SKU-aanbeveling evalueert verschillende prestatiegegevens, zoals CPU, geheugen, IOPS, latentie en opslag. Op basis van het gebruik en de configuratiegegevens biedt de aanbeveling het geschikte doel en de juiste servicelaag. De SKU-aanbeveling is gebaseerd op het hoofdexemplaren van de container of het gebruik van een pluggable database. Schemaselectie wordt genegeerd en is niet van toepassing op de grootte van de SKU.

Notitie

Als de functie voor de automatische workloadopslagplaats (AWR) is ingeschakeld op het Oracle-exemplaar, gebruikt de SKU-aanbeveeler de DBA_HIST_ weergaven om de metagegevens van metrische prestatiegegevens te verzamelen. Anders gebruikt de aanbevelingsfunctie serverconfiguratie en andere systeemweergavegegevens voor het aanpassen van de grootte van het Azure SQL-doel.

De codecompatibiliteit (alleen voor PostgreSQL-doelen) biedt een overzicht van schemaobjecten die kunnen worden geconverteerd naar het Azure-doel. Het rapport bevat het opsplitsen van de objecten die automatisch kunnen worden geconverteerd, gereed met voorwaarden en moeten handmatig worden hersteld en geconverteerd.

Screenshot showing the code compatibility report.

Het rapport toont het totale aantal objecten en de conversie-inspanningsuren die nodig zijn om code te migreren naar de Azure PostgreSQL-database. De grafische afbeelding biedt het opsplitsen voor elk schemaobjecttype, zoals tabellen, weergaven en clusters. De inspanningen worden gecategoriseerd als 'Gereed - automatisch geconverteerd', 'Beoordeling van behoeften' en 'Niet gereed - vereist handmatige conversie'.

Een inzoomfunctie voor de secties 'Niet gereed' en 'Revisie van behoeften' bevat de lijst met hersteltaken en de inspanningsuren voor elke taak.

Screenshot showing the remediation task.

De functie-evaluatie biedt de toegewezen functies van Oracle naar Azure-gegevens en de inspanningen die nodig zijn voor het migreren van deze mogelijkheden naar het Azure-doel.

Screenshot showing the mapped assessment.

U kunt het rapport downloaden voor offlineweergave door gecombineerde rapporten downloaden of afzonderlijke rapporten downloaden te selecteren.

Screenshot showing the download assessment report option.

U kunt ook een doorlopende evaluatie annuleren, een evaluatie verwijderen en evaluaties verplaatsen naar een andere map.

Evaluatiepad wijzigen

  1. Ga naar de marketplace voor extensies en zoek naar Database Migration Assessment voor Oracle.
  2. Selecteer het pictogram Beheren en selecteer Instellingen voor extensies.
  3. Geef het nieuwe evaluatiepad op onder Oracle Assessment: Evaluatiepad.

Screenshot showing the Change assessment path option.

Problemen oplossen

Logboeken

In de extensie worden fouten, waarschuwingen en andere diagnostische logboeken opgeslagen in de standaardlogboekmap:

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

Notitie

De extensie slaat standaard de laatste zeven logboekbestanden op.

Als u de logboekmap wilt wijzigen, werkt u de LogDirectory eigenschap bij in het bestand met extensie-instellingen.

Besturingssysteem Pad
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

Ga naar Database Migration Assessment voor Oracle-extensiefouten oplossen voor meer informatie over het oplossen van problemen.

Bekende problemen en beperkingen

  • Het opgegeven pad bestaat niet.

    Reden: Ontbrekende bestanden of ontbrekende machtiging voor de evaluatiemap.

    Mogelijke oplossing:

    • De gebruiker heeft lees- en schrijfmachtigingen voor de evaluatiemap.
    • Als er een ontbrekend bestand of een ontbrekende map is, verwijdert u de evaluatie en genereert u een nieuwe evaluatie.
  • Er is een verbindingstime-outuitzondering opgetreden tijdens interactie met Oracle.

    Reden: Kan geen verbinding maken met het Oracle-exemplaar.

    Mogelijke oplossing:

    • Controleer of firewallregels de Oracle-luisterpoort blokkeren.
    • Voer de opdracht uit tnsping en kijk of de service-id wordt omgezet.

Neem contact op met Microsoft voor hulp

Neem contact op met @dmasupport als u meer hulp van Microsoft nodig hebt. Voor een snellere doorlooptijd kunt u de logboeken toevoegen vanuit de standaardlogboekmap.