Share via

Opções de linha de comando no Console do SSMA (MySQLToSQL)

  • Artigo

A Microsoft fornece um conjunto robusto de opções de linha de comando para executar e controlar atividades do SSMA. As seções a seguir detalham a mesma coisa.

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

Aqui estão descritas as opções de comando do console.

Para efeitos da presente seção, o termo “opção” é também chamado de “parâmetro”.

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

Se as opções forem especificadas, torna-se obrigatório especificar os parâmetros de opção correspondentes.

Os parâmetros de opção devem ser separados do caractere de opção por um espaço em branco.

Exemplos de sintaxe:

C:\> SSMAforMySQLConsole.EXE -s scriptfile

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

Os nomes de pastas ou arquivos que contêm espaços devem ser especificados entre aspas duplas.

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

Opção de arquivo de script: -s/script

Um parâmetro obrigatório, o caminho/nome do arquivo de script especifica o script de sequências de comando a serem executadas pelo SSMA.

Exemplos de sintaxe:

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

Opção de arquivo de valor variável: -v/variable

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

Exemplos 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 tem a preferência, caso haja uma duplicação de variáveis:

C:\>SSMAforMySQLConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\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/serverconnection

Esse 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 do servidor são usadas no arquivo de script e são definidas 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 da variável:

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

c:\SsmaProjects\myvaluefile1.xml -c

c:\SsmaProjects\myserverconnectionsfile1.xml

A definição do servidor é incorporada no arquivo de script:

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

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

Esse comando é usado para enviar 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, viz..,:

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

    Exemplo de sintaxe:

    C:\>SSMAforMySQLConsole.EXE -s

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

  • Se nenhum caminho de arquivo for fornecido após a opção xmloutput, o xmlout será exibido no próprio console.

    Exemplo de sintaxe:

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

Opção de arquivo de log: -l/log

Todas as operações do SSMA no aplicativo Console são registradas em um arquivo de log. Este é um 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 seu local padrão.

Exemplo de sintaxe:

C:\>SSMAforMySQLConsole.EXE

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

Opção de pasta do ambiente do projeto: -e/projectenvironment

Indica a pasta de configurações do ambiente do projeto para o projeto do SSMA atual. Este parâmetro é opcional.

Exemplo de sintaxe:

C:\>SSMAforMySQLConsole.EXE -s

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

Opção de senha segura: -p/securepassword

Essa opção indica a senha criptografada para conexões de servidor. Ela difere de todas as outras opções: a opção não executa nenhum script nem ajuda em nenhuma atividade relacionada à migração, mas ajuda a gerenciar a criptografia de senha para as conexões de servidor usadas no projeto de migração.

Não é possível inserir nenhuma outra opção ou senha como parâmetro de linha de comando. Caso contrário, isso resultará em um erro. Para obter mais informações, confira a seção 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 opção -overwrite, abaixo, atualiza a senha caso ela já exista:

    -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 específica ou para todas as IDs de 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. Uma vez que o arquivo é descriptografado, ele é armazenado em um novo arquivo, que, por sua vez, é criptografado no computador 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: -?/Help

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

C:\>SSMAforMySQLConsole.EXE -?

Para obter uma exibição tabular das opções de linha de comandos do console do SSMA, consulte o Apêndice — 1 (MySQLToSQL).

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

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

C:\>SSMAforMySQLConsole.EXE -securepassword -?

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

Próxima etapa

A próxima etapa depende dos requisitos do seu projeto: