sp_MSchange_distribution_agent_properties (Transact-SQL)

Modifica le proprietà di un processo dell'agente di distribuzione eseguito in un server di distribuzione Microsoft SQL Server 2005 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. Questa stored procedure viene eseguita nel database di distribuzione del server di distribuzione.

Icona di collegamento a un argomentoConvenzioni della 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 è di tipo sysname e non prevede alcun valore predefinito.

  • [ @publisher_db= ] 'publisher_db'
    Nome del database di pubblicazione. publisher_db è di tipo sysname e non prevede alcun valore predefinito.

  • [ @publication = ] 'publication'
    Nome della pubblicazione. publication è di tipo sysname e non prevede alcun valore predefinito.

  • [ @subscriber= ] 'subscriber'
    Nome del Sottoscrittore. subscriber è di tipo sysname e non prevede alcun valore predefinito.

  • [ @subscriber_db= ] 'subscriber_db'
    Nome del database di sottoscrizione. subscriber_db è di tipo sysname e non prevede alcun valore predefinito.

  • [ @property = ] 'property'
    Proprietà della pubblicazione da modificare. property è di tipo sysname e non prevede alcun valore predefinito.

  • [ @value = ] 'value'
    Nuovo valore della proprietà. value è di tipo nvarchar(524) e il 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

    Account di accesso per l'account di MicrosoftWindows utilizzato per l'esecuzione dell'agente.

    distrib_job_password

    Password dell'account di Windows utilizzato per l'esecuzione del processo dell'agente.

    subscriber_catalog

    Catalogo utilizzato quando si stabilisce una connessione al provider OLE DB. Questa proprietà è valida solo per i Sottoscrittori non SQL Server..

    subscriber_datasource

    Nome dell'origine dei dati interpretato dal provider OLE DB. Questa proprietà è valida solo per i Sottoscrittori non SQL Server..

    subscriber_location

    Posizione del database interpretata dal provider OLE DB. Questa proprietà è valida solo per i Sottoscrittori non SQL Server..

    subscriber_login

    Account di accesso da utilizzare per la connessione a un Sottoscrittore per sincronizzare la sottoscrizione.

    subscriber_password

    Password del Sottoscrittore.

    Non utilizzare una password vuota. Utilizzare una password complessa.

    subscriber_provider

    Identificatore univoco a livello di codice (PROGID) in base al 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 per il 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, utilizzare l'autenticazione di Windows.

    0

    Autenticazione di SQL Server.

    subscriber_type

    0

    Sottoscrittore 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. Parametro non supportato per Sottoscrittori non SQL Server, server di pubblicazione Oracle e sottoscrizioni peer-to-peer.

    Nota

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

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_MSchange_distribution_agent_properties viene utilizzata per la replica snapshot e transazionale.

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

Autorizzazioni

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