sp_changelogreader_agent (Transact-SQL)

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

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

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

Синтаксис

sp_changelogreader_agent [ [ @job_login = ] 'job_login' ]
    [ , [ @job_password = ] 'job_password' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] 'publisher_login' ]
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @publisher = ] 'publisher' ]

Аргументы

  • [ @job_login= ] 'job_login'
    Имя входа для учетной записи Windows, с которой запускается агент. Аргумент job_login имеет тип nvarchar(257) и значение по умолчанию NULL. Это единственный предусмотренный вариант для издателя, отличного от Microsoft SQL Server*.*

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

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

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

  • [ @publisher_security_mode= ] publisher_security_mode
    Режим безопасности, используемый агентом при установке соединения с издателем. Аргумент publisher_security_mode имеет тип smallint и значение по умолчанию NULL. 0 указывает проверку подлинности SQL Server, а 1 указывает проверку подлинности Windows.

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

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

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

    Не используйте пустой пароль. Используйте надежный пароль. По возможности предлагайте пользователям вводить учетные данные безопасности во время выполнения приложения. В случае необходимости хранения учетных данных в файле сценария этот файл следует защищать во избежание несанкционированного доступа.

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

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

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

Замечания

Процедура sp_changelogreader_agent используется в репликации транзакций.

Процедура sp_changelogreader_agent используется для изменения учетной записи Windows, под которой выполняется агент чтения журнала. Можно изменить пароль существующего имени входа в систему Windows или ввести новое имя входа Windows и пароль.

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

Разрешения

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