sp_MSchange_distribution_agent_properties (Transact-SQL)

Articolo
12/22/2023

Si applica a:SQL Server

Modifica le proprietà di un processo agente di distribuzione eseguito in un server di distribuzione di Microsoft SQL Server 2005 (9.x) o versione successiva. Questa stored procedure viene utilizzata per modificare le proprietà quando il server di pubblicazione viene eseguito in un'istanza di SQL Server 2000 (8.x). La stored procedure viene eseguita nel database di distribuzione del server di distribuzione.

Convenzioni di sintassi Transact-SQL

Sintassi

  
sp_MSchange_distribution_agent_properties [ @publisher = ] 'publisher'  
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication = ] 'publication'   
        , [ @subscriber = ] 'subscriber'   
        , [ @subscriber_db = ] 'subscriber_db'   
        , [ @property = ] 'property'   
        , [ @value = ] 'value' ]

Argomenti

[ @publisher = ] 'publisher' Nome del server di pubblicazione. publisher è sysname, senza impostazione predefinita.

[ @publisher_db = ] 'publisher_db' Nome del database di pubblicazione. publisher_db è sysname, senza impostazione predefinita.

[ @publication = ] 'publication' Nome della pubblicazione. publication è sysname, senza impostazione predefinita.

[ @subscriber = ] 'subscriber' Nome del Sottoscrittore. subscriber è sysname, senza impostazione predefinita.

[ @subscriber_db = ] 'subscriber_db' Nome del database di sottoscrizione. subscriber_db è sysname, senza impostazione predefinita.

[ @property = ] 'property' Proprietà della pubblicazione da modificare. property è sysname, senza impostazione predefinita.

[ @value = ] 'value' Nuovo valore della proprietà. value è nvarchar(524), con valore predefinito NULL.

Nella tabella seguente vengono descritte le proprietà del processo dell'agente di distribuzione che è possibile modificare e le limitazioni previste per i valori delle proprietà.

Proprietà	valore	Descrizione
distrib_job_login		Accedere per l'account di Microsoft Windows con cui viene eseguito l'agente.
distrib_job_password		Password dell'account di Windows utilizzato per l'esecuzione del processo dell'agente.
subscriber_catalog		Catalogo da utilizzare per stabilire una connessione al provider OLE DB Questa proprietà è valida solo per i Sottoscrittori non SQL Server .
subscriber_datasource		Nome dell'origine dei dati riconosciuto dal provider OLE DB. Questa proprietà è valida solo per i Sottoscrittori non SQL Server .
subscriber_location		Percorso del database riconosciuto dal provider OLE DB. Questa proprietà è valida solo per i Sottoscrittori non SQL Server .
subscriber_login		Account di accesso da utilizzare durante la connessione a un Sottoscrittore per sincronizzare la sottoscrizione.
subscriber_password		Password del Sottoscrittore. Non usare una password vuota. Usare una password complessa.
subscriber_provider		ProgID univoco con il quale viene registrato il provider OLE DB per l'origine dei dati non SQL Server. Questa proprietà è valida solo per i Sottoscrittori non SQL Server .
subscriber_providerstring		Stringa di connessione specifica del provider OLE DB che identifica l'origine dei dati. Questa proprietà è valida solo per i Sottoscrittori non SQL Server.
subscriber_security_mode	1	Autenticazione di Windows. Se possibile, usare l'autenticazione di Windows.
	0	Autenticazione di SQL Server.
subscriber_type	0	Sottoscrittore di SQL Server
	1	Server dell'origine dei dati ODBC.
	3	Provider OLE DB
Subscriptionstreams		Numero di connessioni consentite per agente di distribuzione per l'applicazione in parallelo di modifiche a un Sottoscrittore. Non supportato per sottoscrittori non SQL Server , server di pubblicazione Oracle o sottoscrizioni peer-to-peer.

Nota

Dopo la modifica dell'account di accesso o della password di un agente, è necessario arrestare e riavviare l'agente per rendere effettiva la modifica.

Valori del codice restituito

0 (esito positivo) o 1 (errore)

Osservazioni:

sp_MSchange_distribution_agent_properties viene usato nella replica snapshot e nella replica transazionale.

Quando il server di pubblicazione viene eseguito in un'istanza di SQL Server 2005 (9.x) o versione successiva, è necessario usare sp_changesubscription per modificare le proprietà di un processo agente di merge che sincronizza una sottoscrizione push eseguita nel server di distribuzione.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin nel server di distribuzione possono eseguire sp_MSchange_distribution_agent_properties.

Vedi anche

sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)

Share via