sp_change_subscription_properties (Transact-SQL)

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

Icona di collegamento a un argomentoConvenzioni della 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 è di tipo sysname e non prevede alcun valore predefinito.

  • [ @publisher_db=] 'publisher_db'
    Nome del database del server di pubblicazione. publisher_db è di tipo sysname e non prevede alcun valore predefinito.

  • [ @publication=] 'publication'
    Nome della pubblicazione. publication è di tipo sysname e non prevede alcun valore predefinito.

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

  • [ @value=] 'value'
    Nuovo valore della proprietà. value è di tipo nvarchar(1000) e non prevede alcun valore predefinito.

  • [ @publication_type = ] publication_type
    Specifica il tipo di replica della pubblicazione. publication_type è di tipo int e i possibili valori sono i seguenti.

    Valore

    Tipo di pubblicazione

    0

    Transazionale.

    1

    Snapshot.

    2

    Merge.

    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

 

Account di accesso per l'account di Microsoft 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

Consente di utilizzare 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 del pacchetto. dts_package_password è di tipo sysname e il valore predefinito è NULL, che indica che la proprietà della password deve rimanere invariata.

NotaNota
A ogni pacchetto DTS deve essere associata 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 ulteriori informazioni, vedere Configurazione della sincronizzazione tramite il Web.

 

0

Consente di utilizzare l'autenticazione di base per la sincronizzazione Web.

NotaNota
Per la sincronizzazione Web è necessaria una connessione SSL 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 utilizzato 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. Il parametro publisher_login può essere modificato solo per sottoscrizioni di pubblicazioni di tipo merge.

publisher_password

 

Password per il server di pubblicazione. Il parametro publisher_password può essere modificato solo per sottoscrizioni di pubblicazioni di tipo merge.

publisher_security_mode

1

Consente di utilizzare l'autenticazione di Windows per la connessione al server di pubblicazione. Il parametro publisher_security_mode può essere modificato solo per sottoscrizioni di pubblicazioni di tipo merge.

 

0

Consente di utilizzare 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

Attiva la sincronizzazione Web.

 

false

Disattiva 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 restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

sp_change_subscription_properties viene utilizzata per tutti i tipi di replica.

sp_change_subscription_properties viene utilizzata per le sottoscrizioni pull.

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

Autorizzazioni

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