sp_change_subscription_properties (Transact-SQL)

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 = ] 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 impostazione predefinita.

[ @publication_type = ] publication_type

Specifica il tipo di replica della pubblicazione. @publication_type è int, con un valore predefinito , NULLe può essere uno dei valori seguenti:

Valore Publication type
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 un valore predefinito , NULLche 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 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 (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 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.