Compartilhar via

Opções de linha de comando no console do SSMA (Db2ToSQL)

  • Artigo

O SQL Server Migration Assistant (SSMA) fornece um conjunto robusto de opções de linha de comando para executar e controlar as atividades do Db2. As seções a seguir detalham o mesmo.

Opções de linha de comando no console do SSMA

Esta seção descreve as opções de comando do console, também conhecidas como opções.

As opções não diferenciam maiúsculas de minúsculas e podem começar com um ou - / caractere.

Se as opções forem especificadas, você deverá especificar os parâmetros de opção correspondentes.

Os parâmetros de opção devem ser separados do caractere de opção por espaço 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 arquivos contendo espaços devem ser especificados entre aspas duplas.

A saída de entradas de linha de comando e as mensagens de erro são armazenadas em STDOUT ou em um arquivo especificado.

Opção de arquivo de script: -s | roteiro

Uma opção obrigatória, o caminho/nome do arquivo de script especifica o script de sequências de comando 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 arquivo de valor variável: -v | variável

Este arquivo inclui as variáveis usadas no arquivo de script. Este parâmetro é opcional. Se as variáveis não forem declaradas no arquivo de variável e usadas no arquivo de script, o aplicativo gerará um erro e encerrará a execução do console.

Exemplo de sintaxe:

Variáveis definidas em vários arquivos de 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 arquivo de variável especificado nos argumentos da linha de comando assume a preferência, caso haja uma 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 arquivo de conexão do servidor: -c | conexão de servidor

Este arquivo contém informações de conexão do servidor para cada servidor. Cada definição de servidor é identificada por uma ID de servidor exclusiva. As IDs do servidor são referenciadas no arquivo de script para comandos relacionados à conexão.

A definição do servidor pode fazer parte do arquivo de conexão do servidor e/ou do arquivo de script. A ID do servidor no arquivo de script tem precedência sobre o arquivo de conexão do servidor, caso haja uma duplicação da ID do servidor.

Exemplos de sintaxe:

  • As IDs de servidor são usadas no arquivo de script e você as define em um arquivo de conexão de servidor separado. O arquivo de conexão do servidor usa variáveis, que são definidas no arquivo de valor de 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 é incorporada ao arquivo 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 ]

Esse comando é usado para gerar as mensagens de saída do comando em um formato XML para o console ou para um arquivo XML.

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

  • Se o caminho do arquivo for fornecido após a xmloutput alternância, a saída será redirecionada para o arquivo.

    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 nenhum caminho de arquivo for fornecido após a xmloutput troca, o xmlout será exibido no próprio console.

    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 arquivo de log: -l | tora

Todas as operações do SSMA no aplicativo Console são registradas em um arquivo de log. Este parâmetro é opcional. Se um arquivo de log e seu caminho forem especificados na linha de comando, o log será gerado no local especificado. Caso contrário, ele será gerado em sua localização padrão.

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 de pasta de ambiente de projeto: -e | projetoambiente

Indica a pasta de configurações do ambiente do projeto do SSMA atual. Este parâmetro é 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 senha segura: -p | senha segura

Esta opção indica a senha criptografada para conexões de servidor. Ele difere de todas as outras opções: a opção não executa nenhum script ou ajuda em nenhuma atividade relacionada à migração. Em vez disso, ele ajuda a gerenciar a criptografia de senha para as conexões de servidor usadas no projeto de migração.

Você não pode inserir nenhuma outra opção ou senha como o parâmetro de linha de comando. Caso contrário, isso resultará em um erro. Para obter mais informações, consulte Gerenciar senhas.

As seguintes subopções são compatíveis com -p | securepassword:

  • Para adicionar uma senha ao armazenamento protegido para uma ID de servidor especificada ou todas as IDs de servidor definidas no arquivo de conexão do servidor. A -overwrite opção atualiza a senha se ela 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 senha criptografada do armazenamento protegido da ID do servidor especificada ou para todas as IDs do servidor:

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

  • Para exibir uma lista de IDs de servidor para as quais a senha é criptografada:

    -p | securepassword -l | list

  • Para exportar as senhas salvas no armazenamento protegido para um arquivo criptografado. Este arquivo está criptografado com a senha especificada pelo usuário.

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

  • O arquivo criptografado, exportado anteriormente, é importado para o armazenamento local protegido usando a senha especificada pelo usuário. Depois que o arquivo é descriptografado, ele é armazenado em um novo arquivo, que, por sua vez, é criptografado na máquina local.

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

    Várias IDs de servidor podem ser especificadas usando separadores de vírgula.

Opção de ajuda: -? | Ajuda

Exibe o resumo da sintaxe das opções do console do SSMA:

SSMAforDb2Console.exe -?

Para obter uma exibição tabular das opções de linha de comando do console do SSMA, consulte o Apêndice 1: Opções de linha de comando do console.

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

Exibe o resumo da sintaxe das opções do console do SSMA:

SSMAforDb2Console.exe -securepassword -?

Para obter uma exibição tabular das opções de linha de comando do console do SSMA, consulte o Apêndice 1: Opções de linha de comando do console

Conteúdo relacionado