sp_changepublication_snapshot (Transact-SQL)

Применимо к:SQL Server Управляемый экземпляр SQL Azure

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

Важно!

Если издатель настраивается с удаленным распространителем, то значения, передаваемые для всех аргументов, включая job_login и job_password, передаются распространителю в формате обычного (незашифрованного) текста. Прежде чем выполнять эту хранимую процедуру, необходимо зашифровать соединение между издателем и его удаленным распространителем. Дополнительные сведения см. в статье Включение шифрования соединений в компоненте Database Engine (диспетчер конфигурации 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' Имя публикации. публикация — sysname, без значения по умолчанию.

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

значение	Description
1	Один раз.
2	по запросу
4	Ежедневно
8	Неделя
16	Месяц
32	Ежемесячно с относительной датой
64	Автозапуск
128	Повторяющееся задание
NULL (по умолчанию)

[ @frequency_interval = ] frequency_interval Указывает дни запуска агента. frequency_interval является int и может быть одним из следующих значений.

значение	Description
1	Воскресенье
2	Понедельник
3	Вторник
4	Среда
5	Четверг
6	Пятница
7	Суббота
8	день
9	По рабочим дням
10	По выходным дням
NULL (по умолчанию)

[ @frequency_subday = ] frequency_subday Единицы для freq_subday_interval. frequency_subday является int и может быть одним из этих значений.

значение	Description
1	Однократно
2	Second
4	Minute
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Дата, когда агент моментальных снимков впервые запланировано, отформатировано как yyyyMMdd. active_start_date имеет значение int с значением NULL по умолчанию.

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

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

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

Важно!

По возможности используйте аутентификацию 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 по умолчанию.

Примечание.

издатель не должен использоваться при создании агент моментальных снимков на издателе SQL Server.

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

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

Замечания

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

Разрешения

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

См. также

Просмотр и изменение свойств публикации
Изменение свойств публикации и статьи
sp_addpublication_snapshot (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)