Параметр предварительной обработки (средство администрирования распределенного воспроизведения)
Область применения:
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 не задан, то используется локальный компьютер.
-i input_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.
-f status_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.