sp_MSchange_snapshot_agent_properties (Transact-SQL)

Статья
12/22/2023

Применимо к:SQL Server

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

Соглашения о синтаксисе 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' Имя публикации. публикация — sysname, без значения по умолчанию.

[ @frequency_type = ] frequency_typeЧастота выполнения агент моментальных снимков. frequency_type является int и может быть одним из этих значений.

значение	Description
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 и может быть одним из этих значений.

значение	Description
1	Однократно
2	Second
4	Minute
8	Часы

[ @frequency_subday_interval = ] frequency_subday_interval Интервал для frequency_subday. frequency_subday_interval не используется без значения по умолчанию.

[ @frequency_relative_interval = ] frequency_relative_intervalДата выполнения агент моментальных снимков. frequency_relative_interval не используется без значения по умолчанию.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Является фактором повторения, используемым frequency_type. frequency_recurrence_factor не используется без значения по умолчанию.

[ @active_start_date = ] active_start_dateДата, когда агент моментальных снимков впервые запланировано, отформатировано как yyyyMMdd. active_start_date не используется без значения по умолчанию.

[ @active_end_date = ] active_end_dateДата, когда агент моментальных снимков перестает планироваться, форматируется как yyyyMMdd. active_end_date является int, без значения по умолчанию.

[ @active_start_time_of_day = ] active_start_time_of_dayВремя дня, когда агент моментальных снимков впервые запланировано, отформатировано как HHmmss. active_start_time_of_day не используется без значения по умолчанию.

[ @active_end_time_of_day = ] active_end_time_of_dayВремя дня, когда агент моментальных снимков перестает планироваться, форматируется как HHmmss. active_end_time_of_day не используется без значения по умолчанию.

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

[ @publisher_security_mode = ] publisher_security_mode Режим безопасности, используемый агентом при подключении к издателю. publisher_security_mode не используется без значения по умолчанию. 0 указывает проверку подлинности SQL Server, а 1 — проверку подлинности Windows. Значение 0 должно быть указано для издателей, отличных от SQL Server. По возможности используйте аутентификацию 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	Используется издатель Oracle Gateway.

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

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

0 (успешно) или 1 (сбой)

Замечания

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

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

При запуске издателя на экземпляре SQL Server 2005 (9.x) или более поздней версии необходимо использовать sp_changepublication_snapshot для изменения свойств задания агент моментальных снимков.

Разрешения

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

См. также

sp_addpublication_snapshot (Transact-SQL)