Articolo
03/31/2012

sp_change_subscription_properties (Transact-SQL)

Aggiorna le informazioni per le sottoscrizioni pull. Questa stored procedure viene eseguita nel database di sottoscrizione del Sottoscrittore.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

sp_change_subscription_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @publication = ] 'publication'
        , [ @property = ] 'property'
        , [ @value = ] 'value'
    [ , [ @publication_type = ] publication_type ]

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 del server 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.
[ @property=] 'property'
Proprietà da modificare. property è di tipo sysname.
[ @value=] 'value'
Nuovo valore della proprietà. value è di tipo nvarchar(1000) e non prevede alcun valore predefinito.

[ @publication_type = ] publication_type
Specifica il tipo di replica della pubblicazione. publication_type è di tipo int e i possibili valori sono i seguenti.

Valore	Tipo di pubblicazione
0	Transazionale.
1	Snapshot.
2	Merge.
NULL (predefinito)	Il tipo di pubblicazione è determinato dalla replica. Poiché la stored procedure deve analizzare più tabelle, questa opzione comporta un rallentamento delle prestazioni rispetto a quando viene specificato il tipo di pubblicazione esatto.

Nella tabella seguente vengono descritte le proprietà degli articoli e i valori corrispondenti.

Proprietà	Valore	Descrizione
alt_snapshot_folder		Specifica la posizione della cartella alternativa per lo snapshot. Se il valore è NULL, i file di snapshot vengono prelevati dalla posizione predefinita specificata dal server di pubblicazione.
distrib_job_login		Account di accesso per l'account di Microsoft Windows utilizzato per l'esecuzione dell'agente.
distrib_job_password		Password dell'account di Windows utilizzato per l'esecuzione dell'agente.
distributor_login		Account di accesso per il server di distribuzione.
distributor_password		Password per il server di distribuzione.
distributor_security_mode	1	Consente di utilizzare l'autenticazione di Windows per la connessione al server di distribuzione.
	0	Consente di utilizzare l'autenticazione di SQL Server per la connessione al server di distribuzione.
dts_package_name		Specifica il nome del pacchetto di SQL Server 2000 Data Transformation Services (DTS). Questo valore può essere specificato solo se la pubblicazione è di tipo transazionale o snapshot.
dts_package_password		Specifica la password del pacchetto. dts_package_password è di tipo sysname e il valore predefinito è NULL, che indica che la proprietà della password deve rimanere invariata. Nota A ogni pacchetto DTS deve essere associata una password. Questo valore può essere specificato solo se la pubblicazione è di tipo transazionale o snapshot.
dts_package_location		Posizione di archiviazione del pacchetto DTS. Questo valore può essere specificato solo se la pubblicazione è di tipo transazionale o snapshot.
dynamic_snapshot_location		Specifica il percorso della cartella in cui vengono salvati i file di snapshot. Questo valore può essere specificato solo se la pubblicazione è di tipo merge.
ftp_address		Disponibile solo per compatibilità con le versioni precedenti.
ftp_login		Disponibile solo per compatibilità con le versioni precedenti.
ftp_password		Disponibile solo per compatibilità con le versioni precedenti.
ftp_port		Disponibile solo per compatibilità con le versioni precedenti.
hostname		Nome host utilizzato per la connessione al server di pubblicazione.
internet_login		Account di accesso utilizzato dall'agente di merge per la connessione al server Web che ospita la sincronizzazione Web tramite l'autenticazione di base.
internet_password		Password utilizzata dall'agente di merge per la connessione al server Web in cui ha luogo la sincronizzazione Web mediante l'autenticazione di base.
internet_security_mode	1	Consente di utilizzare l'autenticazione integrata di Windows per la sincronizzazione Web. È consigliabile utilizzare l'autenticazione di base per la sincronizzazione Web. Per ulteriori informazioni, vedere Configurazione della sincronizzazione tramite il Web.
	0	Consente di utilizzare l'autenticazione di base per la sincronizzazione Web. Nota Per la sincronizzazione Web è necessaria una connessione SSL al server Web.
internet_timeout		Periodo di tempo, espresso in secondi, al termine del quale una richiesta di sincronizzazione Web scade.
internet_url		URL che rappresenta la posizione del listener per la replica utilizzato per la sincronizzazione Web.
merge_job_login		Account di accesso per l'account di Windows utilizzato per l'esecuzione dell'agente.
merge_job_password		Password dell'account di Windows utilizzato per l'esecuzione dell'agente.
publisher_login		Account di accesso per il server di pubblicazione. Il parametro publisher_login può essere modificato solo per sottoscrizioni di pubblicazioni di tipo merge.
publisher_password		Password per il server di pubblicazione. Il parametro publisher_password può essere modificato solo per sottoscrizioni di pubblicazioni di tipo merge.
publisher_security_mode	1	Consente di utilizzare l'autenticazione di Windows per la connessione al server di pubblicazione. Il parametro publisher_security_mode può essere modificato solo per sottoscrizioni di pubblicazioni di tipo merge.
	0	Consente di utilizzare l'autenticazione di SQL Server per la connessione al server di pubblicazione.
use_ftp	true	Consente di utilizzare il protocollo FTP anziché il protocollo regolare per il recupero degli snapshot.
	false	Consente di utilizzare il protocollo regolare per il recupero degli snapshot.
use_web_sync	true	Attiva la sincronizzazione Web.
	false	Disattiva la sincronizzazione Web.
working_directory		Nome della directory di lavoro utilizzata per l'archiviazione temporanea dei file di dati e dello schema della pubblicazione quando per il trasferimento dei file di snapshot viene utilizzato il protocollo FTP (File Transfer Protocol).

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

sp_change_subscription_properties viene utilizzata per tutti i tipi di replica.

sp_change_subscription_properties viene utilizzata per le sottoscrizioni pull.

Per i server di pubblicazione Oracle, il valore di publisher_db viene ignorato perché Oracle consente di utilizzare un solo database per ogni istanza del server.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin o del ruolo predefinito del database db_owner possono eseguire sp_change_subscription_properties.