sys.sp_change_subscription_properties (Transact-SQL)

Si applica a:SQL ServerIstanza gestita di SQL di Azure

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

Transact-SQL Convenzioni sintattiche

Sintassi

sys.sp_change_subscription_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
    [ , [ @publication_type = ] publication_type ]
[ ; ]

Argomenti

[ @publisher = ] N'publisher'

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

[ @publisher_db = ] N'publisher_db'

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

[ @publication = ] N'publication'

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

[ @property = ] N'property'

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

[ @value = ] N'value'

Nuovo valore della proprietà. @value è nvarchar(1000), senza default.

[ @publication_type = ] publication_type

Specifica il tipo di replica della pubblicazione. @publication_type è int, con un valore predefinito di NULL, e può essere uno di questi valori:

Valore Tipo di pubblicazione
0 Transazionale
1 Snapshot
2 Unione
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 impostato su NULL, i file di snapshot vengono prelevati dal percorso predefinito specificato dal server di pubblicazione.
distrib_job_login Account di accesso per l'account di 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 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 valore predefinito NULL, che specifica che la proprietà password deve essere lasciata invariata. Questo valore può essere specificato solo se la pubblicazione è di tipo transazionale o snapshot.

Nota: Un pacchetto DTS deve avere una password.
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 Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script.
ftp_login Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script.
ftp_password Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script.
ftp_port Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script.
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 publisher_login è supportata solo per le sottoscrizioni per le pubblicazioni di tipo merge.
publisher_password Password del server di pubblicazione. La modifica publisher_password è supportata solo per le sottoscrizioni per le pubblicazioni di tipo merge.
publisher_security_mode 5 Utilizza l'autenticazione dell'identità gestita Microsoft Entra con l'identità gestita predefinita dell'Abbonato quando ti connetti al Publisher. Applicabile solo per la replica transazioniale quando sia Subscriber che Publisher sono risorse Istanza gestita di SQL di Azure.
1 Esegue la connessione al server di pubblicazione utilizzando l'autenticazione di Windows. La modifica publisher_security_mode è supportata solo per le sottoscrizioni per le pubblicazioni di tipo merge.
0 Usare l'autenticazione di SQL Server per la connessione al server di pubblicazione.
use_ftp true Per recuperare gli snapshot, usare FTP anziché il protocollo normale.
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 (successo) oppure 1 (fallimento).

Osservazioni:

sp_change_subscription_properties è utilizzato in tutti i tipi di replicazione.

sp_change_subscription_properties è utilizzato per gli abbonamenti a pull.

Per i server di pubblicazione Oracle, il valore di @publisher_db viene ignorato poiché Oracle consente solo un 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.