Compartilhar via

Criar arquivos de script (AccessToSQL)

Antes de iniciar o aplicativo de console do SSMA (Assistente de Migração do SQL Server), crie o arquivo de script. Se necessário, crie o arquivo de valor variável e o arquivo de conexão do servidor.

O arquivo de script tem três seções:

  1. config: defina os parâmetros de configuração para o aplicativo de console.

  2. servers: defina as definições de servidor de origem e de destino. Você também pode colocar essas definições em um arquivo de conexão de servidor separado.

  3. script-commands: execute comandos de fluxo de trabalho do SSMA.

Cada seção é descrita em detalhes nas seguintes seções:

Definir configurações do console de acesso

O arquivo de script do console exibe as configurações de um script.

Se você especificar qualquer um dos elementos no nó de configuração, defina a configuração global para todos os comandos de script. Para substituir a configuração global, defina esses elementos de configuração dentro de cada comando na script-command seção.

Você pode configurar as seguintes opções:

  1. Provedor de janela de saída: se você definir o suppress-messages atributo como true, o console não exibirá as mensagens específicas do comando. Os atributos são:

    • destination: especifica se a saída é impressa em um arquivo ou stdout. Esse atributo é false por padrão.

    • file-name: o caminho do arquivo (opcional).

    • suppress-messages: suprime mensagens no console. Esse atributo é false por 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...>

  2. Provedor de Conexão de Migração de Dados: especifica qual servidor de origem ou destino usar para migração de dados. source-use-last-used indica que o último servidor de origem usado é usado para migração de dados. Da mesma forma, target-use-last-used indica que o último servidor de destino usado é usado para migração de dados. Use os source-server atributos ou target-server para especificar o servidor.

    Você só pode usar um dos seguintes atributos:

    • source-use-last-used="true" (padrão) ou source-server="source_servername"
    • target-use-last-used="true" (padrão) ou target-server="target_servername"

    Exemplo:

    <output-providers>
  <data-migration-connection   source-use-last-used="true"
                               target-server="target_1"/>
</output-providers>

    ou

    <migrate-data>
  <data-migration-connection   source-server="source_1"
                               target-use-last-used="true"/>
</migrate-data>

  3. Pop-up de Entrada do Usuário: manipula erros quando o console carrega objetos do banco de dados. O usuário fornece os modos de entrada e, se houver um erro, o console continuará conforme o usuário especifica.

    Os modos incluem:

    • ask-user: solicita que o usuário continue (yes) ou erro (no).
    • error: o console exibe um erro e interrompe a execução.
    • continue: o console continua com a execução.

    O modo padrão é error.

    Exemplo:

    <output-providers>
  <user-input-popup mode="<ask-user/continue/error>"/>
</output-providers>

    ou

    <!-- Connect to target database -->
<connect-target-database server="target_0">
  <user-input-popup mode="<ask-user/continue/error>"/>
</connect-target-database>

  4. Provedor de reconexão: define as configurações de reconexão se houver falhas de conexão. Defina essa opção para servidores de origem e de destino.

    Os modos de reconexão são:

    • reconnect-to-last-used-server: se a conexão não estiver ativa, ela tentará se reconectar ao último servidor usado no máximo cinco vezes.
    • generate-an-error: se a conexão não estiver ativa, o sistema gerará um erro.

    O modo padrão é generate-an-error.

    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_0">
  <reconnect-manager
    on-source-reconnect="reconnect-to-last-used-server"
    on-target-reconnect="generate-an-error"/>
</migrate-data>

  5. Provedor de Substituição do Conversor: use essa configuração para manipular objetos que já estão presentes na metabase de destino. As ações possíveis incluem:

    • error: o console exibe um erro e interrompe a execução.
    • overwrite: substitui valores de objeto existentes. Essa ação é o padrão.
    • skip: o console ignora os objetos que já existem no banco de dados.
    • ask-user: solicita ao usuário entrada (yes ou no).

    Exemplo:

    <output-providers>
  <object-overwrite action="<error|skip|overwrite|ask-user>"/>
</output-providers>

    ou

    <convert-schema object-name="ssma.TT1">
  <object-overwrite action="<error|skip|overwrite|ask-user>"/>
</convert-schema>

  6. Provedor de Pré-requisitos com falha: use essa configuração para lidar com os pré-requisitos necessários para processar um comando. Por padrão, strict-mode é false. Se você defini-lo como true, o sistema gerará uma exceção para falha ao atender aos pré-requisitos.

    Exemplo:

    <output-providers>
  <prerequisites strict-mode="<true|false>"/>
</output-providers>

  7. Parar operação: para interromper a operação durante a operação intermediária, use o atalho de teclado Ctrl+C . O Console do SSMA aguarda a conclusão da operação e encerra a execução do console.

    Se você quiser interromper a execução imediatamente, pressione o atalho de teclado Ctrl+C novamente para o encerramento abrupto do aplicativo console SSMA.

  8. Provedor de Progresso: informa o progresso de cada comando de console. Essa configuração é desabilitada por padrão. Os atributos de relatório de progresso compreendem:

    • off
    • every-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...>

  9. Verbosidade do logger: define o nível de verbosidade do log. Essa configuração corresponde à opção Todas as Categorias na interface do usuário. Por padrão, o nível de verbosidade do log é error.

    As opções no nível do logger incluem:

    • fatal-error: registra somente mensagens de erro fatais.
    • error: registra somente mensagens de erro e erros fatais.
    • warning: registra todos os níveis, exceto mensagens de debug e info.
    • info: registra todos os níveis, exceto mensagens de depuração.
    • debug: registra todos os níveis de mensagens.

    Observação

    O SSMA registra mensagens obrigatórias 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...>

  10. Substituir Senha Criptografada: Se true, a seção de definição do servidor do arquivo de conexão do servidor ou o arquivo de script usar a senha em texto claro para substituir a senha criptografada armazenada no armazenamento protegido, se existente. Se a senha em texto claro não for especificada, o usuário será solicitado a digitar a senha.

    Dois casos ocorrem:

    1. Se a opção de substituição for false, a ordem da pesquisa será armazenamento protegido > arquivo de script > arquivo de conexão do servidor > solicitar ao usuário.

    2. Se a opção de substituição fortrue, a ordem de pesquisa será: arquivo de script>, arquivo de conexão do servidor>, solicitar ao usuário.

    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 se reconectar. O console permite até cinco tentativas (5) de reconexão. Após essas novas tentativas, o console executa automaticamente a reconexão. O recurso de reconexão automática reduz o esforço para executar novamente o script.

Parâmetros de conexão de servidor

Você pode definir parâmetros de conexão de servidor 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 de fluxo de trabalho de migração no formato XML. O aplicativo console 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 do Access segue a hierarquia de: Tabela de Banco de Dados > .

Quando todos os comandos no arquivo de script são executados com êxito, o aplicativo console SSMA sai e retorna o controle para o usuário. O conteúdo de um arquivo de script é mais ou menos estático, com informações variáveis contidas em um arquivo criar valor variável ou em uma seção separada dentro do arquivo de script para valores variáveis.

Exemplo:

<!--Sample of script file commands -->
<ssma-script-file>
  <script-commands>
    <create-new-project project-folder="$project_folder$"
                        project-name="$project_name$"
                        overwrite-if-exists="true"/>
    <connect-source-database server="source_2"/>
    <save-project/>
    <close-project/>
  </script-commands>
</ssma-script-file>

A pasta Scripts de Console de Exemplo do diretório do produto fornece modelos que consistem em três arquivos de script (para executar diferentes cenários), um arquivo de valor variável e um arquivo de conexão com o servidor.

  • AssessmentReportGenerationSample.xml
  • ConversionAndDataMigrationSample.xml
  • VariableValueFileSample.xml
  • ServersConnectionFileSample.xml

Você pode executar os modelos depois de alterar os parâmetros para relevância.

Para obter uma lista completa de comandos de script, consulte Executar o Console do SSMA.

Validação de arquivo de script

Você pode validar o arquivo de script contra o arquivo A2SSConsoleScriptSchema.xsd de definição de esquema na pasta Schemas.

Conteúdo relacionado

  • Last updated on