sys.sp_changesubscription (Transact-SQL)

Si applica a:SQL ServerIstanza gestita di SQL di Azure

Modifica le proprietà di una sottoscrizione pull o push transazionale o snapshot coinvolta in una replica transazionale ad aggiornamento in coda. Per modificare le proprietà di tutti gli altri tipi di sottoscrizioni pull, usare sp_change_subscription_properties. sp_changesubscriptionviene eseguito presso il Publisher nel database delle pubblicazioni.

Importante

Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori forniti per tutti i parametri, inclusi @job_login e @job_password, vengono inviati al server di distribuzione come testo normale. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di eseguire questa stored procedure. Per ulteriori informazioni, vedere Configurare il motore di database di SQL Server per la crittografia delle connessioni.

Transact-SQL Convenzioni sintattiche

Sintassi

sys.sp_changesubscription
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    , [ @subscriber = ] N'subscriber'
    , [ @destination_db = ] N'destination_db'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

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

[ @article = ] N'article'

Nome dell'articolo da modificare. @article è sysname, senza predefinizione.

[ @subscriber = ] N'subscriber'

Nome del Sottoscrittore. @subscriber è sysname, senza impostazione predefinita.

[ @destination_db = ] N'destination_db'

Nome del database di sottoscrizione. @destination_db è sysname, senza impostazione predefinita.

[ @property = ] N'property'

Proprietà da modificare per la sottoscrizione specificata. @property è nvarchar(30) e può essere uno dei valori nella tabella.

[ @value = ] N'value'

Il nuovo valore per il @property specificato. @value è nvarchar(4000) e può essere uno dei valori presenti nella tabella.

Proprietà valore Descrizione
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.
subscriber_catalog 1 Catalogo da utilizzare per stabilire una connessione al provider OLE DB
subscriber_datasource 1 Nome dell'origine dei dati riconosciuto dal provider OLE DB.
subscriber_location 1 Percorso del database riconosciuto dal provider OLE DB.
subscriber_login Nome dell'account di accesso nel Sottoscrittore.
subscriber_password Password complessa per l'account di accesso fornito.
subscriber_security_mode 5 Utilizza l'autenticazione dell'identità gestita Microsoft Entra con l'identità gestita predefinita del Distributore quando ti connetti all'abbonato push. Applicabile solo nella replicazione transazionale quando Distributore è una risorsa Istanza gestita di SQL di Azure e Subscriber è Istanza gestita di SQL di Azure o database SQL di Azure.
1 Esegue la connessione al Sottoscrittore utilizzando l'autenticazione di Windows.
0 Usare l'autenticazione di SQL Server per la connessione al Sottoscrittore.
subscriber_provider 1 ProgID univoco con il quale viene registrato il provider OLE DB per l'origine dei dati non SQL Server.
subscriber_providerstring 1 Stringa di connessione specifica del provider OLE DB che identifica l'origine dei dati.
subscriptionstreams Numero di connessioni consentite per agente di distribuzione di applicare batch di modifiche in parallelo a un Sottoscrittore. È supportato un intervallo di valori da 1 a 64 per i server di pubblicazione di SQL Server. Questa proprietà deve essere 0 per sottoscrittori non SQL Server, server di pubblicazione Oracle o sottoscrizioni peer-to-peer.
subscriber_type 1 Server dell'origine dei dati ODBC.
3 Provider OLE DB
memory_optimized bit Indica che la sottoscrizione supporta tabelle ottimizzate per la memoria. memory_optimized is bit, dove 1 is true (l'abbonamento supporta tabelle ottimizzate per memoria).

1 Questa proprietà è valida solo per gli abbonati non SQL Server.

[ @publisher = ] N'publisher'

Specifica un server di pubblicazione non SQL Server. @publisher è sysname, con un valore predefinito di NULL.

@publisher non dovrebbe essere specificato per un SQL Server Publisher.

Valori del codice restituito

0 (successo) oppure 1 (fallimento).

Osservazioni:

sp_changesubscription è utilizzato nella replica snapshot e transazioniale.

sp_changesubscription può essere utilizzato solo per modificare le proprietà degli abbonamenti push o degli abbonamenti pull coinvolti nella replica transazionale con aggiornamento in coda. Per modificare le proprietà di tutti gli altri tipi di sottoscrizioni pull, usare sp_change_subscription_properties.

Dopo la modifica dell'account di accesso o della password di un agente, è necessario arrestare e riavviare l'agente per rendere effettiva la modifica.

Autorizzazioni

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