sp_MSchange_snapshot_agent_properties (Transact-SQL)

Статья
05/08/2013

Изменяет свойства задания агента моментальных снимков, выполняемого на распространителе MicrosoftSQL 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)

Поделиться через