Opções de linha de comandos na consola SSMA (Db2ToSQL)

O Assistente de Migração do SQL Server (SSMA) oferece-lhe um conjunto robusto de opções de linha de comandos para executar e controlar as atividades do Db2. As secções seguintes detalham o mesmo.

Opções de linha de comandos na consola SSMA

Esta secção descreve as opções de comandos da consola, também conhecidas como interruptores.

As opções não fazem distinção entre maiúsculas e minúsculas e podem começar com o carácter - ou com o carácter /.

Se as opções forem especificadas, deve especificar os parâmetros correspondentes da opção.

Os parâmetros da opção devem ser separados do carácter opção por espaços em branco.

Exemplos de sintaxe:

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"

Pastas e nomes de ficheiros que contenham espaços devem ser especificados entre aspas duplas.

A saída das entradas da linha de comandos e das mensagens de erro é armazenada em STDOUT ou num ficheiro especificado.

Opção de ficheiro de script: -s | Script

Uma opção obrigatória: o caminho/nome do ficheiro de script especifica o script com as sequências de comandos que o SSMA executa.

Exemplo de sintaxe:

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

Opção de ficheiro de valor variável: -v | variável

Este ficheiro compreende variáveis usadas no ficheiro de script. Este interruptor é opcional. Se as variáveis não forem declaradas no ficheiro variável e usadas no ficheiro de script, a aplicação gera um erro e termina a execução na consola.

Exemplo de sintaxe:

Variáveis definidas em ficheiros de múltiplos valores de variáveis, talvez um com um valor padrão e outro com um valor específico de instância quando aplicável. O último ficheiro de variável especificado nos argumentos da linha de comandos tem a preferência, caso haja duplicação de variáveis:

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"

Opção de ficheiro de ligação ao servidor: -c | ServerConnection

Este arquivo contém informações de conexão do servidor para cada servidor. Cada definição de servidor é identificada por um ID de servidor único. Os IDs do servidor são referenciados no ficheiro de script para comandos relacionados com a ligação.

A definição do servidor pode fazer parte do ficheiro de ligação ao servidor e/ou do ficheiro de script. O ID do servidor no ficheiro de script tem prioridade sobre o ficheiro de ligação ao servidor, caso haja duplicação do ID do servidor.

Exemplos de sintaxe:

  • Os IDs de servidor são usados no ficheiro de script e são definidos num ficheiro de ligação ao servidor separado. O ficheiro de ligação ao servidor utiliza variáveis, que são definidas no ficheiro de valor da variável:

    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

  • A definição do servidor está incorporada no ficheiro de script:

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

Opção de saída XML: -x | xmloutput [ xmloutputfile ]

Este comando é usado para enviar as mensagens de saída do comando num formato XML, seja para a consola ou para um ficheiro XML.

Existem duas opções disponíveis para xmloutput, por exemplo:

  • Se o caminho do ficheiro for fornecido após a xmloutput troca, a saída é redirecionada para o ficheiro.

    Exemplo de sintaxe:

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

  • Se não for fornecido nenhum caminho de ficheiro após a opção xmloutput, o xmlout é apresentado na própria consola.

    Exemplo de sintaxe:

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

Opção de ficheiro de registo: -l | log

Todas as operações SSMA na aplicação Console são registadas num ficheiro de registo. Este interruptor é opcional. Se um ficheiro de registo e o seu caminho forem especificados na linha de comandos, o registo é gerado na localização especificada. Caso contrário, é gerado na sua localização predefinida.

Exemplo de sintaxe:

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

Opção da pasta do ambiente do projeto: -e | projectenvironment

Indica a pasta de definições do ambiente do projeto atual do SSMA. Este interruptor é opcional.

Exemplo de sintaxe:

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

Opção de palavra-passe segura: -p | securepassword

Esta opção indica a palavra-passe encriptada para as ligações ao servidor. Difere de todas as outras opções: a opção não executa nenhum script, nem ajuda em atividades relacionadas com migração. Em vez disso, ajuda a gerir a encriptação das palavras-passe para as ligações ao servidor utilizadas no projeto de migração.

Não podes introduzir nenhuma outra opção ou palavra-passe como parâmetro da linha de comandos. Caso contrário, resulta num erro. Para mais informações, consulte Gerir Palavras-Passe.

As seguintes subopções são suportadas para -p | securepassword:

  • Para adicionar palavra-passe ao armazenamento protegido para um ID de servidor especificado ou para todos os IDs de servidor definidos no ficheiro de ligação ao servidor. A -overwrite opção atualiza a palavra-passe se esta já existir:

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

  • Para remover a palavra-passe encriptada do armazenamento protegido do ID do Servidor especificado ou para todos os IDs do Servidor:

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

  • Para mostrar uma lista de IDs de servidor para os quais a palavra-passe está encriptada:

    -p | securepassword -l | list

  • Para exportar as palavras-passe armazenadas em armazenamento protegido para um ficheiro encriptado. Este ficheiro é encriptado com a frase de acesso especificada pelo utilizador.

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

  • O ficheiro encriptado que foi exportado anteriormente é importado para armazenamento protegido local usando a palavra-passe especificada pelo utilizador. Depois de desencriptado, o ficheiro é armazenado num novo ficheiro, que por sua vez é encriptado na máquina local.

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

    Múltiplos IDs de servidor podem ser especificados usando separadores de vírgula.

Opção de ajuda: -? | ajuda

Apresenta o resumo sintático das opções da consola SSMA:

SSMAforDb2Console.exe -?

Para uma visualização tabular das opções da linha de comandos da consola SSMA, consulte o Apêndice 1: Opções da linha de comandos da consola.

Opção de ajuda do SecurePassword: -securepassword -? | ajuda

Apresenta o resumo sintático das opções da consola SSMA:

SSMAforDb2Console.exe -securepassword -?

Para uma visualização tabular das opções da linha de comandos da consola SSMA, veja o Apêndice 1: Opções da linha de comandos da consola

Conteúdo relacionado

  • Última atualização a