sp_addqreader_agent (Transact-SQL)

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 = ] 'job_login' 
        , [ @job_password = ] 'job_password'
    [ , [ @job_name = ] 'job_name'
    [ , [ @frompublisher = ] frompublisher

Argumentos

• [ @job_login= ] 'job_login'
  Es el inicio de sesión de la cuenta de Microsoft Windows en la que se ejecuta el agente. job_login es de tipo nvarchar(257) y no tiene ningún valor predeterminado. Esta cuenta de Windows siempre se utiliza para conexiones del agente con el distribuidor.

• [ @job_password= ] 'job_password'
  Es la contraseña de la cuenta de Windows en la que se ejecuta el agente. job_password es de tipo sysname y no tiene ningún valor predeterminado.

  Nota de seguridad
  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= ] 'job_name'
  Es el nombre de un trabajo del agente existente. job_name es de tipo sysname y su valor predeterminado es 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 de tipo bit y su valor predeterminado es 0. El valor 1 indica que el procedimiento se ejecuta en el publicador de la base de datos de publicaciones.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_addqreader_agent se utiliza en la replicación transaccional.

Como mínimo, se debe ejecutar sp_addqreader_agent una vez en un distribuidor que admita la actualización en cola tras sp_adddistributiondb, aunque antes de sp_addpublication.

El Agente de lectura de cola se quita cuando ejecuta sp_dropdistributiondb.

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_addqreader_agent.

Vea también

Tasks

Actualizar scripts de replicación (programación de la replicación con Transact-SQL)

Referencia

sp_changeqreader_agent (Transact-SQL)

sp_helpqreader_agent (Transact-SQL)

Conceptos

Suscripciones actualizables para replicación transaccional