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 используется в репликации моментальных снимков, репликации транзакций и репликации слиянием.
Разрешения
Только члены предопределенных ролей сервера sysadmin или db_owner предопределенных ролей базы данных могут выполняться sp_changepublication_snapshot.
См. также
Просмотр и изменение свойств публикации
Изменение свойств публикации и статьи
sp_addpublication_snapshot (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)
Кері байланыс
https://aka.ms/ContentUserFeedback.
Жақында қолжетімді болады: 2024 жыл бойы біз GitHub Issues жүйесін мазмұнға арналған кері байланыс механизмі ретінде біртіндеп қолданыстан шығарамыз және оны жаңа кері байланыс жүйесімен ауыстырамыз. Қосымша ақпаратты мұнда қараңыз:Жіберу және пікірді көру