Статья
04/01/2012

sp_MSchange_snapshot_agent_properties (Transact-SQL)

Изменяет свойства задания агента моментальных снимков, выполняемого на распространителе Microsoft SQL Server 2005 или более поздних версий. Эта хранимая процедура используется для изменения свойств, когда издатель запущен на экземпляре Microsoft SQL Server 2000. Эта хранимая процедура выполняется на распространителе в базе данных распространителя.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

sp_MSchange_snapshot_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @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_type = ] 'publisher_type'

Аргументы

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

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

Значение	Описание
1	Однократно.
2	По запросу.
4	Ежедневно.
8	Еженедельно.
10	Ежемесячно.
20	Ежемесячно, в соответствии с заданным интервалом.
40	При запуске агента SQL Server.

[ @frequency_interval = ] frequency_interval
Это значение, которое применяется к частоте, устанавливаемой аргументом frequency_type. Аргумент frequency_interval имеет тип int и не имеет значения по умолчанию.
[ @frequency_subday = ] frequency_subday
Единица измерения для аргумента freq_subday_interval. Аргумент frequency_subday имеет тип int и может принимать одно из следующих значений.

Значение

Описание

1

Однократно.

2

Секунда.

4

Минута.

8

Час.
[ @frequency_subday_interval=] frequency_subday_interval
Интервал для аргумента frequency_subday. Аргумент frequency_subday_interval имеет тип int и не имеет значения по умолчанию.
[ @frequency_relative_interval = ] frequency_relative_interval
Дата запуска агента моментальных снимков. Аргумент frequency_relative_interval имеет тип int и не имеет значения по умолчанию.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Показатель повтора, используемый аргументом frequency_type. Аргумент frequency_recurrence_factor имеет тип int и не имеет значения по умолчанию.
[ @active_start_date = ] active_start_date
Дата первого назначенного запуска агента моментальных снимков в формате ГГГГММДД. Аргумент active_start_date имеет тип int и не имеет значения по умолчанию.
[ @active_end_date = ] active_end_date
Дата остановки по расписанию агента моментальных снимков в формате ГГГГММДД. Аргумент active_end_date имеет тип int и не имеет значения по умолчанию.
[ @active_start_time_of_day=] active_start_time_of_day
Время первого планирования агента моментальных снимков в формате ЧЧММСС. Аргумент active_start_time_of_day имеет тип int и не имеет значения по умолчанию.
[ @active_end_time_of_day=] active_end_time_of_day
Время плановой остановки агента моментальных снимков в формате ЧЧММСС. Аргумент active_end_time_of_day имеет тип int и не имеет значения по умолчанию.
[ @snapshot_job_name = ] 'snapshot_agent_name'
Имя существующего задания агента моментальных снимков, если оно используется. Аргумент snapshot_agent_name имеет тип nvarchar(100) и не имеет значения по умолчанию.
[ @publisher_security_mode= ] publisher_security_mode
Режим безопасности, используемый агентом при установке соединения с издателем. Аргумент publisher_security_mode имеет тип int и не имеет значения по умолчанию. Значение 0 задает проверку подлинности SQL Server, а значение 1 — проверку подлинности Windows. Для издателей, отличных от издателей SQL Server, должно указываться значение 0. По возможности используйте проверку подлинности Windows.
[ @publisher_login= ] 'publisher_login'
Имя входа, используемое при установке соединения с издателем. Аргумент publisher_login имеет тип sysname и не имеет значения по умолчанию. Имя входа publisher_login следует указывать, когда аргумент publisher_security_mode имеет значение 0. Если аргумент publisher_login имеет значение NULL, а издатель *_*security_mode равен 1, то при соединении с издателем будет использоваться учетная запись Windows, заданная в аргументе job_login.

[ @publisher_password= ] 'publisher_password'
Пароль, используемый при установке соединения с издателем. Аргумент publisher_password имеет тип nvarchar(524) и не имеет значения по умолчанию.

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

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

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

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

[ @publisher_type= ] 'publisher_type'
Указывает тип издателя, когда на издателе не выполняется экземпляр SQL Server. Аргумент publisher_type имеет тип sysname и может иметь одно из следующих значений.

Значение	Описание
MSSQLSERVER	Указывает издателя SQL Server.
ORACLE	Указывает стандартного издателя Oracle.
ORACLE GATEWAY	Указывает издателя Oracle Gateway.

Дополнительные сведения о различиях между издателями Oracle и Oracle Gateway см. в разделе Обзор публикации Oracle.

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

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

Замечания

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

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

Если издатель запущен на экземпляре SQL Server 2005 или более поздних версий, то следует использовать процедуру sp_changepublication_snapshot для изменения свойств задания агента моментальных снимков.

Разрешения

Только члены предопределенной роли сервера sysadmin на распространителе могут выполнять процедуру sp_MSchange_snapshot_agent_properties.

См. также

Справочник

sp_addpublication_snapshot (Transact-SQL)

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

Использование нескольких версий SQL Server в топологии репликации

Share via