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

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

Параметр preprocess запускает предварительную обработку. На этом этапе контроллер подготавливает для воспроизведения на целевом сервере входные данные трассировки.

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

Синтаксис


      dreplay preprocess [-mcontroller] -iinput_trace_file
    -dcontroller_working_dir [-cconfig_file] [-fstatus_interval]

Параметры

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

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

-iinput_trace_file Указывает полный путь входного файла трассировки на контроллере, например D:\Mytrace.trc. Параметр -i является обязательным.

При наличии в том же каталоге файлов продолжения они загружаются и используются автоматически. Файлы должны соответствовать соглашению об именовании переключения на файл продолжения, например: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, … Mytrace_n.trc.

Примечание.

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

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

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

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

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

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

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

-cconfig_file — полный путь к файлу конфигурации предварительной обработки; используется для указания расположения файла предварительной обработки при хранении в другом расположении. Этот параметр может быть путем в формате UNC или задавать локальный путь на компьютере, на котором выполняется средство администрирования.

Если фильтрация не требуется или не нужно изменять максимальное время простоя, то указывать параметр -c не обязательно.

Без параметра -c используется файл конфигурации предварительной обработки по умолчанию — DReplay.exe.preprocess.config.

-fstatus_interval Указывает частоту (в секундах), с которой будут отображаться сообщения о состоянии.

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

Примеры

В этом примере предварительная подготовка запускается со всеми параметрами по умолчанию. Значение localhost указывает, что служба контроллера запущена на том же компьютере, что и средство администрирования. Параметр input_trace_file задает расположение входных данных трассировки — c:\mytrace.trc. Так как фильтрация файлов трассировки не используется, указывать параметр -c не обязательно.

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

В этом примере запускается этап предварительной подготовки и указывается измененный файл конфигурации предварительной обработки. В отличие от предыдущего примера параметр -c используется для указания измененного файла конфигурации, сохраненного в другом расположении. Например:

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

В измененном файле конфигурации предварительной обработки добавлено условие фильтра, которое позволяет отфильтровать системные сеансы во время распределенного воспроизведения. Фильтр добавляется путем изменения элемента <PreprocessModifiers> в файле конфигурации предварительной обработки DReplay.exe.preprocess.config.

В следующем примере показан измененный файл конфигурации.

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

Разрешения

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

Дополнительные сведения см. в статье Distributed Replay Security.

См. также

Подготовка входных данных трассировки данныхSQL Server распределенное воспроизведение Configure распределенное воспроизведение