Параметры командной строки в консоли SSMA (DB2ToSQL)

Статья
05/23/2023

Корпорация Майкрософт предоставляет надежные параметры командной строки для выполнения действий SSMA и управления ими. В последующих разделах подробно описано то же самое.

Параметры командной строки в консоли SSMA

Здесь описаны параметры команды консоли.

В этом разделе термин "option" также называется "switch".

Параметры не учитывает регистр и могут начинаться с символа "-" или "/".

Если заданы параметры, это становится обязательным для указания соответствующих параметров параметра.

Параметры параметра должны быть разделены символом параметра пробелом.

Примеры синтаксиса:

C:\> SSMAforDB2Console.EXE -s scriptfile

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

Имена папок или файлов, содержащих пробелы, должны быть указаны в двойных кавычках.

Выходные данные записей командной строки и сообщений об ошибках хранятся в STDOUT или в указанном файле.

Параметр файла скрипта: -s/script

Обязательный переключатель, путь к файлу скрипта или имя указывает сценарий последовательностей команд, выполняемых SSMA.

Примеры синтаксиса:

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

Параметр файла значения переменной: -v/variable

Этот файл содержит переменные, используемые в файле скрипта. Это необязательный параметр. Если переменные не объявляются в файле переменных и используются в файле скрипта, приложение создает ошибку и завершает выполнение консоли.

Примеры синтаксиса:

Переменные, определенные в нескольких файлах значений переменной, возможно, один со значением по умолчанию и другим с конкретным значением экземпляра, если применимо. Последний файл переменной, указанный в аргументах командной строки, принимает предпочтение, если существует дублирование переменных:

C:\>SSMAforDB2Console.EXE -s

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

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

Параметр файла подключения к серверу: -c/serverconnection

Этот файл содержит сведения о подключении сервера для каждого сервера. Каждое определение сервера определяется уникальным идентификатором сервера. Идентификаторы сервера ссылаются в файле скрипта для связанных команд подключения.

Определение сервера может быть частью файла подключения к серверу и /или файла скрипта. Идентификатор сервера в файле скрипта имеет приоритет над файлом подключения сервера, если существует дублирование идентификатора сервера.

Примеры синтаксиса:

Идентификаторы сервера используются в файле скрипта, и они определены в отдельном файле подключения к серверу, файл подключения сервера использует переменные, определенные в файле значений переменной:

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

c:\SsmaProjects\myvaluefile1.xml -c

c:\SsmaProjects\myserverconnectionsfile1.xml
Определение сервера внедрено в файл скрипта:

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

Параметр вывода XML: -x/xmloutput [xmloutputfile]

Эта команда используется для вывода выходных сообщений команды в формате XML в консоли или в XML-файл.

Существует два варианта для xmloutput, viz..,:

Если файловый путь предоставляется после переключения xmloutput, выходные данные перенаправляются в файл.

Пример синтаксиса:

C:\>SSMAforDB2Console.EXE -s

"C:\ Program Files\Microsoft SQL Server Migration Assistant for DB2\Sample Console Scripts \ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml
Если файловый путь не указан после параметра xmloutput, xmlout отображается в самой консоли.

Пример синтаксиса:

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

Параметр файла журнала: -l/log

Все операции SSMA в консольном приложении записываются в файл журнала. Это необязательный параметр. Если файл журнала и его путь указаны в командной строке, журнал создается в указанном расположении. В противном случае он создается в своем расположении по умолчанию.

Пример синтаксиса:

C:\>SSMAforDB2Console.EXE

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

Параметр папки среды проекта: -e/projectenvironment

Это означает папку параметров среды проекта для текущего проекта SSMA. Этот параметр является необязательным.

Пример синтаксиса:

C:\>SSMAforDB2Console.EXE -s

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

Параметр безопасного пароля: -p/securepassword

Этот параметр указывает зашифрованный пароль для подключений к серверу. Он отличается от всех других параметров: параметр не выполняет ни скрипт, ни помогает в каких-либо действиях, связанных с миграцией, но помогает управлять шифрованием паролей для подключений сервера, используемых в проекте миграции.

Невозможно ввести любой другой параметр или пароль в качестве параметра командной строки. В противном случае это приведет к ошибке. Дополнительные сведения см. в разделе "Управление паролями ".

Для следующих вложенных параметров поддерживаются -p/securepasswordследующие варианты:

Чтобы добавить пароль в защищенное хранилище для указанного идентификатора сервера или для всех идентификаторов сервера, определенных в файле подключения сервера. Параметр -overwrite ниже обновляет пароль, если он уже существует:

-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]
Чтобы удалить зашифрованный пароль из защищенного хранилища указанного идентификатора сервера или для всех идентификаторов сервера:

-p/securepassword -r/remove {<server_id> [, ...n] | all}
Чтобы отобразить список идентификаторов сервера, для которых зашифрован пароль:

-p/securepassword -l/list
Экспорт паролей, хранящихся в защищенном хранилище, в зашифрованный файл. Этот файл шифруется с помощью указанной пользователем парольной фразы.

-p/securepassword -e/export {<server-id> [, ...n] | all} <encrypted-password -file>
Зашифрованный файл, который был экспортирован ранее, импортируется в локально защищенное хранилище с помощью указанной пользователем парольной фразы. После расшифровки файла он хранится в новом файле, который, в свою очередь, шифруется на локальном компьютере.

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

Несколько идентификаторов сервера можно указать с помощью разделителей-запятыми.

Вариант справки: -?/Help

Отображает сводку синтаксиса параметров консоли SSMA:

C:\>SSMAforDB2Console.EXE -?

Табличное отображение параметров командной строки консоли SSMA см. в приложении 1 (DB2ToSQL).

Параметр справки SecurePassword: -securepassword -?/Help

Отображает сводку синтаксиса параметров консоли SSMA:

C:\>SSMAforDB2Console.EXE -securepassword -?

Табличное отображение параметров командной строки консоли SSMA см. в приложении 1 (DB2ToSQL)

Следующий шаг

Следующий шаг зависит от требований проекта:

Сведения об указании пароля или импорта паролей см. в разделе "Управление паролями" (DB2ToSQL).
Сведения о создании отчетов см. в разделе "Создание отчетов" (DB2ToSQL).
Сведения об устранении неполадок в консоли см. в разделе "Устранение неполадок" (DB2ToSQL).

Поделиться через

Параметры командной строки в консоли SSMA (DB2ToSQL)