Compartir a través de


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.