Opção de pré-processamento (ferramenta de administração Distributed Replay)

  • Artigo

Aplica-se a: SQL Server 2016 (13.x) SQL Server 2017 (14.x) SQL Server 2019 (15.x)

Importante

O SQL Server Distributed Replay não está disponível no SQL Server 2022 (16.x).

A ferramenta de administração do Microsoft SQL Server Distributed Replay, DReplay.exe, é uma ferramenta de linha de comando que você pode usar para se comunicar com o controlador de reprodução distribuída. Este tópico descreve a opção de linha de comando preprocess e a sintaxe correspondente.

A opção preprocess inicia o estágio de pré-processamento. Durante esse estágio, o controlador prepara os dados de rastreamento de entrada para retomada contra o servidor de destino.

Para obter mais informações sobre as convenções de sintaxe usadas com a sintaxe de ferramenta de administração, confira Convenções da sintaxe Transact-SQL.

Sintaxe


dreplay preprocess [-m controller] -i input_trace_file  
    -d controller_working_dir [-c config_file] [-f status_interval]

Parâmetros

-mcontrolador
Especifica o nome do computador do controlador. Você pode usar "localhost" ou "." para fazer referência ao computador local.

Se o parâmetro -m não for especificado, será usado o computador local.

-iinput_trace_file
Especifica o caminho completo do arquivo de rastreamento de entrada no controlador, como D:\Mytrace.trc. O parâmetro -i é obrigatório.

Se houver arquivos de substituição no mesmo diretório, eles serão carregados e usados automaticamente. Os arquivos devem seguir a convenção de nomenclatura de substituição de arquivo, por exemplo: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, ... Mytrace_n.trc.

Observação

Se você estiver usando a ferramenta de administração em um computador diferente do controlador, precisará copiar os arquivos de rastreamento de entrada no controlador de forma que um caminho local possa ser usado para este parâmetro.

-ddiretório_trabalho_controlador
Especifica o diretório no controlador onde o arquivo intermediário será armazenado. O parâmetro -d é obrigatório.

Os seguintes requisitos são aplicados:

  • O diretório deve residir no controlador.

  • Você deve especificar o caminho completo, iniciando com uma letra da unidade (por exemplo, c:\WorkingDir).

  • O caminho não deve terminar com uma barra invertida "\".

  • Não há suporte para caminhos UNC.

-carquivo_de_configuração
É o caminho completo do arquivo de configuração de pré-processamento; usado para especificar o local do arquivo de configuração de pré-processamento quando armazenado em um local diferente. Esse parâmetro pode ser um caminho UNC ou pode residir localmente no computador onde você executa a ferramenta de administração.

O parâmetro -c não será obrigatório se nenhuma filtragem for necessária ou se você não desejar modificar o tempo ocioso máximo.

Sem o parâmetro -c , o arquivo de configuração de pré-processamento padrão, DReplay.exe.preprocess.config, será usado.

-fintervalo_de_status
Especifica a frequência (em segundos) na qual exibir mensagens de status.

Se -f não for especificado, o intervalo padrão será de 30 segundos.

Exemplos

Neste exemplo, o estágio de pré-processamento é iniciado com todas as configurações padrão. O valor localhost indica que o serviço do controlador está em execução no mesmo computador que a ferramenta de administração. O parâmetro input_trace_file especifica o local dos dados de rastreamento de entrada, c:\mytrace.trc. Como não há filtragem de arquivo de rastreamento envolvida, o parâmetro -c deve ser especificado.

dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir

Neste exemplo, o estágio de pré-processamento é iniciado e um arquivo de configuração de pré-processamento modificado é especificado. Ao contrário do exemplo anterior, o parâmetro -c é usado para apontar para o arquivo de configuração modificado, caso tenha armazenado esse arquivo em um local diferente. Por exemplo:

dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir -c c:\DReplay.exe.preprocess.config

No arquivo de configuração de pré-processamento modificado, é adicionada uma condição de filtro que filtra sessões de sistema durante reprodução distribuída. O filtro é adicionado modificando o elemento <PreprocessModifiers> no arquivo de configuração de pré-processamento, DReplay.exe.preprocess.config.

O exemplo a seguir mostra um arquivo de configuração modificado:

<?xml version='1.0'?> 
<Options> 
    <PreprocessModifiers> 
        <IncSystemSession>No</IncSystemSession> 
        <MaxIdleTime>-1</MaxIdleTime> 
    </PreprocessModifiers> 
</Options>

Permissões

Você deve executar a ferramenta de administração como um usuário interativo, um usuário local ou uma conta de usuário de domínio. Para usar uma conta de usuário local, a ferramenta de administração e o controlador devem estar em execução no mesmo computador.

Para saber mais, confira Distributed Replay Security.

Confira também