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

Статья
01/02/2025

Помощник по миграции SQL Server (SSMA) предоставляет надежный набор параметров командной строки для выполнения и управления действиями Db2. В последующих разделах подробно описано то же самое.

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

В этом разделе описываются параметры команды консоли, которые также называются коммутаторами.

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

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

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

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

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 | сценарий

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

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

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

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

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

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

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

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 | подключение к серверу

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

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

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

Идентификаторы серверов используются в файле скрипта и определяют их в отдельном файле подключения к серверу. Файл подключения сервера использует переменные, определенные в файле значения переменной:
```
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
```

Определение сервера внедрено в файл скрипта:

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, например:

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

Пример синтаксиса:
```
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 отображается в самой консоли.

Пример синтаксиса:
```
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput
```

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

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

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

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. Этот параметр является необязательным.

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

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>
```
Несколько идентификаторов сервера можно указать с помощью разделителей запятых.

Вариант справки: -? | Справка

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

SSMAforDb2Console.exe -?

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

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

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

SSMAforDb2Console.exe -securepassword -?

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

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

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