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)
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по