Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Antes de iniciar o aplicativo de console do SSMA (Assistente de Migração do SQL Server), você deve criar o arquivo de script. Se necessário, você também pode criar o arquivo de valor de variável e o arquivo de conexão do servidor.
O arquivo de script pode ser dividido em três seções:
| Seção | Descrição |
|---|---|
config |
Defina os parâmetros de configuração para o aplicativo de console. |
servers |
Defina as definições do servidor de origem/destino. Também pode estar em um arquivo separado de conexão com o servidor. |
script-commands |
Execute comandos de fluxo de trabalho do SSMA. |
Cada seção é descrita em detalhes neste artigo.
Definir as configurações do aplicativo de console do SSMA
As configurações de um script são exibidas no arquivo de script do console.
Se algum dos elementos for especificado no nó de configuração, eles serão definidos como a configuração global. Em outras palavras, eles se aplicam a todos os comandos de script. Esses elementos de configuração também podem ser definidos dentro de cada comando na seção script-command se você quiser substituir a configuração global.
As opções configuráveis pelo usuário incluem:
Provedor de Janela de Saída: se
suppress-messageso atributo estiver definido comotrue, as mensagens específicas do comando não serão exibidas no console.Atributo Descrição destinationEspecifica se a saída precisa ser impressa em um arquivo ou stdout. falsepor padrão.file-name(opcional)O caminho do arquivo. suppress-messagesSuprime mensagens no console. falsepor padrão.Exemplo:
<output-providers> <output-window suppress-messages="<true/false>" (optional) destination="<file/stdout>" (optional) file-name="<file-name>" (optional) /> </output-providers>ou
<...All commands...> <output-window suppress-messages="<true/false>" (optional) destination="<file/stdout>" (optional) file-name="<file-name>" (optional) /> </...All commands...>Provedor de Conexão de Migração de Dados: Especifica qual servidor de origem/destino deve ser considerado para migração de dados. Source-use-last-used indica que o último servidor de origem usado será empregado na migração de dados. Da mesma forma, target-use-last-used indica que o último servidor de destino usado será empregado na migração de dados. Você também pode especificar o servidor (origem ou destino) usando os atributos source-server ou target-server.
Apenas um desses atributos pode ser definido por vez:
-
source-use-last-used="true"(padrão) ousource-server="<source-server-unique-name>" -
target-use-last-used="true"(padrão) outarget-server="<target-server-unique-name>"
Exemplo:
<output-providers> <data-migration-connection source-use-last-used="true" target-server="<target-server-unique-name>"/> </output-providers>ou
<migrate-data> <data-migration-connection source-server="<source-server-unique-name>" target-use-last-used="true"/> </migrate-data>-
Janela pop-up para entrada do usuário: Permite tratar erros quando os objetos são carregados do banco de dados. Você fornece os modos de entrada e, se houver um erro, o console continuará conforme especificado.
Modo Descrição ask-userSolicita que você continue ( yes) ou erro (no).error(padrão)O console exibe um erro e interrompe a execução. continueO console continua com a execução. Exemplo:
<output-providers> <user-input-popup mode="<ask-user/continue/error>"/> </output-providers>ou
<!-- Connect to target database --> <connect-target-database server="<target-server-unique-name>"> <user-input-popup mode="<ask-user/continue/error>"/> </connect-target-database>Provedor de Reconexão: Permite definir as configurações de reconexão se houver uma falha de conexão. Pode ser definido para servidores de origem e de destino.
Modo de reconexão Descrição reconnect-to-last-used-serverSe a conexão não estiver ativa, ele tentará se reconectar ao último servidor usado cinco vezes no máximo. generate-an-error(padrão)Se a conexão não estiver ativa, um erro será gerado. Exemplo:
<output-providers> <reconnect-manager on-source-reconnect="<reconnect-to-last-used-server/generate-an-error>" on-target-reconnect="<reconnect-to-last-used-server/generate-an-error>"/> </output-providers>ou
<!--synchronization--> <synchronize-target> <reconnect-manager on-target-reconnect="reconnect-to-last-used-server"/> </synchronize-target>ou
<!--data migration--> <migrate-data server="<target-server-unique-name>"> <reconnect-manager on-source-reconnect="reconnect-to-last-used-server" on-target-reconnect="generate-an-error"/> </migrate-data>Provedor de Sobrescrita do Conversor: permite manipular objetos que já estão presentes no metabase de destino.
Ação Descrição errorO console exibe um erro e interrompe a execução. overwrite(padrão)Substitui os valores de objeto existentes. skipO console ignora os objetos que já existem no banco de dados. ask-userSolicita uma entrada ( yes/no).Exemplo:
<output-providers> <object-overwrite action="<error/skip/overwrite/ask-user>"/> </output-providers>ou
<convert-schema object-name="<object-name>"> <object-overwrite action="<error/skip/overwrite/ask-user>"/> </convert-schema>Provedor de pré-requisitos com falha: você pode manipular quaisquer pré-requisitos necessários para processar um comando. Por padrão,
strict-modeéfalse. Setrue, uma exceção é gerada por falha em atender aos pré-requisitos.Exemplo:
<output-providers> <prerequisites strict-mode="<true/false>"/> </output-providers>Parar operação: Durante o meio da operação, se você quiser interromper a operação, a tecla de atalho Ctrl+C pode ser usada. O aplicativo de console SSMA para SSMA aguarda a conclusão da operação e encerra a execução do console.
Se você quiser interromper a execução imediatamente, a tecla de atalho Ctrl+C poderá ser pressionada novamente para encerrar o aplicativo de console do SSMA.
Provedor de progresso: informa o andamento de cada comando do console. Desabilitado por padrão. Os atributos do relatório de progresso incluem:
offevery-1%every-2%every-5%every-10%every-20%
Exemplo:
<output-providers> progress-reporting enable="<true/false>" (optional) report-messages="<true/false>" (optional) report-progress="every-1%/every-2%/every-5%/every-10%/every-20%/off" (optional)/> </output-providers>ou
<...All commands...> <progress-reporting enable="<true/false>" (optional) report-messages="<true/false>" (optional) report-progress="every-1%/every-2%/every-5%/every-10%/every-20%/off" (optional)/> </...All commands...>Nível de Verbosidade do Logger: define o nível de verbosidade do log. Isso corresponde à opção Todas as categorias na interface do usuário.
Nível do logger Descrição fatal-errorSomente mensagens de erro fatal são registradas. error(padrão)Somente mensagens de erro e erro fatal são registradas. warningTodos os níveis, exceto mensagens de depuração e informações, são registrados em log. infoTodos os níveis, exceto as mensagens de depuração, são registrados. debugTodos os níveis de mensagens registradas. As mensagens obrigatórias são registradas em qualquer nível.
Exemplo:
<output-providers> <log-verbosity level="fatal-error/error/warning/info/debug"/> </output-providers>ou
<...All commands...> <log-verbosity level="fatal-error/error/warning/info/debug"/> </...All commands...>Substituir Senha Criptografada: Se
true, a senha em texto simples especificada na seção de definição do servidor do arquivo de conexão do servidor ou no arquivo de script, substituirá a senha criptografada armazenada no armazenamento protegido, se existir. Se nenhuma senha for especificada em texto não criptografado, você será solicitado a inserir a senha.Aqui, surgem dois casos:
Se a opção de substituição for falso, a ordem da pesquisa será o Armazenamento Protegido > Arquivo de Script > Arquivo de Conexão do Servidor > Usuário Prompt.
Se a opção de substituição for verdadeiro, a ordem da pesquisa será Arquivo de Script > Arquivo de Conexão do Servidor > Usuário Prompt.
Exemplo:
<output-providers> <encrypted-password override="<true/false>"/> </output-providers>
A opção não configurável é:
-
Máximo de tentativas de reconexão: quando uma conexão estabelecida atinge o tempo limite ou é interrompida devido a uma falha de rede, o servidor precisa ser reconectado. As tentativas de reconexão têm permissão máxima de
5novas tentativas após as quais o console executa automaticamente a reconexão. A facilidade de reconexão automática reduz o esforço em executar novamente o script.
Parâmetros de conexão do servidor
Os parâmetros de conexão do servidor podem ser definidos no arquivo de script ou no arquivo de conexão do servidor. Para obter mais informações, consulte Criar os arquivos de conexão do servidor.
Comandos de script
O arquivo de script contém uma sequência de comandos para o fluxo de trabalho de migração no formato XML. O aplicativo de console do SSMA processa a migração na ordem dos comandos que aparecem no arquivo de script.
Por exemplo, uma migração de dados típica de uma tabela específica em um banco de dados Db2 segue a hierarquia de >tabela.
Quando todos os comandos no arquivo de script forem executados com êxito, o aplicativo de console do SSMA será encerrado. O conteúdo de um arquivo de script é mais ou menos estático com informações variáveis contidas em um arquivo de valor variável ou em uma seção separada dentro do arquivo de script para valores variáveis.
Exemplo:
Aqui está um exemplo dos comandos do arquivo de script:
<ssma-script-file>
<script-commands>
<create-new-project project-folder="<project-folder>"
project-name="<project-name>"
overwrite-if-exists="<true/false>"/>
<connect-source-database server="<source-server-unique-name>"/>
<save-project/>
<close-project/>
</script-commands>
</ssma-script-file>
Modelos compostos por três arquivos de script (para executar vários cenários), um arquivo de valores de variáveis e um arquivo de conexão com o servidor são fornecidos na pasta Sample Console Scripts do diretório do produto:
AssessmentReportGenerationSample.xmlConversionAndDataMigrationSample.xmlSqlStatementConversionSample.xmlVariableValueFileSample.xmlServersConnectionFileSample.xml
Você pode executar os modelos (arquivos) depois de alterar os parâmetros exibidos neles conforme a relevância.
A lista completa de comandos de script pode ser encontrada em Executar o console do SSMA
Validação de arquivo de script
Você pode validar o arquivo de script em relação ao arquivo O2SSConsoleScriptSchema.xsdde definição de esquema, disponível na Schemas pasta.