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 di 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 vero 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 vero 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)