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.

См. также

Задания

Как просмотреть и изменить параметры безопасности репликации (программирование репликации на языке Transact-SQL)

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

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