Condividi tramite


sp_addqreader_agent (Transact-SQL)

Si applica a: SQL Server Istanza gestita di SQL di Azure

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.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @job_login = ] N'job_login'

Account di accesso per l'account di Windows con cui viene eseguito l'agente. @job_login è nvarchar(257), con il valore predefinito NULL. Questo account di Windows viene sempre utilizzato per le connessioni dell'agente al server di distribuzione.

[ @job_password = ] N'job_password'

Password per l'account di Windows con cui viene eseguito l'agente. @job_password è sysname, senza impostazione predefinita.

Importante

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

[ @job_name = ] N'job_name'

Nome di un processo dell'agente esistente. @job_name è sysname, con 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 è bit, con un valore predefinito .0

Il valore 1 indica che la routine viene eseguita dal server di pubblicazione nel database di pubblicazione.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_addqreader_agent viene usato nella replica transazionale.

sp_addqreader_agent deve essere eseguito 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.