sp_enableagentoffload (Transact-SQL)

Attiva l'attivazione remota dell'agente di replica push identificato dal parametro @job_id. Questa stored procedure viene eseguita nel computer che corrisponde al server di agenti remoti. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Importante:
Il supporto per l'attivazione remota dell'agente è stata eliminata per i server di distribuzione che eseguono Microsoft SQL Server 2005 e versioni successive.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_enableagentoffload [ @job_id = ] job_id
    [ , [ @offloadserver = ] 'remote_agent_server_name' ]
    [ , [ @agent_type = ] 'agent_type' ]

Argomenti

• [ @job_id=] 'job_id'
  Identificatore di processo di SQL Server Agent dell'agente di replica di cui consentire l'attivazione remota. job_id è di tipo varbinary(16) e non prevede alcun valore predefinito.

• [ @offloadserver=] 'remote_agent_server_name'
  Nome di rete del server da utilizzare per l'attivazione remota degli agenti. remote_agent_server_name è di tipo sysname e il valore predefinito è NULL, con cui viene utilizzato il server corrente specificato in offload_server nella tabella MSDistribution_agents.

• [ @agent_type=] 'agent_type'
  Tipo di agente. agent_type è di tipo sysname e il valore predefinito è NULL, con cui viene determinato automaticamente se si tratta di un agente di distribuzione o di merge. I valori validi sono distribution, merge e NULL.

Osservazioni

La stored procedure sp_enableagentoffload consente di attivare l'elaborazione dell'agente di distribuzione o di merge in un altro server.

Al completamento di sp_enableagentoffload, il parametro –Offloadoffloadserver viene aggiunto alla riga di comando dell'agente di replica o aggiornato in base al nuovo valore di 'remote_agent_server_name' se il parametro –Offloadoffloadserver è già incluso nella riga di comando.

Inoltre, il campo offload_enabled dell'agente in MSdistribution_agents (Transact-SQL) viene impostato su 1 e il campo offload-server viene aggiornato in base all'eventuale nuovo valore specificato in 'remote_agent_server_name'.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin, del ruolo predefinito del database db_owner e il proprietario della sottoscrizione dell'agente specificato possono eseguire sp_enableagentoffload.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Riferimento

Stored procedure di sistema (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005