Udostępnij za pośrednictwem

Opcje wiersza polecenia w konsoli SSMA (MySQLToSQL)

Firma Microsoft udostępnia niezawodny zestaw opcji wiersza polecenia umożliwiających wykonywanie i kontrolowanie działań SSMA. W poniższych sekcjach szczegółowo opisano to samo.

Opcje wiersza polecenia w konsoli SSMA

Opisane w tym dokumencie są opcje poleceń konsoli.

W tej sekcji termin "opcja" jest również określany jako "switch".

Opcje nie są czułe na wielkość liter i mogą zaczynać się od znaku "-" lub "/".

Jeśli określono opcje, staje się obowiązkowe, aby określić odpowiednie parametry tych opcji.

Parametry opcji muszą być oddzielone od znaku opcji spacją.

Przykłady składni:

C:\> SSMAforMySQLConsole.EXE -s scriptfile

C:\> SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ServersConnectionFileSample.xml"

W cudzysłowie należy określić nazwy folderów lub plików zawierających spacje.

Dane wyjściowe wpisów wiersza polecenia i komunikatów o błędach są przechowywane w stDOUT lub w określonym pliku.

Opcja pliku skryptu: -s/script

Obowiązkowy parametr, ścieżka/nazwa pliku skryptu określa skrypt zawierający sekwencje poleceń, które mają być wykonywane przez SSMA.

Przykłady składni:

C:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Opcja pliku wartości zmiennej: -v/variable

Ten plik składa się ze zmiennych używanych w pliku skryptu. Jest to opcjonalny przełącznik. Jeśli zmienne nie są deklarowane w pliku zmiennej i używane w pliku skryptu, aplikacja generuje błąd i kończy wykonywanie konsoli.

Przykłady składni:

Zmienne zdefiniowane w wielu plikach wartości zmiennych, być może jeden z wartością domyślną, a drugi z określoną wartością wystąpienia, jeśli ma to zastosowanie. Ostatni plik zmiennej określony w argumentach wiersza polecenia przyjmuje preferencję, w przypadku duplikowania zmiennych:

C:\>SSMAforMySQLConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v c:\migration

projects\global_variablevaluefile.xml -v "c:\migrationprojects\instance_variablevaluefile.xml"

Opcja pliku połączenia z serwerem: -c/serverconnection

Ten plik zawiera informacje o połączeniu serwera dla każdego serwera. Każda definicja serwera jest identyfikowana przez unikatowy identyfikator serwera. Identyfikatory serwera znajdują się w pliku skryptu dla poleceń powiązanych z połączeniem.

Definicja serwera może być częścią pliku połączenia serwera i/lub pliku skryptu. Identyfikator serwera w pliku skryptu ma pierwszeństwo przed plikiem połączenia serwera, w przypadku duplikowania identyfikatora serwera.

Przykłady składni:

Identyfikatory serwera są używane w pliku skryptu i są zdefiniowane w osobnym pliku połączenia serwera, plik połączenia serwera używa zmiennych zdefiniowanych w pliku wartości zmiennej:

C:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v

c:\SsmaProjects\myvaluefile1.xml -c

c:\SsmaProjects\myserverconnectionsfile1.xml

Definicja serwera jest osadzona w pliku skryptu:

C:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Opcja danych wyjściowych XML: -x/xmloutput [xmloutputfile]

To polecenie służy do wyprowadzania komunikatów wyjściowych polecenia w formacie XML do konsoli lub pliku XML.

Dostępne są dwie opcje dla xmloutput, a mianowicie:

  • Jeśli ścieżka pliku zostanie podana po przełączeniu xmloutput, dane wyjściowe są przekierowywane do pliku.

    Przykład składni:

    C:\>SSMAforMySQLConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml

  • Jeśli po przełączeniu xmloutput nie podano ścieżki pliku, wówczas xmlout zostanie wyświetlony bezpośrednio na konsoli.

    Przykład składni:

    C:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

Opcja pliku dziennika: -l/log

Wszystkie operacje SSMA w aplikacji konsolowej są rejestrowane w pliku dziennika. Jest to opcjonalny przełącznik. Jeśli plik dziennika i jego ścieżka są określone w wierszu polecenia, dziennik zostanie wygenerowany w określonej lokalizacji. W przeciwnym razie jest generowany w domyślnej lokalizacji.

Przykład składni:

C:\>SSMAforMySQLConsole.EXE

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l c:\SsmaProjects\migration1.log

Opcja folderu środowiska projektu: -e/projectenvironment

Oznacza to folder ustawień środowiska projektu dla bieżącego projektu SSMA. Ten przełącznik jest opcjonalny.

Przykład składni:

C:\>SSMAforMySQLConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e c:\SsmaProjects\CommonEnvironment

Opcja bezpiecznego hasła: -p/securepassword

Ta opcja wskazuje zaszyfrowane hasło dla połączeń serwera. Różni się ona od wszystkich innych opcji: opcja nie wykonuje żadnego skryptu ani nie pomaga w żadnych działaniach związanych z migracją, ale pomaga zarządzać szyfrowaniem haseł dla połączeń serwera używanych w projekcie migracji.

Nie można wprowadzić żadnej innej opcji ani hasła jako parametru wiersza polecenia. W przeciwnym razie spowoduje to wystąpienie błędu. Aby uzyskać więcej informacji, zapoznaj się z sekcją Zarządzanie hasłami .

Następujące opcje podrzędne są obsługiwane w przypadku programu -p/securepassword:

  • Aby dodać hasło do chronionego magazynu dla określonego identyfikatora serwera lub dla wszystkich identyfikatorów serwera zdefiniowanych w pliku połączenia serwera. Poniżej -overwrite opcja aktualizuje hasło, jeśli już istnieje:

    -p|-securepassword -a|add {"<server_id>[, .n]"|all} -c|-serverconnection <server-connection-file> [-v|variable <variable-value-file>]``[-o|overwrite]

    -p|-securepassword -a|add {"<server_id>[, .n]"|all}``-s|-script <server-connection-file> [-v|variable <variable-value-file>] [-o|overwrite]

  • Aby usunąć zaszyfrowane hasło z chronionego magazynu danych określonego identyfikatora serwera lub ze wszystkich identyfikatorów serwera:

    -p/securepassword -r/remove {<server_id> [, ...n] | all}

  • Aby wyświetlić listę identyfikatorów serwera, dla których hasło jest szyfrowane:

    -p/securepassword -l/list

  • Aby wyeksportować hasła przechowywane w chronionym magazynie do zaszyfrowanego pliku. Ten plik jest zaszyfrowany za pomocą hasła określonego przez użytkownika.

    -p/securepassword -e/export {<server-id> [, ...n] | all} <encrypted-password -file>

  • Zaszyfrowany plik, który został wcześniej wyeksportowany, zostaje zaimportowany do chronionego magazynu lokalnego, używając określonego przez użytkownika hasła kodującego. Po odszyfrowaniu pliku jest on przechowywany w nowym pliku, który z kolei jest szyfrowany na komputerze lokalnym.

    -p/securepassword -i/import {<server-id> [, ...n] | all} <encrypted-password -file>

    Można określić wiele identyfikatorów serwera przy użyciu separatorów przecinków.

Opcja pomocy: -?/Pomoc

Wyświetla podsumowanie składni opcji konsoli SSMA:

C:\>SSMAforMySQLConsole.EXE -?

Aby zapoznać się z tabelarycznym wyświetlaniem opcji wiersza polecenia konsoli SSMA, zobacz Dodatek - 1 (MySQLToSQL).

Opcja Pomocy SecurePassword: -securepassword -?/Pomoc

Wyświetla podsumowanie składni opcji konsoli SSMA:

C:\>SSMAforMySQLConsole.EXE -securepassword -?

Aby zapoznać się z tabelarycznym wyświetlaniem opcji wiersza polecenia konsoli SSMA, zapoznaj się z dodatkiem - 1 (MySQLToSQL)

Następny krok

Następny krok zależy od wymagań projektu:

  • Last updated on