Поделиться через

sp_MSchange_snapshot_agent_properties (Transact-SQL)

  • Статья

Изменяет свойства задания агента моментальных снимков, исполняемого на распространителе Microsoft SQL Server 2005. Данная хранимая процедура используется для изменения свойств SQL Server 2005, когда издатель запущен на экземпляре Microsoft SQL Server 2000. Эта хранимая процедура выполняется на распространителе в базе данных распространителя.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_MSchange_snapshot_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @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_type = ] 'publisher_type'

Аргументы

  • [ @publisher = ] 'publisher'
    Имя издателя. Аргумент publisher имеет тип sysname и не имеет значения по умолчанию.
  • [ @publisher_db= ] 'publisher_db'
    Имя базы данных публикации. Аргумент publisher_db имеет тип sysname и не имеет значения по умолчанию.
  • [ @publication = ] 'publication'
    Имя публикации. Аргумент publication имеет тип sysname и не имеет значения по умолчанию.

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

    Значение Описание

    1

    Однократно

    2

    По требованию

    4

    Ежедневно

    8

    Еженедельно

    10

    Ежемесячно

    20

    Ежемесячно, в соответствии с заданным интервалом

    40

    При запуске агента SQL Server
  • [ @frequency_interval = ] frequency_interval
    Это значение, которое применяется к частоте, устанавливаемой аргументом frequency_type. Аргумент frequency_interval имеет тип int и не имеет значения по умолчанию.

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

    Значение Описание

    1

    Однократно

    2

    Секунда

    4

    Минута

    8

    Час
  • [ @frequency_subday_interval=] frequency_subday_interval
    Интервал для аргумента frequency_subday. Аргумент frequency_subday_interval имеет тип int и не имеет значения по умолчанию.
  • [ @frequency_relative_interval = ] frequency_relative_interval
    Дата запуска агента моментальных снимков. Аргумент frequency_relative_interval имеет тип int и не имеет значения по умолчанию.
  • [ @frequency_recurrence_factor = ] frequency_recurrence_factor
    Показатель повтора, используемый аргументом frequency_type. Аргумент frequency_recurrence_factor имеет тип int и не имеет значения по умолчанию.
  • [ @active_start_date = ] active_start_date
    Дата первого назначенного запуска агента моментальных снимков в формате ГГГГММДД. Аргумент active_start_date имеет тип int и не имеет значения по умолчанию.
  • [ @active_end_date = ] active_end_date
    Дата остановки по расписанию агента моментальных снимков в формате ГГГГММДД. Аргумент active_end_date имеет тип int и не имеет значения по умолчанию.
  • [ @active_start_time_of_day=] active_start_time_of_day
    Время первого планирования агента моментальных снимков в формате ЧЧММСС. Аргумент active_start_time_of_day имеет тип int и не имеет значения по умолчанию.
  • [ @active_end_time_of_day=] active_end_time_of_day
    Время плановой остановки агента моментальных снимков в формате ЧЧММСС. Аргумент active_end_time_of_day имеет тип int и не имеет значения по умолчанию.
  • [ @snapshot_job_name = ] 'snapshot_agent_name'
    Имя существующего задания агента моментальных снимков, если оно используется. Аргумент snapshot_agent_name имеет тип nvarchar(100) и не имеет значения по умолчанию.
  • [ @publisher_security_mode= ] publisher_security_mode
    Режим безопасности, используемый агентом при установке соединения с издателем. Аргумент publisher_security_mode имеет тип int и не имеет значения по умолчанию. Значение 0 задает проверку подлинности SQL Server, а значение 1 — проверку подлинности Windows. Для издателей, отличных от издателей SQL Server, должно указываться значение 0.
  • [ @publisher_login= ] 'publisher_login'
    Имя входа, используемое при установке соединения с издателем. Аргумент publisher_login имеет тип sysname и не имеет значения по умолчанию. Аргумент publisher_login должен быть указан, если значением аргумента publisher_security_mode является 0. Если аргумент publisher_login имеет значение NULL, а издатель _security_mode равен 1, то при соединении с издателем будет использоваться учетная запись Windows, заданная в аргументе job_login.

  • [ @publisher_password= ] 'publisher_password'
    Пароль, используемый при подключении к издателю. Аргумент publisher_password имеет тип nvarchar(524) и не имеет значения по умолчанию.

    ms186263.security(ru-ru,SQL.90).gifПримечание безопасности.
    Не храните данные проверки подлинности в файлах сценариев. Для обеспечения лучшей защиты имена входа и пароли должны вводиться во время выполнения.
  • [ @job_login= ] 'job_login'
    Имя входа для учетной записи Windows, с которой запускается агент. Аргумент job_login имеет тип nvarchar(257) и не имеет значения по умолчанию. Для соединений агента с распространителем всегда используется эта учетная запись Windows. Необходимо указывать этот аргумент при создании нового задания агента моментальных снимков. Это единственный предусмотренный вариант для издателя, отличного от SQL Server*.*.

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

    ms186263.security(ru-ru,SQL.90).gifПримечание безопасности.
    Не храните данные проверки подлинности в файлах сценариев. Для обеспечения лучшей защиты имена входа и пароли должны вводиться во время выполнения.

  • [ @publisher_type= ] 'publisher_type'
    Указывает тип издателя, отличного от SQL Server. Аргумент publisher_type имеет тип sysname и может иметь одно из следующих значений.

    Значение Описание

    MSSQLSERVER

    Указывает издателя SQL Server.

    ORACLE

    Указывает стандартного издателя Oracle.

    ORACLE GATEWAY

    Указывает издателя Oracle Gateway.

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

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

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

Замечания

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

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

Если издатель запущен на экземпляре SQL Server 2005, то следует использовать процедуру sp_changepublication_snapshot для изменения свойств задания агента моментальных снимков.

Разрешения

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

См. также

Справочник

sp_addpublication_snapshot (Transact-SQL)

Другие ресурсы

Использование нескольких версий SQL Server в топологии репликации

Справка и поддержка

Получение помощи по SQL Server 2005