Поделиться через


Параметр воспроизведения (средство администрирования распределенного воспроизведения)

Средство администрирования программы распределенного воспроизведения Microsoft SQL Server (DReplay.exe) представляет собой программу командной строки, которая служит для взаимодействия с контроллером распределенного воспроизведения. В этом разделе описан параметр командной строки replay и соответствующий синтаксис.

Параметр replay инициирует стадию воспроизведения события, на которой данные воспроизведения отправляются указанным клиентам, запускается распределенное воспроизведение и синхронизируются клиенты. При необходимости каждый клиент, участвующий в воспроизведении, может записывать последовательность воспроизведения и сохранять получившиеся файлы трассировки в локальном кэше.

Значок ссылки на раздел Дополнительные сведения о синтаксических обозначениях, используемых в синтаксисе средства администрирования, см. в разделе Синтаксические обозначения в Transact-SQL (Transact-SQL).

Синтаксис

dreplay replay [-m controller] -d controller_working_dir [-o]
    [-s target_server] -w clients [-c config_file]
    [-f status_interval]

Параметры

  • -m controller
    Задает имя компьютера для контроллера. Локальный компьютер можно указать как «localhost» или «.».

    Если параметр -m не задан, то используется локальный компьютер.

  • -d controller_working_dir
    Указывает каталог на контроллере, где будет сохранен промежуточный файл. Параметр -d является обязательным.

    К нему предъявляются следующие требования.

    • Каталог должен находиться на контроллере.

    • Должен быть указан полный путь, начиная с буквы диска (например, c:\WorkingDir).

    • Путь не должен завершаться обратной косой чертой «\».

    • Пути в формате UNC не поддерживаются.

  • -o
    Отслеживает действие воспроизведения клиента и сохраняет его в итоговом файле трассировки в каталоге, указанном элементом <ResultDirectory> в файле конфигурации клиента DReplayClient.xml.

    Если параметр –o не задан, итоговый файл трассировки не создается. В конце воспроизведения консоль возвращает сводные данные, но остальная статистика воспроизведения недоступна.

  • -s target_server
    Указывает целевой экземпляр SQL Server, на котором требуется воспроизвести распределенную рабочую нагрузку. Необходимо задать этот параметр в формате server_name[\instance name].

    Недопустимо использовать в качестве целевого сервера «localhost» или «.».

    Параметр -s не является обязательным, если элемент <Server> задан в секции <ReplayOptions> файла конфигурации воспроизведения DReplay.exe.replay.config.

    Если используется параметр -s, элемент <Server> в секции <ReplayOptions> файла конфигурации воспроизведения не будет учитываться.

  • -w clients
    Требуемым параметром является список с разделителями-запятыми (без пробелов), содержащий имена компьютеров клиентов, которые должны участвовать в распределенном воспроизведении. IP-адреса недопустимы. Помните, что клиенты должны быть уже зарегистрированы на контроллере.

    ПримечаниеПримечание

    Каждый клиент регистрируется на контроллере, который указывается в файле конфигурации клиента при запуске службы клиента.

  • -c config_file
    Полный путь к файлу конфигурации воспроизведения; используется для указания расположения, если оно отличается от расположения по умолчанию.

    Параметр -c не является обязательным, если предполагается использовать стандартные значения файла конфигурации воспроизведения DReplay.exe.replay.config.

  • -f status_interval
    Указывает частоту (в секундах) отображения состояния.

    Если параметр -f не задан, интервал по умолчанию составляет 30 секунд.

Примеры

В данном примере распределенное воспроизведение наследует большую часть своего поведения из измененного файла конфигурации воспроизведения DReplay.exe.replay.config.

  • Параметр -m указывает, что в качестве контроллера выступает компьютер controller1. Имя компьютера нужно указывать, если служба контроллера работает на другом компьютере.

  • Параметр -d указывает расположение на контроллере промежуточного файла c:\WorkingDir.

  • Параметр -o указывает, что каждый указанный клиент захватывает действие воспроизведения и сохраняет его в результирующем файле трассировки. Примечание. При помощи элемента <ResultTrace> файла конфигурации можно указать, следует ли записывать количество строк и результирующий набор.

  • Параметр -w указывает, что компьютеры client1 — client4 являются клиентами распределенного воспроизведения.

  • Параметр -c указывает на измененный файл конфигурации DReplay.exe.replay.config.

  • Параметр -s не является обязательным, так как элемент <Server> задан в элементе <ReplayOptions> файла конфигурации воспроизведения DReplay.exe.replay.config.

Этап воспроизведения событий инициируется следующим синтаксисом, когда средство администрирования запускается не на контроллере:

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

Чтобы установить синхронный режим последовательного выполнения, элементу <SequencingMode> в файле DReplay.exe.replay.config нужно присвоить значение synchronization. Раздел <ResultTrace> файла конфигурации воспроизведения изменен для указания записи количества строк. Эти изменения показаны в следующем примере 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>

Чтобы установить режим нагрузки последовательного выполнения, элементу <SequencingMode> в файле DReplay.exe.replay.config нужно присвоить значение stress. Элементам <ConnectTimeScale> и <ThinkTimeScale> присваивается значение 50 (что означает 50 процентов). Дополнительные сведения о времени соединения и времени обработки см. в разделе Настройка распределенного воспроизведения. Эти изменения показаны в следующем примере 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>

Разрешения

Средство администрирования должно запускаться как интерактивный пользователь, с учетной записью локального пользователя или пользователя домена. Для использования учетной записи локального пользователя средство администрирования и контроллер должны быть запущены на одном компьютере.

Дополнительные сведения см. в разделе Безопасность распределенного воспроизведения.

См. также

Задания

Воспроизведение данные трассировки

Основные понятия

просмотреть результаты воспроизведения

Распределенное воспроизведение SQL Server

Настройка распределенного воспроизведения

Другие ресурсы

Форум о распределенном воспроизведении SQL Server

Использование распределенного воспроизведения для нагрузочного теста SQL Server. Часть 2

Использование распределенного воспроизведения для нагрузочного теста SQL Server. Часть 1