De SSMA-console uitvoeren (AccessToSQL)

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

Opdrachten voor projectscriptbestanden

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

create-new-project

Hiermee maakt u een nieuw SSMA-project.

Voorbeeld van syntaxis

<create-new-project
  project-folder="<project-folder>"
  project-name="<project-name>"
  overwrite-if-exists="<true | false>"
  project-type="<project-type>"
/>

open-project

Hiermee opent u een bestaand project.

Voorbeeld van syntaxis

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

save-project

Hiermee wordt het migratieproject opgeslagen.

Voorbeeld van syntaxis

<save-project/>

close-project

Hiermee sluit u het migratieproject.

Voorbeeld van syntaxis

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

Kenmerk if-modified is standaard optioneel ignore .

Opdrachten voor het scriptbestand 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.

De windows-authentication parameters en port parameters zijn niet van toepassing wanneer u verbinding maakt met Azure SQL.

Zie Scriptbestanden makenvoor meer informatie.

connect-source-database

Hiermee 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 de verdere uitvoering

De server definitie wordt opgehaald uit het naamkenmerk dat is gedefinieerd voor elke verbinding in de server sectie van het serververbindingsbestand of het scriptbestand.

Voorbeeld van syntaxis

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

load-access-database

Wordt gebruikt om Access-databasebestanden te laden.

Voorbeeld van syntaxis

<load-access-database  database-file="<Access-database>"/>

Of:

<load-access-database>
  <access-database database-file="<Access-database1>"/>
  <access-database database-file="<Access-database2>"/>
</load-access-database>

force-load bron- of doeldatabase

Laadt de bronmetagegevens. Handig voor offline werken aan migratieproject.

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

Vereist een of meer metabase knooppunten als opdrachtregelparameter.

Voorbeeld van syntaxis

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

Of:

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

reconnect-source-database

Maakt opnieuw verbinding met de brondatabase, maar laadt geen metagegevens 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.

De server definitie wordt opgehaald uit het naamkenmerk dat is gedefinieerd voor elke verbinding in de server sectie van het serververbindingsbestand of het scriptbestand.

Voorbeeld van syntaxis

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

connect-target-database

Maakt verbinding met de doel-SQL Server of Azure SQL Database en laadt metagegevens op hoog niveau van de doeldatabase, maar niet 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 server definitie wordt opgehaald uit het naamkenmerk dat is gedefinieerd voor elke verbinding in de server sectie van het serververbindingsbestand of het scriptbestand.

Voorbeeld van syntaxis

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

reconnect-target-database

Maakt opnieuw verbinding met de doeldatabase, maar laadt geen metagegevens, 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.

De server definitie wordt opgehaald uit het naamkenmerk dat is gedefinieerd voor elke verbinding in de server sectie van het serververbindingsbestand of het scriptbestand.

Voorbeeld van syntaxis

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

Opdrachten voor rapportscriptbestanden

De rapportopdrachten genereren rapporten over de prestaties van verschillende SSMA Console-activiteiten

generate-assessment-report

Hiermee worden evaluatierapporten op de brondatabase gegenereerd.

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

Als er geen verbinding kan worden gemaakt met de brondatabaseserver tijdens de uitvoering van de opdracht, resulteert dit ook in het beëindigen van de consoletoepassing.

Script

• assessment-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 (het kan afzonderlijke objectnamen of een groepsobjectnaam hebben).

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

• assessment-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 waar 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="ssma.Procedures"
  object-type="category"
  write-summary-report-to="<file>"             (optional)
  verbose="<true/false>"                       (optional)
  report-errors="<true/false>"                 (optional)
  conversion-report-folder="<folder>"          (optional)
  conversion-report-overwrite="<true/false>"   (optional)
/>

Of:

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

De opdrachten voor het migratiescriptbestand

Met de migratieopdrachten wordt het doeldatabaseschema geconverteerd naar het bronschema en worden gegevens naar de doelserver gemigreerd.

De standaardinstelling voor console-uitvoer voor de migratieopdrachten is het uitvoerrapport 'Volledig' zonder gedetailleerde foutrapportage: alleen samenvatting op het hoofdknooppunt van de bronobjectstructuur.

convert-schema

Voert schemaconversie van bron naar het doelschema uit.

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.

Script

• 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 (het kan afzonderlijke objectnamen of een groepsobjectnaam hebben).

• object-type: geeft het type van het object op dat is opgegeven 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 waar het rapport 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="ssma.Procedures"
  object-type="category"
  write-summary-report-to="<filepath/folder>"     (optional)
  verbose="<true/false>"                          (optional)
  report-errors="<true/false>"                    (optional)
  conversion-report-folder="<folder>"             (optional)
  conversion-report-overwrite="<true/false>"      (optional)
/>

Of:

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

migrate-data

Hiermee worden de brongegevens naar het doel gemigreerd.

Script

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

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

• write-summary-report-to: Hiermee geeft u het pad op waar 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="<filepath/folder>"
  report-errors="true" verbose="true">
    <metabase-object object-name="ssma.TT1"/>
    <metabase-object object-name="ssma.TT2"/>
    <metabase-object object-name="ssma.TT3"/>
    <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="ssma.Tables"
  object-type="category"
  write-summary-report-to="<filepath/folder>"
  report-errors="true" verbose="true"/>

link-tables

Met deze opdracht wordt de brontabel (Access) gekoppeld aan de doeltabel.

Voorbeeld van syntaxis

<link-tables>
  <metabase-object object-name="AccessDatabase.table1" object-type="Tables"/>
  <metabase-object object-name="AccessDatabase.table2" object-type="Tables"/>
</link-tables>

Of:

<link-tables>
  <metabase-object object-name="AccessDatabase.Tables" object-type="category"/>
</link-tables>

unlink-tables

Met deze opdracht wordt de brontabel (Access) losgekoppeld van de doeltabel.

Voorbeeld van syntaxis

<unlink-tables>
  <metabase-object object-name="AccessDatabase.table1" object-type="Tables"/>
  <metabase-object object-name="AccessDatabase.table2" object-type="Tables"/>
</unlink-tables>

Of:

<unlink-tables>
  <metabase-object object-name="AccessDatabase.Tables" object-type="category"/>
</unlink-tables>

Scriptopdrachten voor migratievoorbereiding

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

map-schema

Schematoewijzing van de bron-database naar het doel-schema.

Script

• source-schema geeft het bronschema op dat we willen migreren.
• sql-server-schema geeft het doelschema op waar het moet worden 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.

De standaardinstelling voor console-uitvoer voor de migratieopdrachten is het uitvoerrapport 'Volledig' zonder gedetailleerde foutrapportage: alleen samenvatting op het hoofdknooppunt van de bronobjectstructuur.

synchronize-target

Synchroniseert de doelobjecten met de doeldatabase. Als deze opdracht wordt uitgevoerd voor de brondatabase, krijgt u een foutmelding.

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.

Script

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

• object-type: Hiermee geeft u het type van het object dat is opgegeven in het kenmerk objectnaam (als objectcategorie is opgegeven dan objecttype is category).

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

  • 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="ots_triggers.dbo"
  on-error="<report-total-as-warning|
             report-each-as-warning|
             fail-script>"              (optional)
  report-errors-to="<file-name>"        (optional)
/>

Of:

<synchronize-target
  object-name="ssma.dbo.Procedures"
  object-type="category"/>

Of:

<synchronize-target>
  <metabase-object object-name="ssma.dbo.TT1"/>
  <metabase-object object-name="ssma.dbo.TT2"/>
  <metabase-object object-name="ssma.dbo.TT3"/>
</synchronize-target>

refresh-from-database

Hiermee vernieuwt u de bronobjecten uit de database. Als deze opdracht wordt uitgevoerd voor de doeldatabase, wordt er een fout gegenereerd.

Script

Vereist een of meer metabase-knooppunten als opdrachtregelparameter.

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

• object-type: Hiermee geeft u het type van het object dat is opgegeven in het kenmerk objectnaam (als objectcategorie is opgegeven dan objecttype is category).

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

  • 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="ssma.TT1"
  on-error="<report-total-as-warning|
             report-each-as-warning|
             fail-script>"              (optional)
  report-errors-to="<file-name>"        (optional)
/>

Of:

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

Of:

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

Scriptgeneratie scriptbestandopdrachten

Met de opdrachten voor het genereren van scripts kunt u de console-uitvoer opslaan in een scriptbestand.

save-as-script

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.

Script

Vereist een of meer metabase-knooppunten als opdrachtregelparameter.

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

• object-type: Hiermee geeft u het type van het object dat is opgegeven in het object-name kenmerk. als objectcategorie is opgegeven, dan is het objecttype category.

• 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) weergegeven.

• overwrite: Als true, dan wordt het bestand overschreven als er dezelfde bestandsnamen bestaan. Het kan de waarden (true/false) hebben.

Voorbeeld van syntaxis

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

Of:

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

Verwante inhoud

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