sp_MSchange_snapshot_agent_properties (Transact-SQL)

Область применения: SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_MSchange_snapshot_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'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 = ] N'snapshot_job_name'
    , [ @publisher_security_mode = ] publisher_security_mode
    , [ @publisher_login = ] N'publisher_login'
    , [ @publisher_password = ] N'publisher_password'
    , [ @job_login = ] N'job_login'
    , [ @job_password = ] N'job_password'
    , [ @publisher_type = ] N'publisher_type'
[ ; ]

Аргументы

[ @publisher = ] N'publisher'

Имя издателя. @publisher — sysname без значения по умолчанию.

[ @publisher_db = ] N'publisher_db'

Имя базы данных публикации. @publisher_db — sysname без значения по умолчанию.

[ @publication = ] N'publication'

Имя публикации. @publication — sysname без значения по умолчанию.

[ @frequency_type = ] frequency_type

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

значение	Описание
1	Однократно
2	по запросу
4	Ежедневно
8	Weekly (Еженедельно);
10	Ежемесячная
20	Ежемесячно, в соответствии с заданным интервалом
40	При запуске агент SQL Server

[ @frequency_interval = ] frequency_interval

Значение, применяемое к частоте, заданной @frequency_type. @frequency_interval не используется без значения по умолчанию.

[ @frequency_subday = ] frequency_subday

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

значение	Описание
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 не используется без значения по умолчанию.

[ @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 = ] N'snapshot_job_name'

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

[ @publisher_security_mode = ] publisher_security_mode

Режим безопасности, используемый агентом при подключении к издателю. @publisher_security_mode не используется без значения по умолчанию. Значение 0 должно быть указано для издателей, отличных от SQL Server.

• 0 указывает проверку подлинности SQL Server
• 1указывает проверка подлинности Windows

По возможности используйте аутентификацию Windows.

[ @publisher_login = ] N'publisher_login'

Имя входа, используемое для соединения с издателем. @publisher_login — sysname без значения по умолчанию. @publisher_login необходимо указать при @publisher_security_mode0. Если @publisher_login есть NULL и @publisher_security_mode1, то при подключении к издателю используется учетная запись Windows, указанная в @job_login.

[ @publisher_password = ] N'publisher_password'

Пароль, используемый при подключении к издателю. @publisher_password — nvarchar(524), без значения по умолчанию.

Внимание

Не сохраняйте сведения о проверке подлинности в файлах скриптов. В целях повышения безопасности рекомендуется вводить имена входа и пароли во время выполнения.

[ @job_login = ] N'job_login'

Имя входа для учетной записи Windows, в которой выполняется агент. @job_login — nvarchar(257), без значения по умолчанию. Для соединения агента с распространителем всегда используется эта учетная запись Windows. Необходимо указывать этот аргумент при создании нового задания агента моментальных снимков. Это свойство нельзя изменить для издателя, отличного от SQL Server.

[ @job_password = ] N'job_password'

Пароль для учетной записи Windows, в которой выполняется агент. @job_password — sysname, без значения по умолчанию. Необходимо указывать этот аргумент при создании нового задания агента моментальных снимков.

Внимание

Не сохраняйте сведения о проверке подлинности в файлах скриптов. В целях повышения безопасности рекомендуется вводить имена входа и пароли во время выполнения.

[ @publisher_type = ] N'publisher_type'

Указывает тип издателя, если издатель не работает в экземпляре SQL Server. @publisher_type — sysname и может быть одним из следующих значений.

значение	Описание
MSSQLSERVER	Указывает издателя SQL Server.
ORACLE	Задает стандартного издателя Oracle.
ORACLE GATEWAY	Используется издатель Oracle Gateway.

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

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

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

Замечания

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

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

Вы можете использовать sp_changepublication_snapshot на издателе для изменения свойств задания агент моментальных снимков.

Разрешения

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

Связанный контент

• sp_addpublication_snapshot (Transact-SQL)