sp_changepublication_snapshot (Transact-SQL)

Изменения: 12 декабря 2006 г.

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

Примечание безопасности.
При настройке работы издателя с удаленным распространителем значения всех параметров, включая job_login и job_password, пересылаются на распространитель в виде открытого текста. Прежде чем выполнять эту хранимую процедуру, необходимо зашифровать соединение между издателем и его удаленным распространителем. Дополнительные сведения см. в разделе Шифрование соединений с SQL Server.

Синтаксические обозначения в Transact-SQL

Синтаксис

sp_changepublication_snapshot [ @publication= ] 'publication'
    [ , [ @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 ]
    [ , [ @snapshot_job_name = ] 'snapshot_agent_name' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] 'publisher_login' ]
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @job_login = ] 'job_login' ]
    [ , [ @job_password = ] 'job_password' ]
    [ , [ @publisher = ] 'publisher' ]

Аргументы

• [ @publication=] 'publication'
  Имя публикации. Аргумент publication имеет тип sysname и не имеет значения по умолчанию.

• [ @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
  Это единицы измерения аргумента freq_subday_interval. Аргумент 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_relative_interval имеет тип int и значение по умолчанию 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.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  Имя существующего задания агента моментальных снимков в том случае, если это задание используется. Аргумент snapshot_agent_name имеет тип nvarchar(100) и значение по умолчанию NULL.

• [ @publisher_security_mode= ] publisher_security_mode
  Используемый агентом при подключении к издателю режим безопасности. Аргумент publisher_security_mode имеет тип smallint и значение по умолчанию NULL. 0 означает проверку подлинности SQL Server, а 1 означает проверку подлинности средствами Windows. Для издателей, отличных от SQL Server, должно указываться значение 0.

  Примечание безопасности.
  При возможности используйте проверку подлинности Windows.

• [ @publisher_login= ] 'publisher_login'
  Имя входа при подключении к издателю. Аргумент publisher_login имеет тип sysname и значение по умолчанию NULL. Аргумент publisher_login должен быть указан при значении аргумента publisher_security_mode, равном 0. Если аргумент publisher_login принимает значение NULL, и аргумент publisher_security_mode равен 1, тогда при соединении с издателем будет использована учетная запись Windows, указанная в аргументе job_login.

• [ @publisher_password= ] 'publisher_password'
  Пароль для подключения к издателю. Аргумент publisher_password имеет тип sysname и значение по умолчанию NULL.

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

• [ @job_login= ] 'job_login'
  Имя входа для учетной записи Windows, с которой запускается агент. Аргумент job_login имеет тип nvarchar(257) и значение по умолчанию NULL. Для соединений агента с распространителем всегда используется эта учетная запись Windows. Необходимо указывать этот аргумент при создании нового задания агента моментальных снимков. Это единственный предусмотренный вариант для издателя, отличного от SQL Server*.*

• [ @job_password= ] 'job_password'
  Пароль для учетной записи Windows, с которой запускается агент. Аргумент job_password имеет тип sysname и значение по умолчанию NULL. Необходимо указывать этот аргумент при создании нового задания агента моментальных снимков.

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

• [ @publisher= ] 'publisher'
  Определяет издатель, отличный от SQL Server. Аргумент publisher имеет тип sysname и значение по умолчанию NULL.

  Примечание.
  Аргумент publisher не следует использовать при создании агента моментальных снимков на издателе SQL Server.

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

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Процедура sp_changepublication_snapshot используется в репликации моментальных снимков, репликации транзакций и репликации слиянием.

Разрешения

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

См. также

Справочник

sp_addpublication_snapshot (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)

Другие ресурсы

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
Изменение свойств публикации и статей

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений

Версия	Журнал
12 декабря 2006 г.	Обновленное содержимое: Обновлены сведения об аргументах @frequency_type и @frequency_interval.