sp_changepublication_snapshot (Transact-SQL)

Статья
05/08/2013

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

Примечание по безопасности
Если издатель настраивается с удаленным распространителем, то значения, передаваемые для всех аргументов, включая job_login и job_password, передаются распространителю в формате обычного (незашифрованного) текста. Прежде чем выполнять эту хранимую процедуру, необходимо зашифровать соединение между издателем и его удаленным распространителем. Дополнительные сведения см. в разделе Включение шифрования соединений в ядре СУБД (диспетчер конфигурации SQL Server).

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

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

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

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

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

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

Значение

Описание

1

Однократно

2

Секунда

4

Минута

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
Дата первого назначенного запуска агента моментальных снимков в формате ГГГГММДД. Аргумент active_start_date имеет тип int и значение по умолчанию NULL.
[ @active_end_date =] active_end_date
Дата плановой остановки агента моментальных снимков в формате ГГГГММДД. Аргумент active_end_date имеет тип int и значение по умолчанию NULL.
[ @active_start_time_of_day =] active_start_time_of_day
Время первого планового запуска агента моментальных снимков в формате ЧЧММСС. Аргумент active_start_time_of_day имеет тип int и значение по умолчанию NULL.
[ @active_end_time_of_day =] active_end_time_of_day
Время плановой остановки агента моментальных снимков в формате ЧЧММСС. Аргумент 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 имеет тип smallint и значение по умолчанию NULL. 0 означает проверку подлинности SQL Server, а 1 означает проверку подлинности средствами Windows. Для издателей, отличных от SQL Server, должно указываться значение 0.

Примечание по безопасности

По возможности используйте проверку подлинности 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.

Примечание по безопасности
По возможности используйте проверку подлинности Windows.

[ @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 не следует использовать аргумент publisher.

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

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

Замечания

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

Разрешения

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