sp_MSchange_distribution_agent_properties (Transact-SQL)

  • Articolo

Si applica a: SQL Server

Modifica le proprietà di un processo agente di distribuzione eseguito in un server di distribuzione di 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 relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @publisher = ] N'publisher'

Nome del server di pubblicazione. @publisher è sysname, senza impostazione predefinita.

[ @publisher_db = ] N'publisher_db'

Nome del database di pubblicazione. @publisher_db è sysname, senza impostazione predefinita.

[ @publication = ] N'publication'

Nome della pubblicazione. @publication è sysname, senza impostazione predefinita.

[ @subscriber = ] N'subscriber'

Nome del Sottoscrittore. @subscriber è sysname, senza impostazione predefinita.

[ @subscriber_db = ] N'subscriber_db'

Nome del database di sottoscrizione. @subscriber_db è sysname, senza impostazione predefinita.

[ @property = ] N'property'

Proprietà della pubblicazione da modificare. @property è sysname, senza impostazione predefinita.

[ @value = ] N'value'

Nuovo valore della proprietà. @value è nvarchar(524), senza impostazione predefinita.

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 1 Catalogo da utilizzare per stabilire una connessione al provider OLE DB
subscriber_datasource 1 Nome dell'origine dei dati riconosciuto dal provider OLE DB.
subscriber_location 1 Percorso del database riconosciuto dal provider OLE DB.
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 1 ProgID univoco con il quale viene registrato il provider OLE DB per l'origine dei dati non SQL Server.
subscriber_providerstring 1 Stringa di connessione specifica del provider OLE DB che identifica l'origine dei dati.
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 2 Numero di connessioni consentite per agente di distribuzione per l'applicazione in parallelo di modifiche a un Sottoscrittore.

1 Valido solo per i Sottoscrittori non SQL Server.

2 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.

È possibile usare sp_changesubscription in un server di pubblicazione per modificare le proprietà di un processo di 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.

Contenuto correlato