sp_addqreader_agent (Transact-SQL)
Se aplica a: SQL Server Azure SQL Managed Instance
Agrega un Agente de lectura de cola a un distribuidor específico. Este procedimiento almacenado se ejecuta en el distribuidor de la base de datos de distribución o en el publicador de la base de datos de publicaciones.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_addqreader_agent
[ [ @job_login = ] N'job_login' ]
[ , [ @job_password = ] N'job_password' ]
[ , [ @job_name = ] N'job_name' ]
[ , [ @frompublisher = ] frompublisher ]
[ ; ]
Argumentos
[ @job_login = ] N'job_login'
Inicio de sesión de la cuenta de Windows con la que se ejecuta el agente. @job_login es nvarchar(257), con un valor predeterminado de NULL
. Esta cuenta de Windows siempre se utiliza para conexiones del agente con el distribuidor.
[ @job_password = ] N'job_password'
Contraseña de la cuenta de Windows con la que se ejecuta el agente. @job_password es sysname, sin ningún valor predeterminado.
Importante
No almacene información de autenticación en archivos de script. Para una mayor seguridad, los nombres de inicio de sesión y las contraseñas se deben proporcionar en tiempo de ejecución.
[ @job_name = ] N'job_name'
Nombre de un trabajo de agente existente. @job_name es sysname, con un valor predeterminado de NULL
. Este parámetro solamente se especifica cuando se crea el agente a partir de un trabajo existente, en lugar de hacerlo con un trabajo recién creado (el valor predeterminado).
[ @frompublisher = ] frompublisher
Especifica si el procedimiento se ejecuta en el publicador. @frompublisher es bit, con un valor predeterminado de 0
.
Un valor de 1
significa que el procedimiento se está ejecutando desde el publicador en la base de datos de publicación.
Valores de código de retorno
0
(correcto) o 1
(erróneo).
Comentarios
sp_addqreader_agent
se usa en la replicación transaccional.
sp_addqreader_agent
debe ejecutarse al menos una vez en un distribuidor que admita la actualización en cola después de sp_adddistributiondb pero antes de sp_addpublication.
El trabajo del Agente de lectura de cola se quita al ejecutar sp_dropdistributiondb.
Permisos
Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_addqreader_agent
.