sp_changedynamicsnapshot_job (Transact-SQL)
Модифицирует задание агента, формирующее моментальный снимок для подписки на публикацию с параметризованным фильтром строк. Эта хранимая процедура выполняется на издателе в базе данных публикации.
Синтаксические обозначения в 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'
Имя публикации. Аргумент 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 имеет тип uniqueidentifier и значение по умолчанию NULL. Если задан аргумент dynamic_snapshot_jobname, то для аргумента dynamic_snapshot_jobid должно использоваться значение по умолчанию.[ @frequency_type = ] frequency_type
Частота запуска агента по расписанию. Аргумент frequency_type имеет тип int и может принимать одно из следующих значений.Значение
Описание
1
Однократно
2
По запросу
4
Ежедневно
8
Еженедельно
16
Ежемесячно
32
Ежемесячно с относительной датой
64
Автозапуск
128
Повторяющееся задание
NULL (по умолчанию)
[ @frequency_interval = ] frequency_interval
Дни запуска агента. Аргумент frequency_interval имеет тип int и может принимать одно из следующих значений.Значение
Описание
1
Воскресенье
2
Понедельник
3
Вторник
4
Среда
5
Четверг
6
Пятница
7
Суббота
8
День
9
По рабочим дням
10
По выходным дням
NULL (по умолчанию)
[ @frequency_subday = ] frequency_subday
Частота повторного планирования в течение определенного периода. Аргумент frequency_subday имеет тип int и может принимать одно из следующих значений.Значение
Описание
1
Однократно
2
Секунда
4
Минута
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 и может принимать одно из следующих значений.Значение
Описание
1
Первый
2
Второй
4
Третий
8
Четвертый
16
Последний
NULL (по умолчанию)
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Коэффициент повторения, используемый аргументом frequency_type. Аргумент frequency_recurrence_factor имеет тип int и значение по умолчанию NULL.[ @active_start_date = ] active_start_date
Дата первого планового запуска агента слияния в формате ГГГГММДД. Аргумент active_start_date имеет тип int и значение по умолчанию NULL.[ @active_end_date = ] active_end_date
Дата плановой остановки агента слияния в формате ГГГГММДД. Аргумент active_end_date имеет тип int и значение по умолчанию NULL.[ @active_start_time_of_day = ] active_start_time_of_day
Время суток, на которое запланирован первый запуск агента слияния, в формате ЧЧММСС. Аргумент active_start_time_of_day имеет тип int и значение по умолчанию NULL.[ @active_end_time_of_day = ] active_end_time_of_day
Время плановой остановки агента слияния в формате ЧЧММСС. Аргумент 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 используется для репликации слиянием публикаций с параметризованными фильтрами строк.
Чтобы измененное имя входа или пароль агента вступили в силу, необходимо перезапустить агент.
Разрешения
Процедуру sp_changedynamicsnapshot_job могут выполнять только члены предопределенной роли сервера sysadmin и предопределенной роли базы данных db_owner.
См. также
Основные понятия
Просмотр и изменение параметров безопасности репликации
Моментальные снимки для публикаций слиянием с параметризованными фильтрами