SSMA 控制台中的命令行选项 (Db2ToSQL)

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

此文件包含每个服务器的服务器连接信息。 每个服务器定义都用唯一的服务器 ID 来标识。 服务器 ID 在脚本文件中引用,用于连接相关命令。

服务器定义可能是服务器连接文件和/或脚本文件的一部分。 脚本文件中的服务器 ID 优先于服务器连接文件,以防服务器 ID 重复。

语法示例:

  • 服务器 ID 用于脚本文件中,并在单独的服务器连接文件中定义它们。 服务器连接文件使用变量,这些变量在变量值文件中定义:

    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 支持以下子选项:

  • 针对指定的服务器 ID 或在服务器连接文件中定义的所有服务器 ID,为受保护存储添加密码。 如果密码已存在,则 -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]
    
  • 要从指定服务器 ID 的受保护存储或所有服务器 ID 的受保护存储中删除加密密码:

    -p | securepassword -r | remove { <server_id> [, ...n] | all }
    
  • 显示其密码已加密的服务器 ID 的列表:

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

    可以使用逗号分隔符指定多个服务器 ID。

帮助选项:-? |帮助

显示 SSMA 控制台选项的语法摘要:

SSMAforDb2Console.exe -?

有关 SSMA 控制台命令行选项的表格显示,请参阅 附录 1:控制台命令行选项

SecurePassword 帮助选项:-securepassword -? |帮助

显示 SSMA 控制台选项的语法摘要:

SSMAforDb2Console.exe -securepassword -?

有关 SSMA 控制台命令行选项的表格显示,请参阅 附录 1:控制台命令行选项