sp_changesubscription (Transact-SQL)sp_changesubscription (Transact-SQL)

Gilt für: JaSQL Server JaAzure SQL-Datenbank (nur verwaltete Instanz) NeinAzure Synapse Analytics (SQL DW) NeinParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Ändert die Eigenschaften eines Momentaufnahme- oder Transaktionspushabonnements bzw. eines Pullabonnements, das an einem verzögerten Update über eine Warteschlange beteiligt ist.Changes the properties of a snapshot or transactional push subscription or a pull subscription involved in queued updating transactional replication. Verwenden Sie sp_change_subscription_properties (Transact-SQL-), um die Eigenschaften aller anderen Typen von Pullabonnements zu ändern.To change properties of all other types of pull subscriptions, use sp_change_subscription_properties (Transact-SQL). sp_changesubscription wird auf dem Verleger für die Veröffentlichungs Datenbank ausgeführt.sp_changesubscription is executed at the Publisher on the publication database.

Wichtig

Beim Konfigurieren eines Verlegers mit einem Remoteverteiler werden die Werte, die für alle Parameter, einschließlich job_login und job_password, bereitgestellt werden, als Nur-Text an den Verteiler gesendet.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including job_login and job_password, are sent to the Distributor as plain text. Sie sollten die Verbindung zwischen dem Verleger und dem zugehörigen Remoteverteiler verschlüsseln, bevor Sie diese gespeicherte Prozedur ausführen.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. Weitere Informationen finden Sie unter Aktivieren von verschlüsselten Verbindungen mit dem Datenbank-Engine (SQL Server-Konfigurations-Manager).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

  
sp_changesubscription [ @publication = ] 'publication'  
        , [ @article = ] 'article'  
        , [ @subscriber = ] 'subscriber'  
        , [ @destination_db = ] 'destination_db'  
        , [ @property = ] 'property'  
        , [ @value = ] 'value'  
    [ , [ @publisher = ] 'publisher' ]  

ArgumenteArguments

[ @publication = ] 'publication'Der Name der zu ändernden Veröffentlichung.[ @publication = ] 'publication' Is the name of the publication to change. Publicationist vom Datentyp vom Datentyp sysnameund hat keinen Standardwertpublicationis sysname, with no default

[ @article = ] 'article'Der Name des Artikels, der geändert werden soll.[ @article = ] 'article' Is the name of the article to change. der Artikel ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.article is sysname, with no default.

[ @subscriber = ] 'subscriber'Der Name des Abonnenten.[ @subscriber = ] 'subscriber' Is the name of the Subscriber. Subscriber ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.subscriber is sysname, with no default.

[ @destination_db = ] 'destination_db'Der Name der Abonnement Datenbank.[ @destination_db = ] 'destination_db' Is the name of the subscription database. destination_db ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.destination_db is sysname, with no default.

[ @property = ] 'property'Die Eigenschaft, die für das angegebene Abonnement geändert werden soll.[ @property = ] 'property' Is the property to change for the given subscription. die Eigenschaft ist vom Datentyp nvarchar (30), und es kann sich um einen der Werte in der Tabelle handeln.property is nvarchar(30), and can be one of the values in the table.

[ @value = ] 'value'Der neue Wert für die angegebene Eigenschaft.[ @value = ] 'value' Is the new value for the specified property. der Wert ist vom Datentyp nvarchar (4000). der Wert kann einer der Werte in der Tabelle sein.value is nvarchar(4000), and can be one of the values in the table.

EigenschaftProperty valueValue BESCHREIBUNGDescription
distrib_job_logindistrib_job_login Anmeldename für das MicrosoftMicrosoft Windows-Konto, unter dem der Agent ausgeführt wird.Login for the MicrosoftMicrosoft Windows account under which the agent runs.
distrib_job_passworddistrib_job_password Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird.Password for the Windows account under which the agent runs.
subscriber_catalogsubscriber_catalog Der Katalog, der beim Herstellen einer Verbindung mit dem OLE DB-Anbieter verwendet werden soll.Catalog to be used when making a connection to the OLE DB provider. Diese Eigenschaft ist nur für nicht--MicrosoftMicrosoft SQL ServerSQL Server Abonnenten gültig.This property is only valid for non-MicrosoftMicrosoft SQL ServerSQL Server Subscribers.
subscriber_datasourcesubscriber_datasource Name der Datenquelle im vom OLE DB-Anbieter unterstützten Format.Name of the data source as understood by the OLE DB provider. Diese Eigenschaft ist nur für nicht-- SQL ServerSQL Server Abonnenten gültig.This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_locationsubscriber_location Der Speicherort der Datenbank, wie vom OLE DB Anbieter verstanden.Location of the database as understood by the OLE DB provider. Diese Eigenschaft ist nur für nicht-- SQL ServerSQL Server Abonnenten gültig.This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_loginsubscriber_login Anmeldename auf dem Abonnenten.Login name at the Subscriber.
subscriber_passwordsubscriber_password Sicheres Kennwort für den angegebenen Anmeldenamen.Strong password for the supplied login.
subscriber_security_modesubscriber_security_mode 11 Verwendung der Windows-Authentifizierung für die Verbindung mit dem Abonnenten.Use Windows Authentication when connecting to the Subscriber.
00 Verwendung der SQL ServerSQL Server-Authentifizierung für die Verbindung mit dem Abonnenten.Use SQL ServerSQL Server Authentication when connecting to the Subscriber.
subscriber_providersubscriber_provider Eindeutiger Programmbezeichner (PROGID, Programmatic Identifier), mit dem der OLE DB-Anbieter für die Nicht-SQL ServerSQL Server-Datenquelle registriert wird.Unique programmatic identifier (PROGID) with which the OLE DB provider for the non-SQL ServerSQL Server data source is registered. Diese Eigenschaft ist nur für nicht-- SQL ServerSQL Server Abonnenten gültig.This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_providerstringsubscriber_providerstring Für den OLE DB-Anbieter spezifische Verbindungszeichenfolge, die die Datenquelle identifiziert.OLE DB provider-specific connection string that identifies the data source. Diese Eigenschaft ist nur für nicht-- SQL ServerSQL Server Abonnenten gültig.This property is only valid for non-SQL ServerSQL Server Subscribers.
SubscriptionStreamssubscriptionstreams Die pro Verteilungs-Agent zulässige Anzahl von Verbindungen, um Batches von Änderungen parallel auf einen Abonnenten anzuwenden.Is the number of connections allowed per Distribution Agent to apply batches of changes in parallel to a Subscriber. Für SQL ServerSQL Server Verleger wird ein Wertebereich zwischen 1 und 64 unterstützt.A range of values from 1 to 64 is supported for SQL ServerSQL Server Publishers. Diese Eigenschaft muss für **** nicht--SQL ServerSQL Server Abonnenten, Oracle-Verleger oder Peer-zu-Peer-Abonnements den Wert 0 aufweisen.This property must be 0 for non-SQL ServerSQL Server Subscribers, Oracle Publishers or peer-to-peer subscriptions.
subscriber_typesubscriber_type 11 ODBC-DatenquellenserverODBC data source server
3 OLE DB-AnbieterOLE DB provider
memory_optimizedmemory_optimized bitbit Gibt an, dass das Abonnement Speicher optimierte Tabellen unterstützt.Indicates that the subscription supports memory optimized tables. memory_optimized ist " Bit", wobei "1" true ist (das Abonnement unterstützt Speicher optimierte Tabellen).memory_optimized is bit, where 1 equals true (the subscription supports memory optimized tables).

[ @publisher = ] 'publisher'Gibt einen nicht- SQL ServerSQL Server -Verleger an.[ @publisher = ] 'publisher' Specifies a non- SQL ServerSQL Server Publisher. Publisher ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.publisher is sysname, with a default of NULL.

Hinweis

der Verleger darf nicht für einen SQL ServerSQL Server Verleger angegeben werden.publisher should not be specified for a SQL ServerSQL Server Publisher.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

BemerkungenRemarks

sp_changesubscription wird bei der Momentaufnahme-und Transaktions Replikation verwendet.sp_changesubscription is used in snapshot and transactional replication.

sp_changesubscription können nur zum Ändern der Eigenschaften von Pushabonnements oder Pullabonnements verwendet werden, die an einer verzögertem Update-Transaktions Replikation beteiligt sind.sp_changesubscription can only be used to modify the properties of push subscriptions or pull subscriptions involved in queued updating transactional replication. Verwenden Sie sp_change_subscription_properties (Transact-SQL-), um die Eigenschaften aller anderen Typen von Pullabonnements zu ändern.To change properties of all other types of pull subscriptions, use sp_change_subscription_properties (Transact-SQL).

Nach dem Ändern des Anmeldenamens oder Kennworts eines Agents müssen Sie den Agent beenden und neu starten, damit die Änderungen in Kraft treten.After changing an agent login or password, you must stop and restart the agent before the change takes effect.

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin oder der festen Daten Bank Rolle db_owner können sp_changesubscriptionausführen.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changesubscription.

Weitere InformationenSee Also

sp_addsubscription (Transact-SQL-) sp_addsubscription (Transact-SQL)
sp_dropsubscription (Transact-SQL-)sp_dropsubscription (Transact-SQL)