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 nombre de inicio de sesión de la cuenta de Microsoft Windows con la que se ejecuta el agente. job_login es de tipo nvarchar(257) y no tiene un 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 con la que se ejecuta el agente. job_password es de tipo sysname y no tiene un valor predeterminado.

  Nota de seguridad:
  No almacene información de autenticación en archivos de secuencias de comandos. 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 sólo 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.

Notas

sp_addqreader_agent se utiliza en la réplica 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

Sólo los miembros de la función fija de servidor sysadmin pueden ejecutar sp_addqreader_agent.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_changeqreader_agent (Transact-SQL)
sp_helpqreader_agent (Transact-SQL)

Otros recursos

How to: Enable Updating Subscriptions for Transactional Publications (Replication Transact-SQL Programming)
How to: Upgrade Replication Scripts (Replication Transact-SQL Programming)
Suscripciones actualizables para réplica transaccional

Ayuda e información

Obtener ayuda sobre SQL Server 2005