sp_MSchange_snapshot_agent_properties (Transact-SQL)
Применимо к: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.
См. также
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по