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

Область применения: SQL Server 2016 (13.x), SQL Server 2017 (14.x) и SQL Server 2019 (15.x)

Важно!

SQL Server распределенное воспроизведение недоступно с SQL Server 2022 (16.x).

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

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

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

Синтаксис


dreplay preprocess [-m controller] -i input_trace_file  
    -d controller_working_dir [-c config_file] [-f status_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.

Примечание

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

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

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

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

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

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

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

-cфайл_конфигурации
Полный путь к файлу конфигурации предварительной обработки. Используется для указания расположения конфигурации предварительной обработки, сохраненной в другом месте. Этот параметр может быть путем в формате 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.

См. также раздел