sp_changedynamicsnapshot_job (Transact-SQL)

Применимо к:SQL Server Управляемый экземпляр SQL Azure

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

  
sp_changedynamicsnapshot_job [ @publication = ] 'publication'  
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]  
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]  
    [ , [ @frequency_type = ] frequency_type ]   
    [ , [ @frequency_interval = ] frequency_interval ]   
    [ , [ @frequency_subday = ] frequency_subday ]   
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]   
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]   
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]   
    [ , [ @active_start_date = ] active_start_date ]   
    [ , [ @active_end_date = ] active_end_date ]   
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]   
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]   
    [ , [ @job_login = ] 'job_login' ]   
    [ , [ @job_password = ] 'job_password' ]   

Аргументы

[ @publication = ] 'publication' Имя публикации. публикация — sysname, без значения по умолчанию.

[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' Имя измененного задания моментального снимка. dynamic_snapshot_jobname — sysname( значение по умолчанию N'%). Если указан dynamic_snapshot_jobid, необходимо использовать значение по умолчанию для dynamic_snapshot_jobname.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' Идентификатор измененного задания моментального снимка. dynamic_snapshot_jobid является уникальным идентификатором по умолчанию со значением NULL. Если указан dynamic_snapshot_jobname, необходимо использовать значение по умолчанию для dynamic_snapshot_jobid.

[ @frequency_type = ] frequency_type Частота, с которой нужно запланировать агент. frequency_type имеет значение int и может быть одним из следующих значений.

значение	Description
1	Один раз.
2	по запросу
4	Ежедневно
8	Неделя
16	Месяц
32	Ежемесячно с относительной датой
64	Автозапуск
128	Повторяющееся задание
NULL (по умолчанию)

[ @frequency_interval = ] frequency_interval Дни выполнения агента. frequency_interval является int и может быть одним из следующих значений.

значение	Description
1	Воскресенье
2	Понедельник
3	Вторник
4	Среда
5	Четверг
6	Пятница
7	Суббота
8	день
9	По рабочим дням
10	По выходным дням
NULL (по умолчанию)

[ @frequency_subday = ] frequency_subday Как часто перепланировать расписание в течение определенного периода. frequency_subday является int и может быть одним из следующих значений.

значение	Description
1	Однократно
2	Second
4	Minute
8	Часы
NULL (по умолчанию)

[ @frequency_subday_interval = ] frequency_subday_interval Интервал для frequency_subday. frequency_subday_interval имеет значение int с значением NULL по умолчанию.

[ @frequency_relative_interval = ] frequency_relative_intervalДата запуска агент слияния. Этот параметр используется, если frequency_type имеет значение 32 (ежемесячное относительно). frequency_relative_interval является int и может быть одним из следующих значений.

значение	Description
1	First
2	Second
4	Третья
8	Четвертая
16	Last
NULL (по умолчанию)

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Является фактором повторения, используемым frequency_type. frequency_recurrence_factor имеет значение int с значением NULL по умолчанию.

[ @active_start_date = ] active_start_dateДата, когда агент слияния впервые запланировано, отформатировано как yyyyMMdd. active_start_date имеет значение int с значением NULL по умолчанию.

[ @active_end_date = ] active_end_dateДата, когда агент слияния перестает планироваться, отформатирована как yyyyMMdd. active_end_date имеет значение int с значением NULL по умолчанию.

[ @active_start_time_of_day = ] active_start_time_of_dayВремя дня, когда агент слияния впервые запланировано, отформатировано как HHmmss. active_start_time_of_day имеет значение int с значением NULL по умолчанию.

[ @active_end_time_of_day = ] active_end_time_of_dayВремя дня, когда агент слияния перестает планироваться, отформатировано как HHmmss. active_end_time_of_day имеет значение int с значением NULL по умолчанию.

[ @job_login = ] 'job_login'Учетная запись Microsoft Windows, в которой агент моментальных снимков выполняется при создании моментального снимка для подписки с помощью параметризованного фильтра строк. job_login — nvarchar(257) со значением NULL по умолчанию.

[ @job_password = ] 'job_password'Пароль учетной записи Windows, в которой выполняется агент моментальных снимков при создании моментального снимка для подписки с помощью параметризованного фильтра строк. job_password — nvarchar(257) со значением NULL по умолчанию.

Важно!

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

Значения кода возврата

0 (успешно) или 1 (сбой)

Замечания

sp_changedynamicsnapshot_job используется в реплика слияния для публикаций с параметризованными фильтрами строк.

После изменения имени входа и пароля агента необходимо остановить и повторно запустить агент, чтобы изменения вступили в силу.

Разрешения

Только члены предопределенных ролей сервера sysadmin или db_owner предопределенных ролей базы данных могут выполняться sp_changedynamicsnapshot_job.

См. также

Просмотр и изменение параметров безопасности репликации
Snapshots for Merge Publications with Parameterized Filters (Моментальные снимки для публикаций слиянием с параметризованными фильтрами)