Opção Replay (ferramenta de administração do Distributed Replay)

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 replay e a sintaxe correspondente.

A opção replay inicia o estágio de reprodução de eventos, no qual o controlador despacha dados de reprodução aos clientes especificados, inicia a reprodução distribuída e sincroniza os clientes. Opcionalmente, cada cliente que participa da reprodução pode gravar a atividade de reprodução e salvar um arquivo de rastreamento de resultado localmente.

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

Sintaxe

      dreplay replay [-mcontroller] -dcontroller_working_dir [-o]
    [-starget_server] -wclients [-cconfig_file]
    [-fstatus_interval]

Parâmetros

-m controller 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.

-d controller_working_dir 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.

-o Captura a atividade de repetição dos clientes e a salva em um arquivo de rastreamento de resultados no caminho especificado pelo <ResultDirectory> elemento no arquivo de configuração do cliente, DReplayClient.xml.

Quando o parâmetro -o não é especificado, o arquivo de rastreamento de resultado não é gerado. A saída do console retorna informações resumidas ao término da reprodução, mas nenhuma outra estatística de reprodução está disponível.

-s target_server Especifica a instância de destino do SQL Server na qual a carga de trabalho distribuída deve ser reproduzida. Você deve especificar esse parâmetro no formato server_name[\nome da instância] .

Você não pode usar "localhost" ou "." como o servidor de destino.

O parâmetro -s não será necessário se o elemento <Server> for especificado na seção <ReplayOptions> do arquivo de configuração de reprodução, DReplay.exe.replay.config.

Se o parâmetro -s for usado, o elemento <Server> na seção <ReplayOptions> do arquivo de configuração de reprodução será ignorado.

-w clients Esse parâmetro obrigatório é uma lista separada por vírgulas (sem espaços) que especifica os nomes de computador dos clientes que devem participar da reprodução distribuída. Endereços IP não são permitidos. Lembre-se de que os clientes já devem estar registrados com o controlador.

-c config_file É o caminho completo do arquivo de configuração de repetição; usado para especificar o local quando ele é armazenado em um local diferente.

O parâmetro -c não será necessário se você quiser usar os valores padrão do arquivo de configuração de reprodução, DReplay.exe.replay.config.

-f status_interval Especifica a frequência (em segundos) na qual exibir o status.

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

Exemplos

Neste exemplo, a reprodução distribuída deriva muito de seu comportamento a partir de um arquivo de configuração de reprodução modificado, DReplay.exe.replay.config.

• O parâmetro -m especifica que um computador denominado controller1 atua como o controlador. O nome do computador deve ser especificado quando o serviço de controlador é executado em um computador diferente.

• O parâmetro -d especifica o local do arquivo intermediário no controlador, c:\WorkingDir.

• O parâmetro -o especifica que cada cliente especificado captura a atividade de reprodução e salva-a em um arquivo de rastreamento de resultado. Observação: O elemento <ResultTrace> no arquivo de configuração pode ser usado para especificar se a contagem de linhas e o conjunto de resultados são registrados.

• O parâmetro -w especifica que os computadores client1 a client4 participam como clientes na reprodução distribuída.

• O parâmetro -c é usado para apontar para o arquivo de configuração modificado, DReplay.exe.replay.config.

• O parâmetro -s não é necessário porque o elemento <Server> é especificado no elemento <ReplayOptions> do arquivo de configuração de reprodução, DReplay.exe.replay.config.

O estágio de reprodução de eventos é iniciado com a sintaxe a seguir, quando a ferramenta de administração é executada a partir de um computador diferente do controlador:

dreplay replay -m controller1 -d c:\WorkingDir -o -w client1,client2,client3,client4 -c c:\DReplay.exe.replay.config

Para especificar um modo de sequenciamento síncrono, o elemento <SequencingMode> do arquivo DReplay.exe.replay.config é definido igual ao valor synchronization. A seção <ResultTrace> do arquivo de configuração de reprodução é modificado para especificar que a contagem de linhas seja registrada. Essas alterações são mostradas no seguinte exemplo XML:

<?xml version='1.0'?>
<Options>
    <ReplayOptions>
        <Server>server_name\replay_target_instance</Server>
        <SequencingMode>synchronization</SequencingMode>
        <ConnectTimeScale></ConnectTimeScale>
        <ThinkTimeScale></ThinkTimeScale>
        <HealthmonInterval>60</HealthmonInterval>
        <QueryTimeout>3600</QueryTimeout>
        <ThreadsPerClient></ThreadsPerClient>
    </ReplayOptions>
    <OutputOptions>
        <ResultTrace>
            <RecordRowCount>Yes</RecordRowCount>
            <RecordResultSet>No</RecordResultSet>
        </ResultTrace>
    </OutputOptions>
</Options>

Para especificar um modo de sequenciamento de estresse, o elemento <SequencingMode> do arquivo DReplay.exe.replay.config é definido igual ao valor stress. Os elementos <ConnectTimeScale> e <ThinkTimeScale> são definidos como o valor 50 (para especificar 50 por cento). Para obter mais informações sobre tempo de conexão e tempo de raciocínio, consulte Configure Distributed Replay. Essas alterações são mostradas no seguinte exemplo XML:

<?xml version='1.0'?>
<Options>
    <ReplayOptions>
        <Server>server_name\replay_target_instance_name</Server>
        <SequencingMode>stress</SequencingMode>
        <ConnectTimeScale>50</ConnectTimeScale>
        <ThinkTimeScale>50</ThinkTimeScale>
        <HealthmonInterval>60</HealthmonInterval>
        <QueryTimeout>3600</QueryTimeout>
        <ThreadsPerClient></ThreadsPerClient>
    </ReplayOptions>
    <OutputOptions>
        <ResultTrace>
            <RecordRowCount>Yes</RecordRowCount>
            <RecordResultSet>No</RecordResultSet>
        </ResultTrace>
    </OutputOptions>
</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

Reproduzir dadosde rastreamento Examinar os resultadosda repetição Reprodução distribuídado SQL Server Configurar a reproduçãodistribuída Fórumde reprodução distribuída do SQL Server Usando a reprodução distribuída para testar a carga do SQL Server – Parte 2Usando a reprodução distribuída para testar a carga do SQL Server – Parte 1