sp_changepublication_snapshot (Transact-SQL)

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

Примечание по безопасности
При настройке работы издателя с удаленным распространителем значения всех параметров, включая 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.

• [ @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.

См. также

Задания

Как просмотреть и изменить свойства публикации (программирование репликации на языке Transact-SQL)

Справочник

sp_addpublication_snapshot (Transact-SQL)

Системные хранимые процедуры (Transact-SQL)

Основные понятия

Изменение свойств публикации и статей