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.

Convenções da 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 da 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 da conta do Windows na qual o agente é executado. job_password é sysname, sem padrão.

  Observaçã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 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.

Consulte também

Tarefas

Atualizar scripts de replicação (Programação Transact-SQL de replicação)

Referência

sp_changeqreader_agent (Transact-SQL)

sp_helpqreader_agent (Transact-SQL)

Conceitos

Assinaturas atualizáveis para replicação transacional