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

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

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

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

Синтаксис

dreplay preprocess [-m controller] -i input_trace_file
    -d controller_working_dir [-c config_file] [-f status_interval]

Параметры

• -m controller
  Задает имя компьютера для контроллера. Локальный компьютер можно указать как «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 controller_working_dir
  Указывает каталог на контроллере, где будет сохранен промежуточный файл. Параметр -d является обязательным.

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

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

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

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

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

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

Разрешения

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

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

См. также

Задания

Подготовка входных данных трассировки

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

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

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