sp_change_subscription_properties (Transact-SQL)
Aggiorna le informazioni per le sottoscrizioni pull. Questa stored procedure viene eseguita nel database di sottoscrizione del Sottoscrittore.
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).
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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Vedere anche
Riferimento
sp_addmergepullsubscription (Transact-SQL)
sp_addmergepullsubscription_agent (Transact-SQL)
sp_addpullsubscription (Transact-SQL)
sp_addpullsubscription_agent (Transact-SQL)
Stored procedure di sistema (Transact-SQL)
Altre risorse
How to: View and Modify Pull Subscription Properties (Replication Transact-SQL Programming)