Compartilhar via


sp_addqreader_agent (Transact-SQL)

Adiciona um Queue Reader Agent para um determinado Distribuidor. Esse procedimento armazenado é executado no Distribuidor, no banco de dados de distribuição, ou no Publicador, no banco de dados de publicação.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_addqreader_agent [ @job_login = ] 'job_login'
        , [ @job_password = ] 'job_password'
    [ , [ @job_name = ] 'job_name'
    [ , [ @frompublisher = ] frompublisher 

Argumentos

  • [ @job_login= ] 'job_login'
    É o logon para a conta do Microsoft Windows na qual o agente é executado. job_login é nvarchar(257), sem padrão. Essa conta do Windows sempre é usada para conexões de agente com o Distribuidor.

  • [ @job_password= ] 'job_password'
    É a senha para conta do Windows na qual o agente é executado. job_password é sysname, sem padrão.

    Observação sobre segurançaObservação sobre segurança

    Não armazene informações de autenticação em arquivos de script. Para melhor segurança, nomes de logon e senhas devem ser fornecidos em tempo de execução.

  • [ @job_name= ] 'job_name'
    É o nome de um trabalho de agente existente. job_name é sysname, com um valor padrão de NULL. Esse parâmetro só é especificado quando o agente é criado usando um trabalho existente em vez de um trabalho recém-criado (o padrão).

  • [ @frompublisher= ] frompublisher
    Especifica se o procedimento está sendo executado no Publicador. frompublisher é bit, com um valor padrão de 0. Um valor de 1 significa que o procedimento está sendo executado do Publicador no banco de dados de publicação.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_addqreader_agent é usado em replicação transacional.

sp_addqreader_agent deve ser executado pelo menos uma vez no Distribuidor que dá suporte à atualização enfileirada após sp_adddistributiondb, mas antes de sp_addpublication.

O trabalho do Queue Reader Agent é removido quando você executa sp_dropdistributiondb.

Permissões

Somente membros da função de servidor fixa sysadmin podem executar sp_addqreader_agent.