Compartilhar via


sp_addqreader_agent (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

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 de sintaxe de Transact-SQL

Sintaxe

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'

O logon da conta do Windows sob a qual o agente é executado. @job_login é nvarchar(257), com um padrão de NULL. Essa conta do Windows sempre é usada para conexões de agente com o Distribuidor.

@job_password [ = ] N'job_password'

A senha da conta do Windows sob a qual o agente é executado. @job_password é sysname, sem padrão.

Importante

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 runtime.

@job_name [ = ] N'job_name'

O nome de um trabalho de agente existente. @job_name é sysname, com um 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 a partir do Publicador no banco de dados de publicação.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_addqreader_agent é usado na replicação transacional.

sp_addqreader_agent deve ser executado pelo menos uma vez em um Distribuidor que dê suporte à atualização enfileirada após sp_adddistributiondb mas antes sp_addpublication.

A tarefa do Queue Reader Agent é removida quando você executa sp_dropdistributiondb.

Permissões

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