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

  • Artigo

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

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

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

No contexto desta 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 forem especificadas opções, será obrigatório especificar também 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:

    C:\> SSMAforSybaseConsole.EXE -s scriptfile

    C:\> SSMAforSybaseConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\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 as 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 das sequências de comando a serem executadas pelo SSMA.

Exemplos de sintaxe:

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

Opção de arquivo de valores de variáveis: -v/variable

Este arquivo inclui as 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áveis especificado nos argumentos da linha de comando tem a preferência, caso haja uma duplicação de variáveis:

    C:\>SSMAforSybaseConsole.EXE -s

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

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 do servidor são usadas no arquivo de script e definidas em um arquivo de conexão de servidor separado, que usa variáveis definidas no arquivo de valores de variáveis:

    C:\>SSMAforSybaseConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\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:

    C:\>SSMAforSybaseConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\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 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:\>SSMAforSybaseConsole.EXE -s

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

  • Se nenhum caminho de arquivo for fornecido após o parâmetro xmloutput, o xmlout será exibido no próprio console.

    Exemplo de sintaxe:

    C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\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:\>SSMAforSybaseConsole.EXE

"C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\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 de SSMA atual. Este parâmetro é opcional.

Exemplo de sintaxe:

C:\>SSMAforSybaseConsole.EXE -s

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

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

Esta opção indica a senha criptografada para conexões de servidor. Ela difere de todas as outras opções: pois 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 outra opção ou senha como parâmetro da linha de comando. Caso contrário, isso resultará em um erro. Para obter mais informações, veja a seção Gerenciamento de senhas.

As opções secundárias a seguir são compatíveis com -p/securepassword:

  • Para adicionar uma senha ao armazenamento protegido para uma ID de servidor especificada ou para todas as IDs de servidor definidas no arquivo de conexão do servidor. A opção -substituir, 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 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. Assim que é descriptografado, o arquivo é 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: --?/Help

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

C:\>SSMAforSybaseConsole.EXE -?

Para obter uma exibição tabular das opções de linha de comando do Console do SSMA, veja o Apêndice - 1 (SybaseToSQL).

Opção de ajuda Senha segura: -securepassword -?/Help

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

C:\>SSMAforSybaseConsole.EXE -securepassword -?

Para obter uma exibição tabular das opções de linha de comando do Console do SSMA, veja o Apêndice - 1 (SybaseToSQL)

Próxima etapa

A próxima etapa depende dos requisitos do projeto: