sp_addqreader_agent (Transact-SQL)

Aggiunge un agente di lettura coda per un server di distribuzione specificato. Questa stored procedure viene eseguita nel database di distribuzione del server di distribuzione o nel database di pubblicazione del server di pubblicazione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @job_login= ] 'job_login'
    Account di accesso per l'account di Microsoft Windows utilizzato per l'esecuzione dell'agente. job_login è di tipo nvarchar(257) e non prevede alcun valore predefinito. Questo account di Windows viene sempre utilizzato per le connessioni dell'agente al server di distribuzione.

  • [ @job_password= ] 'job_password'
    Password dell'account di Windows utilizzato per l'esecuzione dell'agente. job_password è di tipo sysname e non prevede alcun valore predefinito.

    Nota sulla sicurezzaNota sulla sicurezza

    Non archiviare informazioni di autenticazione in file script. Per una protezione ottimale, i nomi e le password degli account di accesso dovrebbero essere passati in fase di esecuzione.

  • [ @job_name= ] 'job_name'
    Nome di un processo di agente esistente. job_name è di tipo sysname e il valore predefinito è NULL. Questo parametro viene specificato solo quando l'agente viene creato con un processo esistente anziché con un nuovo processo creato (impostazione predefinita).

  • [ @frompublisher= ] frompublisher
    Specifica se la procedura viene eseguita nel server di pubblicazione. frompublisher è di tipo bit e il valore predefinito è 0. Il valore 1 indica che la procedura viene eseguita nel database di pubblicazione del server di pubblicazione.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

sp_addqreader_agent viene utilizzata per la replica transazionale.

sp_addqreader_agent deve essere eseguita almeno una volta in un server di distribuzione che supporta l'aggiornamento in coda dopo sp_adddistributiondb ma prima di sp_addpublication.

Il processo dell'agente di lettura coda viene rimosso quando si esegue sp_dropdistributiondb.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_addqreader_agent.