sp_change_subscription_properties (Transact-SQL)

Articolo
05/24/2023

Si applica a: SQL Server Istanza gestita di SQL di Azure

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

Convenzioni relative alla 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 è sysname, senza impostazione predefinita.

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

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

[ @property = ] 'property' Proprietà da modificare. property è sysname.

[ @value = ] 'value' Nuovo valore della proprietà. value è nvarchar(1000), senza impostazione predefinita.

[ @publication_type = ] publication_type Specifica il tipo di replica della pubblicazione. publication_type è int e può essere uno di questi valori.

Valore	Publication type
0	Transazionale
1	Snapshot
2	Unire
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		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 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	Usare 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 per il pacchetto. dts_package_password è sysname con un valore predefinito NULL, che specifica che la proprietà password deve essere lasciata invariata. Nota: un pacchetto DTS deve avere 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 altre informazioni, vedere Configure Web Synchronization.
	0	Consente di utilizzare l'autenticazione di base per la sincronizzazione Web. Nota: la sincronizzazione Web richiede una connessione TLS 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 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. La modifica di publisher_login è supportata solo per le sottoscrizioni nelle pubblicazioni di tipo merge.
publisher_password		Password del server di pubblicazione. La modifica di publisher_password è supportata solo per le sottoscrizioni nelle pubblicazioni di tipo merge.
publisher_security_mode	1	Esegue la connessione al server di pubblicazione utilizzando l'autenticazione di Windows. La modifica di publisher_security_mode è supportata solo per le sottoscrizioni nelle pubblicazioni di tipo merge.
	0	Usare 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	Abilita la sincronizzazione Web.
	false	Disabilita 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 del codice restituito

0 (esito positivo) o 1 (errore)

Osservazioni:

sp_change_subscription_properties viene usato in tutti i tipi di replica.

sp_change_subscription_properties viene usato per le sottoscrizioni pull.

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

Autorizzazioni

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

Vedi anche

Visualizzare e modificare le proprietà delle sottoscrizioni pull
sp_addmergepullsubscription (Transact-SQL)
sp_addmergepullsubscription_agent (Transact-SQL)
sp_addpullsubscription (Transact-SQL)
sp_addpullsubscription_agent (Transact-SQL)
Stored procedure di sistema (Transact-SQL)

Condividi tramite