Ausführen der SSMA-Konsole (AccessToSQL)
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-exists
Optionales 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.outoverwrite:
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:
Informationen zum Angeben eines Kennworts oder Export-/Importkennwörters finden Sie unter Verwalten von Kennwörtern (AccessToSQL).For specifying a password or export/import passwords, see Managing Passwords (AccessToSQL).
Informationen zum Generieren von Berichten finden Sie unter Generieren von Berichten (AccessToSQL).
Informationen zur Problembehandlung in der Konsole finden Sie unter Problembehandlung (AccessToSQL).For troubleshooting issues in console, see Troubleshooting (AccessToSQL).
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für