sp_changelogreader_agent (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

Cambia las propiedades de seguridad de un Agente de registro del LOG. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación.

Importante

Al configurar un publicador con un distribuidor remoto, los valores suministrados para todos los parámetros, incluidos job_login y job_password, se envían al distribuidor como texto sin formato. Antes de ejecutar este procedimiento almacenado, se recomienda cifrar la conexión entre el publicador y su distribuidor remoto. Para obtener más información, vea Habilitar conexiones cifradas en el motor de base de datos (Administrador de configuración de SQL Server).

Sintaxis

  
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' ]  

Argumentos

[ @job_login = ] 'job_login' Es el inicio de sesión de la cuenta con la que se ejecuta el agente. job_login es nvarchar(257) con un valor predeterminado de NULL. En Azure SQL Instancia administrada, use una cuenta de SQL Server. No se puede cambiar para un publicador que no sea de Microsoft SQL Server .

[ @job_password = ] 'job_password' Es la contraseña de la cuenta con la que se ejecuta el agente. job_password es sysname, con un valor predeterminado de NULL.

Importante

Cuando sea posible, pida a los usuarios que proporcionen credenciales de seguridad en tiempo de ejecución. Si debe almacenar las credenciales en un archivo de script, proteja el archivo para evitar el acceso no autorizado.

[ @publisher_security_mode = ] publisher_security_mode

Nota:

El identificador de Microsoft Entra se conocía anteriormente como Azure Active Directory (Azure AD).

Es el modo de seguridad que el agente utiliza al conectarse al publicador. publisher_security_mode es smallint, con un valor predeterminado de NULL. Los valores siguientes definen el modo de seguridad:

• 0 especifica la autenticación de SQL Server.
• 1especifica autenticación de Windows.
• 2 especifica la autenticación con contraseña de Microsoft Entra a partir de SQL Server 2022 (16.x) CU 6.
• 3 especifica la autenticación integrada de Microsoft Entra a partir de SQL Server 2022 (16.x) CU 6.
• 4 especifica la autenticación de tokens de Microsoft Entra a partir de SQL Server 2022 (16.x) CU 6.

Importante

Siempre que sea posible, utilice la autenticación de Windows.

[ @publisher_login = ] 'publisher_login' Es el inicio de sesión que se usa al conectarse al publicador. publisher_login es sysname, con un valor predeterminado de NULL. publisher_login debe especificarse cuando publisher_security_mode sea 0. Si publisher_login es NULL y publisher_security_mode es 1, la cuenta de Windows especificada en job_login se usa al conectarse al publicador.

[ @publisher_password = ] 'publisher_password' Es la contraseña que se usa al conectarse al publicador. publisher_password es sysname, con un valor predeterminado de NULL.

Importante

No utilice una contraseña en blanco. Utilice una contraseña segura. Cuando sea posible, pida a los usuarios que proporcionen credenciales de seguridad en tiempo de ejecución. Si debe almacenar las credenciales en un archivo de script, proteja el archivo para evitar el acceso no autorizado.

[ @publisher = ] 'publisher' Es el nombre del publicador. publisher es sysname, con un valor predeterminado de NULL. Este parámetro solo es compatible con aquellos publicadores que no son de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_changelogreader_agent se usa en la replicación transaccional.

sp_changelogreader_agent se usa para cambiar la cuenta de Windows en la que se ejecuta un agente de registro del log. Puede cambiar la contraseña de un inicio de sesión de Windows existente o proporcionar una contraseña y un inicio de sesión de Windows nuevos.

Después de cambiar un inicio de sesión o una contraseña de agente, debe detener y reiniciar el agente para que el cambio surta efecto.

Permisos

Solo los miembros del rol fijo de servidor sysadmin o el rol fijo de base de datos db_owner pueden ejecutar sp_changelogreader_agent.

Consulte también

View and Modify Replication Security Settings (Ver y modificar la configuración de seguridad de la replicación)
sp_helplogreader_agent (Transact-SQL)
sp_addlogreader_agent (Transact-SQL)