sp_changelogreader_agent (Transact-SQL)

Применимо к:SQL Server Управляемый экземпляр SQL Azure

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

Внимание

Если издатель настраивается с удаленным распространителем, то значения, передаваемые для всех аргументов, включая job_login и job_password, передаются распространителю в формате обычного (незашифрованного) текста. Прежде чем выполнять эту хранимую процедуру, необходимо зашифровать соединение между издателем и его удаленным распространителем. Дополнительные сведения см. в статье Включение шифрования соединений в компоненте Database Engine (диспетчер конфигурации 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' Имя входа для учетной записи, в которой выполняется агент. job_login — nvarchar(257) с значением NULL по умолчанию. В Управляемый экземпляр SQL Azure используйте учетную запись SQL Server. Это невозможно изменить для издателя, отличного от Microsoft SQL Server .

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

Внимание

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

[ @publisher_security_mode = ] publisher_security_mode

Примечание.

Идентификатор Microsoft Entra ранее был известен как Azure Active Directory (Azure AD).

Режим безопасности, используемый агентом при установке соединения с издателем. publisher_security_mode имеет небольшой размер с значением NULL по умолчанию. Следующие значения определяют режим безопасности:

• 0 указывает проверку подлинности SQL Server.
• 1указывает проверка подлинности Windows.
• 2 указывает проверку подлинности паролей Microsoft Entra, начиная с SQL Server 2022 (16.x) CU 6.
• 3 указывает встроенную проверку подлинности Microsoft Entra, начиная с SQL Server 2022 (16.x) CU 6.
• 4 указывает проверку подлинности маркера Microsoft Entra, начиная с SQL Server 2022 (16.x) CU 6.

Внимание

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

См. также

Просмотр и изменение параметров безопасности репликации
sp_helplogreader_agent (Transact-SQL)
sp_addlogreader_agent (Transact-SQL)