De SSMA-console uitvoeren (SybaseToSQL)

Microsoft biedt u een robuuste set scriptbestandsopdrachten voor het uitvoeren en beheren van SSMA-activiteiten (SQL Server Migration Assistant). In de volgende secties wordt hetzelfde beschreven.

Scriptbestandopdrachten

De consoletoepassing maakt gebruik van bepaalde standaardscriptbestandsopdrachten zoals opgesomd in deze sectie.

Projectopdrachten

De projectopdrachten verwerken het maken van projecten, het openen, opslaan en afsluiten van projecten.

create-new-project opdracht

Met deze opdracht maakt u een nieuw SSMA-project.

• project-folder geeft de map aan van het project dat wordt gemaakt.

• project-name geeft de naam van het project aan. {string}

• overwrite-if-exists Optioneel kenmerk geeft aan of een bestaand project moet worden overschreven. {Booleaanse waarde}

• project-type: Optioneel kenmerk. Geeft het projecttype aan, dat wil zeggen, sql-server-2016, sql-server-2017, sql-server-2019, sql-server-2022, sql-server-2025 of sql-azure. De standaardwaarde is sql-server-2016.

Voorbeeld van syntaxis

<create-new-project
  project-folder="<project-folder>"
  project-name="<project-name>"
  overwrite-if-exists="<true/false>" (optional)
  project-type=="<sql-server-2016 | sql-server-2017 | sql-server-2019 | sql-server-2022 | sql-server-2025 | sql-azure>"
/>

Kenmerk overwrite-if-exists is standaard false.

Kenmerk project-type is standaard sql-server-2016.

open-project opdracht

Met deze opdracht wordt het project geopend.

• project-folder geeft de map aan van het project dat wordt gemaakt. De opdracht mislukt als de opgegeven map niet bestaat. {string}

• project-name geeft de naam van het project aan. De opdracht mislukt als het opgegeven project niet bestaat. {string}

Voorbeeld van syntaxis

<open-project
  project-folder="<project-folder>"
  project-name="<project-name>"
/>

save-project opdracht

Met deze opdracht wordt het migratieproject opgeslagen.

Voorbeeld van syntaxis

<save-project/>

close-project opdracht

Met deze opdracht wordt het migratieproject gesloten.

Voorbeeld van syntaxis

<close-project
  if-modified="<save/error/ignore>"   (optional)
/>

Kenmerk if-modified is standaard optioneel ignore .

Opdrachten voor databaseverbinding

Met de opdrachten Databaseverbinding kunt u verbinding maken met de database.

De functie Bladeren van de gebruikersinterface wordt niet ondersteund in de console.

Zie Scriptbestanden maken voor meer informatie.

connect-source-database opdracht

Met deze opdracht wordt verbinding gemaakt met de brondatabase en worden metagegevens op hoog niveau van de brondatabase geladen, maar niet alle metagegevens.

Als de verbinding met de bron niet tot stand kan worden gebracht, wordt er een fout gegenereerd en stopt de consoletoepassing met verdere uitvoering.

De serverdefinitie wordt opgehaald uit het naamkenmerk dat is gedefinieerd voor elke verbinding in de serversectie van het serververbindingsbestand of het scriptbestand.

Voorbeeld van syntaxis

<connect-source-database  server="<server-unique-name>"/>

force-load-source/target-database opdracht

Met deze opdracht worden de bronmetagegevens geladen en is het handig om offline aan het migratieproject te werken.

Als de verbinding met de bron/het doel niet tot stand kan worden gebracht, wordt er een fout gegenereerd en stopt de consoletoepassing met verdere uitvoering.

Voor deze opdracht zijn een of meerdere metabase-knooppunten vereist als opdrachtregelparameter.

Voorbeeld van syntaxis

<force-load metabase="<source/target>" >
  <metabase-object object-name="<object-name>"/>
</force-load>

reconnect-source-database opdracht

Met deze opdracht wordt opnieuw verbinding gemaakt met de brondatabase, maar worden geen metagegevens geladen in tegenstelling tot de opdracht connect-source-database.

Als (opnieuw)verbinding met de bron niet tot stand kan worden gebracht, wordt er een fout gegenereerd en stopt de consoletoepassing de verdere uitvoering.

Voorbeeld van syntaxis

<reconnect-source-database  server="<server-unique-name>"/>

connect-target-database opdracht

Met deze opdracht wordt verbinding gemaakt met de SQL Server-doeldatabase en worden metagegevens op hoog niveau van de doeldatabase geladen, maar niet de metagegevens volledig.

Als de verbinding met het doel niet tot stand kan worden gebracht, wordt er een fout gegenereerd en stopt de consoletoepassing de verdere uitvoering.

De serverdefinitie wordt opgehaald uit het naamkenmerk dat is gedefinieerd voor elke verbinding, in de serversectie van het serververbindingsbestand of het scriptbestand.

Voorbeeld van syntaxis

<connect-target-database  server="<server-unique-name>"/>

reconnect-target-database opdracht

Met deze opdracht wordt opnieuw verbinding gemaakt met de doeldatabase, maar worden geen metagegevens geladen, in tegenstelling tot de opdracht connect-target-database.

Als (opnieuw)verbinding met het doel niet tot stand kan worden gebracht, wordt er een fout gegenereerd en stopt de consoletoepassing met verdere uitvoering.

Voorbeeld van syntaxis

<reconnect-target-database  server="<server-unique-name>"/>

Rapportopdrachten

De rapportopdrachten genereren rapporten over de prestaties van verschillende SSMA-consoleactiviteiten.

generate-assessment-report opdracht

Met deze opdracht worden evaluatierapporten over de brondatabase gegenereerd.

Als de brondatabaseverbinding niet wordt uitgevoerd voordat deze opdracht wordt uitgevoerd, wordt er een fout gegenereerd en wordt de consoletoepassing afgesloten.

Wanneer het niet mogelijk is om verbinding te maken met de brondatabaseserver tijdens de uitvoering van de opdracht, resulteert dit ook in het beëindigen van de consoletoepassing.

• conversion-report-folder: Hiermee geeft u de map op waarin het evaluatierapport kan worden opgeslagen. (optioneel kenmerk)

• object-name: Hiermee geeft u de objecten op die worden overwogen voor het genereren van evaluatierapport (ondersteunt afzonderlijke objectnamen of een groepsobjectnaam).

• object-type: Hiermee geeft u het type van het object dat wordt aangeroepen in het kenmerk objectnaam (als objectcategorie is opgegeven, is het objecttype 'categorie').

• conversion-report-overwrite: Hiermee geeft u op of de map evaluatierapport moet worden overschreven als deze al bestaat.

  Standaardwaarde: onwaar. (optioneel kenmerk)

• write-summary-report-to: Hiermee geeft u het pad op waarop het rapport wordt gegenereerd.

  Als alleen het pad naar de map wordt vermeld, wordt bestand op naam AssessmentReport<n>.xml gemaakt. (optioneel kenmerk)

  Het maken van rapporten heeft twee andere subcategorieën:

  • report-errors (="true/false", met de standaardwaarde 'false' (optionele kenmerken))

  • verbose (="true/false", met de standaardwaarde 'false' (optionele kenmerken))

Voorbeeld van syntaxis

<generate-assessment-report
  object-name="<object-name>"
  object-type="<object-category>"
  write-summary-report-to="<file-name/folder-name>"             (optional)
  verbose="<true/false>"                       (optional)
  report-errors="<true/false>"                 (optional)
  assessment-report-folder="<folder-name>"          (optional)
  conversion-report-overwrite="<true/false>"   (optional)
/>

Of:

<generate-assessment-report
  assessment-report-folder="<folder-name>"            (optional)
  conversion-report-overwrite="<true/false>"     (optional)
>
<metabase-object object-name="<object-name>"
   object-type="<object-category>"/>
</generate-assessment-report>

Migratieopdrachten

Met de migratieopdrachten converteert u het doeldatabaseschema naar het bronschema en migreert u gegevens naar de doelserver.

convert-schema opdracht

Met deze opdracht wordt de schemaconversie van bron naar het doelschema uitgevoerd.

Als de bron- of doeldatabaseverbinding niet wordt uitgevoerd voordat u deze opdracht uitvoert, of als de verbinding met de bron- of doeldatabaseserver mislukt tijdens de uitvoering van de opdracht, wordt er een fout gegenereerd en wordt de consoletoepassing afgesloten.

• conversion-report-folder: Hiermee geeft u de map op waarin het evaluatierapport kan worden opgeslagen. (optioneel kenmerk)

• object-name: Hiermee geeft u de bronobjecten die worden overwogen voor het converteren van schema (ondersteunt afzonderlijke objectnamen of een groepsobjectnaam).

• object-type: Hiermee geeft u het type van het object dat wordt aangeroepen in het kenmerk objectnaam (als objectcategorie is opgegeven, is het objecttype 'categorie').

• conversion-report-overwrite: Hiermee geeft u op of de map evaluatierapport moet worden overschreven als deze al bestaat.

  Standaardwaarde: onwaar. (optioneel kenmerk)

• write-summary-report-to: Hiermee geeft u het pad op waarop het overzichtsrapport wordt gegenereerd.

  Als alleen het pad naar de map wordt vermeld, wordt bestand op naam SchemaConversionReport<n>.xml gemaakt. (optioneel kenmerk)

  Het maken van rapporten heeft twee andere subcategorieën:

  • report-errors (="true/false", met de standaardwaarde 'false' (optionele kenmerken))

  • verbose (="true/false", met de standaardwaarde 'false' (optionele kenmerken))

Voorbeeld van syntaxis

<convert-schema
  object-name="<object-name>"
  object-type="<object-category>"
  write-summary-report-to="<file-name/folder-name>"     (optional)
  verbose="<true/false>"                          (optional)
  report-errors="<true/false>"                    (optional)
  conversion-report-folder="<folder-name>"             (optional)
  conversion-report-overwrite="<true/false>"      (optional)
/>

Of:

<convert-schema
  conversion-report-folder="<folder-name>"         (optional)
  conversion-report-overwrite="<true/false>"> (optional)
  <metabase-object object-name="<object-name>"
    object-type="<object-category>"/>
</convert-schema>

migrate-data opdracht

Met deze opdracht worden de brongegevens naar het doel gemigreerd.

• object-name: Hiermee geeft u de bronobjecten op die worden overwogen voor het migreren van gegevens (ondersteunt afzonderlijke objectnamen of een groepsobjectnaam).

• object-type: hiermee geeft u het type van het object op dat wordt aangeroepen in het kenmerk objectnaam (als de objectcategorie is opgegeven, is het objecttype 'categorie').

• write-summary-report-to: Hiermee geeft u het pad op waarop het rapport wordt gegenereerd.

  Als alleen het pad naar de map wordt vermeld, wordt bestand op naam DataMigrationReport<n>.xml gemaakt. (optioneel kenmerk)

  Het maken van rapporten heeft twee andere subcategorieën:

  • report-errors (="true/false", met de standaardwaarde 'false' (optionele kenmerken))

  • verbose (="true/false", met de standaardwaarde 'false' (optionele kenmerken))

Voorbeeld van syntaxis

<migrate-data
  write-summary-report-to="<file-name/folder-name>"
  report-errors="<true/false>" verbose="<true/false>">
    <metabase-object object-name="<object-name>"/>
    <metabase-object object-name="<object-name>"/>
    <metabase-object object-name="<object-name>"/>
    <data-migration-connection
      source-use-last-used="true"/source-server="<server-unique-name>"
      target-use-last-used="true"/target-server="<server-unique-name>"/>
</migrate-data>

Of:

<migrate-data
  object-name="<object-name>"
  object-type="<object-category>"
  write-summary-report-to="<file-name/folder-name>"
  report-errors="<true/false>" verbose="<true/false>"/>

Migratievoorbereidingsopdracht

Met de opdracht Migratievoorbereiding wordt schematoewijzing tussen de bron- en doeldatabases gestart.

map-schema opdracht

Deze opdracht biedt de schematoewijzing van de brondatabase naar het doelschema.

• source-schema Hiermee geeft u het bronschema dat moet worden gemigreerd.

• sql-server-schema Hiermee geeft u het doelschema op waarnaar het bronschema wordt gemigreerd.

Voorbeeld van syntaxis

<map-schema source-schema="<source-schema>"
sql-server-schema="<target-schema>"/>

Opdrachten voor beheerbaarheid

Met de opdrachten Beheerbaarheid kunt u de doeldatabaseobjecten synchroniseren met de brondatabase.

synchronize-target opdracht

Met deze opdracht worden de doelobjecten gesynchroniseerd met de doeldatabase.

Als deze opdracht wordt uitgevoerd voor de brondatabase, wordt er een fout opgetreden.

Als de doeldatabaseverbinding niet wordt uitgevoerd voordat deze opdracht wordt uitgevoerd, of als de verbinding met de doeldatabaseserver mislukt tijdens de uitvoering van de opdracht, wordt er een fout gegenereerd en wordt de consoletoepassing afgesloten.

• object-name: Hiermee geeft u de doelobjecten op die worden overwogen voor synchronisatie met de doeldatabase (ondersteunt afzonderlijke objectnamen of een groepsobjectnaam).

• object-type: Hiermee geeft u het type van het object dat wordt aangeroepen in het kenmerk objectnaam (als objectcategorie is opgegeven, is het objecttype 'categorie').

• on-error: Hiermee geeft u op of synchronisatiefouten moeten worden opgegeven als waarschuwingen of fouten. Beschikbare opties voor bij fouten:

  • report-total-as-warning

  • report-each-as-warning

  • fail-script

• report-errors-to: Hiermee geeft u de locatie van het foutenrapport voor de synchronisatiebewerking (optioneel kenmerk)

  Als alleen het pad naar de map wordt opgegeven, wordt er een bestand met de naam gemaakt TargetSynchronizationReport.xml .

Voorbeeld van syntaxis

<synchronize-target
object-name="<object-name>"
on-error="<report-total-as-warning/report-each-as-warning/fail-script>" (optional)
  report-errors-to="<file-name/folder-name>"        (optional)
/>

Of:

<synchronize-target
  object-name="<object-name>"
  object-type="<object-category>"/>

Of:

<synchronize-target>
  <metabase-object object-name="<object-name>"/>
  <metabase-object object-name="<object-name>"/>
  <metabase-object object-name="<object-name>"/>
</synchronize-target>

refresh-from-database opdracht

Met deze opdracht worden de bronobjecten uit de database vernieuwd.

Als deze opdracht wordt uitgevoerd voor de doeldatabase, wordt er een fout gegenereerd.

Voor deze opdracht zijn een of meerdere metabase-knooppunten vereist als opdrachtregelparameter.

• object-name: Hiermee geeft u de bronobjecten op die worden overwogen voor het vernieuwen van de brondatabase (ondersteunt afzonderlijke objectnamen of een groepsobjectnaam).

• object-type: Hiermee geeft u het type van het object op dat is opgegeven in het kenmerk objectnaam (als objectcategorie is opgegeven, is het objecttype 'categorie').

• on-error: Hiermee geeft u op of vernieuwingsfoutmeldingen moeten worden beschouwd als waarschuwingen of fouten. Beschikbare opties voor bij fouten:

  • report-total-as-warning
  • report-each-as-warning
  • fail-script

• report-errors-to: Hiermee geeft u de locatie van het foutenrapport voor de synchronisatiebewerking (optioneel kenmerk)

  Als alleen het pad naar de map wordt opgegeven, wordt er een bestand met de naam gemaakt SourceDBRefreshReport.xml .

Voorbeeld van syntaxis

<refresh-from-database
  object-name="<object-name>"
  on-error="<report-total-as-warning/
             report-each-as-warning/
             fail-script>"              (optional)
  report-errors-to="<file-name/folder-name>"        (optional)
/>

Of:

<refresh-from-database
  object-name="<object-name>"
  object-type="<object-category>" />

Of:

<refresh-from-database>
  <metabase-object object-name="<object-name>"/>
</refresh-from-database>

Opdrachten voor het genereren van scripts

De opdrachten voor het genereren van scripts voeren dubbele taken uit: ze helpen de console-uitvoer op te slaan in een scriptbestand en ze registreren de T-SQL-uitvoer naar de console of een bestand op basis van de parameter die u opgeeft.

save-as-script opdracht

Wordt gebruikt om de scripts van de objecten op te slaan in een bestand dat wordt gespecificeerd bij metabase=target. Dit is een alternatief voor de synchronisatieopdracht, waarin we de scripts ophalen en hetzelfde uitvoeren op de doeldatabase.

Voor deze opdracht zijn een of meerdere metabase-knooppunten vereist als opdrachtregelparameter.

• object-name: Hiermee geeft u de objecten op waarvan de scripts moeten worden opgeslagen (ondersteunt afzonderlijke objectnamen of een groepsobjectnaam).

• object-type: Hiermee geeft u het type van het object dat wordt aangeroepen in het kenmerk objectnaam (als objectcategorie is opgegeven, is het objecttype 'categorie').

• metabase: Hiermee geeft u op of het de bron- of doel-metabase is.

• destination: Hiermee geeft u het pad of de map waarin het script moet worden opgeslagen. Als de bestandsnaam niet is opgegeven, wordt er een bestandsnaam in de indeling (object_name attribute value).out opgegeven.

• overwrite: Indien waar, wordt dezelfde bestandsnaam overschreven als deze bestaat. Het kan de waarden (waar/onwaar) hebben.

Voorbeeld van syntaxis

<save-as-script
  metabase="<source/target>"
  object-name="<object-name>"
  object-type="<object-category>"
  destination="<file-name/folder-name>"
  overwrite="<true/false>"   (optional)
/>

Of:

<save-as-script
  metabase="<source/target>"
  destination="<file-name/folder-name>"
    <metabase-object object-name="<object-name>"
                     object-type="<object-category>"/>
</save-as-script>

convert-sql-statement opdracht

Met deze opdracht wordt de SQL-instructie geconverteerd.

• context Hiermee geeft u de schemanaam.

• destination Hiermee geeft u op of de uitvoer moet worden opgeslagen in een bestand.

  Als dit kenmerk niet is opgegeven, wordt de geconverteerde T-SQL-instructie weergegeven op de console. (optioneel kenmerk)

• conversion-report-folder Hiermee geeft u de map waarin het evaluatierapport kan worden opgeslagen. (optioneel kenmerk)

• conversion-report-overwrite Geeft aan of de map evaluatierapport moet worden overschreven als deze al bestaat.

  Standaardwaarde: onwaar. (optioneel kenmerk)

• write-converted-sql-to hiermee geeft u het bestandspad (of) map waarnaar de geconverteerde T-SQL moet worden opgeslagen. Wanneer een mappad wordt opgegeven samen met het kenmerk sql-files, heeft elk bronbestand een overeenkomend T-SQL-doelbestand dat is gemaakt onder de opgegeven map. Wanneer een mappad samen met het sql kenmerk wordt opgegeven, wordt de geconverteerde T-SQL geschreven naar een bestand met de naam Result.out onder de opgegeven map.

• sql geeft aan dat de Sybase SQL-instructies moeten worden geconverteerd, een of meer instructies kunnen worden gescheiden met een ';'

• sql-files hiermee geeft u het pad op van de SQL-bestanden die moeten worden geconverteerd naar T-SQL-code.

• write-summary-report-to hiermee geeft u het pad op waar het overzichtsrapport wordt gegenereerd. Als alleen het pad naar de map wordt vermeld, wordt bestand op naam ConvertSQLReport.xml gemaakt. (optioneel kenmerk)

  Het maken van een overzichtsrapport heeft twee andere subcategorieën, namelijk:

  • report-errors (="true/false", met de standaardwaarde 'false' (optionele kenmerken)).

  • uitgebreid (="true/false", met de standaardwaarde 'false' (optionele kenmerken)).

Voor deze opdracht zijn een of meerdere metabase-knooppunten vereist als opdrachtregelparameter.

Voorbeeld van syntaxis

<convert-sql-statement
       context="<database-name>.<schema-name>"
        conversion-report-folder="<folder-name>"
        conversion-report-overwrite="<true/false>"
        write-summary-report-to="<file-name/folder-name>"   (optional)
        verbose="<true/false>"   (optional)
        report-errors="<true/false>"   (optional)
        destination="<stdout/file>"   (optional)
        write-converted-sql-to ="<file-name/folder-name>"
        sql="SELECT 1 FROM DUAL;">
    <output-window suppress-messages="<true/false>" />
</convert-sql-statement>

Of:

<convert-sql-statement
         context="<database-name>.<schema-name>"
         conversion-report-folder="<folder-name>"
         conversion-report-overwrite="<true/false>"
         write-summary-report-to="<file-name/folder-name>"   (optional)
         verbose="<true/false>"   (optional)
         report-errors="<true/false>"   (optional)
         destination="<stdout/file>"   (optional)
         write-converted-sql-to ="<file-name/folder-name>"
         sql-files="<folder-name>\*.sql"
/>

Of:

<convert-sql-statement
         context="<database-name>.<schema-name>"
         conversion-report-folder="<folder-name>"
         conversion-report-overwrite="<true/false>"
         sql-files="<folder-name>\*.sql"
/>

Verwante inhoud

• Opdrachtregelopties in de SSMA-console
• Werken met de voorbeeldconsolescriptbestanden
• Wachtwoorden beheren
• Rapporten genereren
• Troubleshooting