sys.sp_addqreader_agent (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Adiciona um agente Leitor de Fila para um dado Distribuidor. Este procedimento armazenado é executado no Distribuidor na base de dados de distribuição ou no Publisher na base de dados da publicação.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_addqreader_agent
    [ [ @job_login = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @frompublisher = ] frompublisher ]
[ ; ]

Arguments

[ @job_login = ] N'job_login'

O login da conta Windows com a qual o agente corre. @job_login é nvarchar(257), com um padrão de NULL. Esta conta do Windows é sempre usada para ligações de agentes ao Distribuidor.

[ @job_password = ] N'job_password'

A palavra-passe da conta Windows com a qual o agente corre. @job_password é sysname, sem padrão.

Importante

Não guarde a informação de autenticação em ficheiros de script. Para a melhor segurança, os nomes de login e palavras-passe devem ser fornecidos em tempo de execução.

[ @job_name = ] N'job_name'

O nome de um agente já existente. @job_name é sysname, com o padrão de NULL. Este parâmetro só é especificado quando o agente é criado usando um job existente em vez de um job recém-criado (o padrão).

[ @frompublisher = ] do editor

Especifica se o procedimento está a ser executado no Publisher. @frompublisheré bit, com um padrão de 0.

Um valor de 1 significa que o procedimento está a ser executado a partir do Publisher na base de dados da publicação.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_addqreader_agent é usado na replicação transacional.

sp_addqreader_agent deve ser executado pelo menos uma vez num distribuidor que suporte atualização em fila após sp_adddistributiondb mas antes de sp_addpublication.

O trabalho de Agente Leitor de Fila é removido quando executas sp_dropdistributiondb.

Permissões

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