Freigeben über

Ausführen der SSMA-Konsole (AccessToSQL)

  • Artikel

Microsoft bietet Ihnen einen robusten Satz von Skriptdateibefehlen und Befehlszeilenoptionen zum Ausführen und Steuern von SSMA-Aktivitäten. In den folgenden Abschnitten wird das gleiche detailiert.

Project Script File Commands

Die Project-Befehle behandeln das Erstellen von Projekten, Öffnen, Speichern und Beenden von Projekten.

Befehl

create-new-project: Erstellt ein neues SSMA-Projekt.

Skript

  • project-folder gibt den Ordner des Projekts an, der erstellt wird.

  • project-name gibt den Namen des Projekts an. {string}

  • overwrite-if-existsOptionales Attribut gibt an, ob ein vorhandenes Projekt überschrieben werden soll. {boolean}

  • project-type ist ein optionales Attribut. Die folgenden Optionen stehen für Den Projekttyp zur Verfügung:

    • sql-server-2005

    • sql-server-2008

    • sql-server-2012

    • sql-server-2014

    • sql-server-2016

    • sql-azure

    Der Standardwert ist "sql-server-2008".

Beispiel:

<create-new-project  
  
  project-folder="<project-folder>"  
  
  project-name="<project-name>"  
  
  overwrite-if-exists="<true/false>"  
  
  project-type="<sql-server-2008 | sql-server-2005 | sql-server-2012 | sql-server-2014 | sql-azure>"  
  
/>

Das Attribut "overwrite-if-exists" ist standardmäßig "false ".

Das Attribut "project-type" ist standardmäßig sql-server-2008 .

Befehl

open-project: Öffnet ein vorhandenes Projekt.

Skript

  • project-folder gibt den Ordner des Projekts an, der erstellt wird. Der Befehl schlägt fehl, wenn der angegebene Ordner nicht vorhanden ist. {string}

  • project-name gibt den Namen des Projekts an. Der Befehl schlägt fehl, wenn das angegebene Projekt nicht vorhanden ist. {string}

Syntaxbeispiel:

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

Hinweis: SSMA Für Access Console-Anwendung unterstützt Abwärtskompatibilität. Sie können Projekte öffnen, die mit früherer Version von SSMA erstellt wurden.

Befehl

save-project: Speichert das Migrationsprojekt.

Skript

Syntaxbeispiel:

<save-project/>

Befehl

close-project: Schließt das Migrationsprojekt.

Skript

Syntaxbeispiel:

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

Das Attribut "if-modified" ist optional, standardmäßig ignoriert .

Befehle der Datenbankverbindungsskriptdatei

Mit den Befehlen "Datenbankverbindung" können Sie eine Verbindung mit der Datenbank herstellen.

Die Funktion "Durchsuchen " der Benutzeroberfläche wird in der Konsole nicht unterstützt.

Die Windows-Authentifizierungs - und Portparameter sind beim Herstellen einer Verbindung mit SQL Azure nicht anwendbar.

Weitere Informationen zum Erstellen von Skriptdateien finden Sie unter Erstellen von Skriptdateien (AccessToSQL).

Befehl

connect-source-database

  • Führt eine Verbindung mit der Quelldatenbank aus und lädt Metadaten auf hoher Ebene der Quelldatenbank, aber nicht alle Metadaten.

  • Wenn die Verbindung mit der Quelle nicht hergestellt werden kann, wird ein Fehler generiert, und die Konsolenanwendung beendet die weitere Ausführung.

Skript

Die Serverdefinition wird aus dem Namensattribut abgerufen, das für jede Verbindung im Serverabschnitt der Serververbindungsdatei oder der Skriptdatei definiert ist.

Syntaxbeispiel:

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

Befehl

load-access-database: Wird zum Laden von Zugriffsdatenbankdateien verwendet

Skript

Syntaxbeispiel:

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

oder

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

Befehl

force-load-source/target-database

  • Lädt die Quellmetadaten.

  • Nützlich für die Offlinearbeit am Migrationsprojekt.

  • Wenn die Verbindung mit der Quelle/dem Ziel nicht hergestellt werden kann, wird ein Fehler generiert, und die Konsolenanwendung beendet die weitere Ausführung.

Skript

Erfordert einen oder mehrere Metabasisknoten als Befehlszeilenparameter.

Syntaxbeispiel:

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

oder

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

Befehl

Wiederherstellen der Verbindung zur Quelldatenbank

  • Stellt eine erneute Verbindung mit der Quelldatenbank her, lädt jedoch keine Metadaten im Gegensatz zum Befehl "Connect-source-database".

  • Wenn keine (re)Verbindung mit der Quelle hergestellt werden kann, wird ein Fehler generiert, und die Konsolenanwendung beendet die weitere Ausführung.

Skript

Syntaxbeispiel:

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

Befehl

connect-target-database

  • Stellt eine Verbindung mit der Ziel-SQL Server- oder SQL Azure-Datenbank und lädt allgemeine Metadaten der Zieldatenbank, aber nicht vollständig die Metadaten.

  • Wenn die Verbindung mit dem Ziel nicht hergestellt werden kann, wird ein Fehler generiert, und die Konsolenanwendung beendet die weitere Ausführung.

Skript

Die Serverdefinition wird aus dem Namensattribut abgerufen, das für jede Verbindung im Serverabschnitt der Serververbindungsdatei oder der Skriptdatei definiert ist.

Syntaxbeispiel:

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

Befehl

Erneutes Verbinden der Zieldatenbank

  • Stellt eine erneute Verbindung mit der Zieldatenbank her, lädt jedoch keine Metadaten, im Gegensatz zum Befehl "Connect-target-database".

  • Wenn keine (re)Verbindung mit dem Ziel hergestellt werden kann, wird ein Fehler generiert, und die Konsolenanwendung beendet die weitere Ausführung.

Skript

Syntaxbeispiel:

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

Befehle für Berichtsskriptdatei

Die Befehle "Bericht" generieren Berichte über die Leistung verschiedener SSMA-Konsolenaktivitäten.

Befehl

generate-assessment-report

  • Generiert Bewertungsberichte für die Quelldatenbank.

  • Wenn die Quelldatenbankverbindung vor dem Ausführen dieses Befehls nicht ausgeführt wird, wird ein Fehler generiert, und die Konsolenanwendung wird beendet.

  • Wenn während der Befehlsausführung keine Verbindung mit dem Quelldatenbankserver hergestellt werden kann, wird auch die Konsolenanwendung beendet.

Skript

  • assessment-report-folder: Gibt den Ordner an, in dem der Bewertungsbericht gespeichert werden kann. (optionales Attribut)

  • object-name: Gibt die Objekte an, die für die Generierung von Bewertungsberichten berücksichtigt werden (Es kann einzelne Objektnamen oder einen Gruppenobjektnamen haben).

  • object-type: Gibt den Typ des objekts an, das im Objektnamen-Attribut angegeben ist (wenn objektkategorie angegeben wird, lautet der Objekttyp "category").

  • assessment-report-overwrite: Gibt an, ob der Ordner "Bewertungsbericht" überschrieben werden soll, wenn er bereits vorhanden ist.

    Standardwert: false. (optionales Attribut)

  • write-summary-report-to: Gibt den Pfad an, in dem der Bericht generiert wird.

    Wenn nur der Ordnerpfad erwähnt wird, wird die Datei mit dem Namen AssessmentReport<n.XML> erstellt. (optionales Attribut)

    Die Berichterstellung verfügt über zwei weitere Unterkategorien:

    • report-errors (="true/false", standardmäßig als "false" (optionale Attribute))

    • verbose (="true/false", standardmäßig als "false" (optionale Attribute))

Syntaxbeispiel:

<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)  
  
/>

oder

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

Befehle der Migrationsskriptdatei

Mit den Migrationsbefehlen wird das Zieldatenbankschema in das Quellschema konvertiert und Daten auf den Zielserver migriert.

Die Standardeinstellung für die Konsolenausgabe für die Migrationsbefehle ist der Ausgabebericht "Vollständig" ohne detaillierte Fehlerberichterstattung: Nur Zusammenfassung auf dem Stammknoten der Quellobjektstruktur.

Befehl

convert-schema

  • Führt die Schemakonvertierung aus der Quelle in das Zielschema aus.

  • Wenn die Quell- oder Zieldatenbankverbindung nicht ausgeführt wird, bevor dieser Befehl ausgeführt wird oder die Verbindung mit dem Quell- oder Zieldatenbankserver während der Befehlsausführung fehlschlägt, wird ein Fehler generiert, und die Konsolenanwendung wird beendet.

Skript

  • conversion-report-folder: Gibt den Ordner an, in dem der Bewertungsbericht gespeichert werden kann. (optionales Attribut)

  • object-name: Gibt das quellobjekt(n) an, das für die Konvertierung des Schemas berücksichtigt wird (es kann einzelne Objektnamen oder einen Gruppenobjektnamen haben).

  • object-type: Gibt den Typ des objekts an, das im Objektnamen-Attribut angegeben ist (wenn objektkategorie angegeben wird, lautet der Objekttyp "category").

  • conversion-report-overwrite: Gibt an, ob der Ordner "Bewertungsbericht" überschrieben werden soll, wenn er bereits vorhanden ist.

    Standardwert: false. (optionales Attribut)

  • write-summary-report-to: Gibt den Pfad an, in dem der Bericht generiert wird.

    Wenn nur der Ordnerpfad erwähnt wird, wird die Datei mit dem Namen SchemaConversionReport<n.XML> erstellt. (optionales Attribut)

    Die Berichterstellung verfügt über zwei weitere Unterkategorien:

    • report-errors (="true/false", standardmäßig als "false" (optionale Attribute))

    • verbose (="true/false", standardmäßig als "false" (optionale Attribute))

Syntaxbeispiel:

<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)  
  
/>

oder

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

Befehl

Migrieren von Daten

  • Migriert die Quelldaten zum Ziel.

Skript

  • object-name: Gibt die quellobjekt(n) an, die für die Migration von Daten berücksichtigt werden (Es kann einzelne Objektnamen oder einen Gruppenobjektnamen haben).

  • object-type: Gibt den Typ des objekts an, das im Objektnamen-Attribut angegeben ist (wenn objektkategorie angegeben wird, lautet der Objekttyp "category").

  • write-summary-report-to: Gibt den Pfad an, in dem der Bericht generiert wird.

    Wenn nur der Ordnerpfad erwähnt wird, wird die Datei mit dem Namen DataMigrationReport<n.XML> erstellt. (optionales Attribut)

    Die Berichterstellung verfügt über zwei weitere Unterkategorien:

    • report-errors (="true/false", standardmäßig als "false" (optionale Attribute))

    • verbose (="true/false", standardmäßig als "false" (optionale Attribute))

Syntaxbeispiel:

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

oder

<migrate-data  
  
  object-name="ssma.Tables"  
  
  object-type="category"  
  
  write-summary-report-to="<filepath/folder>"  
  
  report-errors="true" verbose="true"/>

Befehl

Verknüpfungstabellen: Mit diesem Befehl wird die Quelltabelle (Access) mit der Zieltabelle verknüpft.

Skript

Syntaxbeispiel:

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

oder

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

Befehl

verknüpfungstabellen aufheben: Mit diesem Befehl wird die Verknüpfung der Quelltabelle (Access) aus der Zieltabelle entfernt.

Skript

Syntaxbeispiele:

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

oder

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

Befehle für die Migrationsvorbereitungsskriptdatei

Der Befehl "Migrationsvorbereitung" startet die Schemazuordnung zwischen der Quell- und Zieldatenbank.

Befehl

Schemaschema: Schemazuordnung der Quelldatenbank zum Zielschema.

Skript

  • source-schema Gibt das Quellschema an, das migriert werden soll.

  • sql-server-schema Gibt das Zielschema an, in dem es migriert werden soll.

Syntaxbeispiel:

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

Verwaltbarkeitsbefehle

Die Befehle "Verwaltbarkeit" helfen beim Synchronisieren der Zieldatenbankobjekte mit der Quelldatenbank.

Die Standardeinstellung für die Konsolenausgabe für die Migrationsbefehle ist der Ausgabebericht "Vollständig" ohne detaillierte Fehlerberichterstattung: Nur Zusammenfassung auf dem Stammknoten der Quellobjektstruktur.

Befehl

synchronize-target

  • Synchronisiert die Zielobjekte mit der Zieldatenbank.

  • Wenn dieser Befehl für die Quelldatenbank ausgeführt wird, wird ein Fehler angezeigt.

  • Wenn die Zieldatenbankverbindung nicht ausgeführt wird, bevor dieser Befehl ausgeführt wird oder die Verbindung mit dem Zieldatenbankserver während der Befehlsausführung fehlschlägt, wird ein Fehler generiert, und die Konsolenanwendung wird beendet.

Skript

  • object-name: Gibt das Zielobjekt(n) an, das für die Synchronisierung mit der Zieldatenbank berücksichtigt wird (Es kann einzelne Objektnamen oder einen Gruppenobjektnamen aufweisen).

  • object-type: Gibt den Typ des Objekts an, das im Objektnamen-Attribut angegeben ist (wenn objektkategorie angegeben wird, lautet der Objekttyp "category").

  • on-error: Gibt an, ob Synchronisierungsfehler als Warnungen oder Fehler angegeben werden sollen. Verfügbare Optionen für Fehler:

    • Report-total-as-warning

    • report-each-as-warning

    • fail-script

  • report-errors-to: Gibt den Speicherort des Fehlerberichts für den Synchronisierungsvorgang (optionales Attribut) an, wenn nur der Ordnerpfad angegeben wird, und die Datei mit dem Namen TargetSynchronizationReport.XML wird erstellt.

Syntaxbeispiel:

<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)  
  
/>

oder

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

oder

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

Befehl

refresh-from-database

  • Aktualisiert die Quellobjekte aus der Datenbank.

  • Wenn dieser Befehl für die Zieldatenbank ausgeführt wird, wird ein Fehler generiert.

Skript

Erfordert einen oder mehrere Metabasisknoten als Befehlszeilenparameter.

  • object-name: Gibt das Quellobjekt(n) an, das für die Aktualisierung aus der Quelldatenbank berücksichtigt wird (Es kann einzelne Objektnamen oder einen Gruppenobjektnamen haben).

  • object-type: Gibt den Typ des Objekts an, das im Objektnamen-Attribut angegeben ist (wenn objektkategorie angegeben wird, lautet der Objekttyp "category").

  • on-error: Gibt an, ob Aktualisierungsfehler als Warnungen oder Fehler angegeben werden sollen. Verfügbare Optionen für Fehler:

    • Report-total-as-warning

    • report-each-as-warning

    • fail-script

  • report-errors-to: Gibt den Speicherort des Fehlerberichts für den Aktualisierungsvorgang (optionales Attribut) an, wenn nur der Ordnerpfad angegeben wird, und die Datei mit dem Namen SourceDBRefreshReport.XML wird erstellt.

Syntaxbeispiel:

<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)  
  
/>

oder

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

oder

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

Skriptdateibefehle für die Skriptgenerierung

Mit den Befehlen zur Skriptgenerierung können Sie die Konsolenausgabe in einer Skriptdatei speichern.

Befehl

save-as-script

Wird verwendet, um die Skripts der Objekte in einer Datei zu speichern, die beim Metabase=Target erwähnt wird, ist dies eine Alternative zum Synchronisierungsbefehl, bei dem die Skripts abgerufen und in der Zieldatenbank identisch ausgeführt werden.

Skript

Erfordert einen oder mehrere Metabasisknoten als Befehlszeilenparameter.

  • object-name: Gibt die Objekte an, deren Skripts gespeichert werden sollen. (Es kann einzelne Objektnamen oder einen Gruppenobjektnamen enthalten)

  • object-type: Gibt den Typ des objekts an, das im Objektnamen-Attribut angegeben ist (wenn objektkategorie angegeben wird, lautet der Objekttyp "category").

  • metabase: Gibt an, ob es sich um die Quell- oder Zielmetabasis handelt.

  • destination: Gibt den Pfad oder den Ordner an, in dem das Skript gespeichert werden muss; wenn der Dateiname nicht angegeben wird, wird ein Dateiname im Format (object_name Attributwert) angegeben.out

  • overwrite: wenn "true" überschrieben wird, wenn dieselben Dateinamen vorhanden sind. Er kann die Werte (true/false) aufweisen.

Syntaxbeispiel:

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

oder

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

Nächste Schritte

Informationen zu Befehlszeilenoptionen finden Sie unter Befehlszeilenoptionen in der SSMA-Konsole (AccessToSQL).

Informationen zu Beispielkonsolenskriptdateien finden Sie unter Working with the Sample Console Script FilesExecuting the SSMA Console (AccessToSQL)

Der nächste Schritt hängt von ihren Projektanforderungen ab: