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.

Convenzioni relative alla sintassi Transact-SQL

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 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 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 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.

Contenuto correlato

  • Last updated on