Opção de Pré-processamento (Ferramenta de Administração do Replay Distribuído)

Aplica-se a: SQL Server 2016 (13.x) SQL Server 2017 (14.x) SQL Server 2019 (15.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 de pré-processamento e a sintaxe correspondente.

A opção de pré-processo inicia o estágio de pré-processo. Durante esta etapa, o controlador prepara os dados de rastreamento de entrada para reproduzir no servidor de destino.

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

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 se referir ao computador local.

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

-Euinput_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 sobreposição no mesmo diretório, eles serão carregados e usados automaticamente. Os arquivos devem seguir a convenção de nomenclatura de rotação de arquivos, por exemplo: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, ... Mytrace_n.trc.

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

Aplicam-se os seguintes requisitos:

• O diretório deve residir no controlador.

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

• O caminho não deve terminar com um backslash "\".

• Os caminhos UNC não são suportados.

-cficheiro_de_configuração
É o caminho completo do arquivo de configuração de pré-processo; 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 é necessário se nenhuma filtragem for necessária ou se você não quiser 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, é usado.

-fintervalo_de_estado
Especifica a frequência (em segundos) na qual as mensagens de status devem ser exibidas.

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á sendo executado 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 precisa 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é-processo modificado é especificado. Ao contrário do exemplo anterior, o parâmetro -c é usado para apontar para o arquivo de configuração modificado, se você o tiver armazenado 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 as sessões do sistema durante a reprodução distribuída. O filtro é adicionado modificando o <PreprocessModifiers> elemento no arquivo de configuração de pré-processamento, DReplay.exe.preprocess.config.

A seguir mostra um exemplo do 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, como 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 obter mais informações, consulte Distributed Replay Security.

Ver também

• Preparar os dados de rastreamento de entrada
• Replaying Distribuído do SQL Server
• Configurar Distributed Replay