sp_change_subscription_properties (Transact-SQL)

Artikel
12/22/2023

Gilt für:SQL Server Azure SQL Managed Instance

Aktualisiert Informationen für Pullabonnements. Diese gespeicherte Prozedur wird beim Abonnenten in der Abonnementdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_change_subscription_properties [ @publisher = ] 'publisher'  
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication = ] 'publication'  
        , [ @property = ] 'property'  
        , [ @value = ] 'value'  
    [ , [ @publication_type = ] publication_type ]

Argumente

[ @publisher = ] 'publisher' Ist der Name des Herausgebers. Publisher ist "sysname" ohne Standard.

[ @publisher_db = ] 'publisher_db' Ist der Name der Publisher-Datenbank. publisher_db ist "sysname" ohne Standard.

[ @publication = ] 'publication' Ist der Name der Publikation. Publikation ist sysname, ohne Standard.

[ @property = ] 'property' Soll die Eigenschaft geändert werden. eigenschaft ist sysname.

[ @value = ] 'value' Ist der neue Wert der Eigenschaft. wert ist nvarchar(1000), ohne Standard.

[ @publication_type = ] publication_type Gibt den Replikationstyp der Publikation an. publication_type ist int und kann einer dieser Werte sein.

Wert	Publication type
0	Transaktionen
1	Snapshot
2	Merge
NULL (Standard)	Die Replikation bestimmt den Veröffentlichungstyp. Da die gespeicherte Prozedur mehrere Tabellen durchsuchen muss, ist diese Option langsamer, als wenn der genaue Veröffentlichungstyp angegeben wird.

Diese Tabelle beschreibt die Eigenschaften von Artikeln und die Werte für diese Eigenschaften.

Eigenschaft	Wert	Beschreibung
alt_snapshot_folder		Gibt den Speicherort des anderen Ordners für die Momentaufnahme an. Wenn NULL festgelegt ist, werden die Momentaufnahmedateien aus dem vom Verleger angegebenen Standardspeicherort übernommen.
distrib_job_login		Melden Sie sich für das Microsoft Windows-Konto an, unter dem der Agent ausgeführt wird.
distrib_job_password		Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird.
distributor_login		Verteilerbenutzername.
distributor_password		Händlerkennwort.
distributor_security_mode	1	Verwendet die Windows-Authentifizierung beim Herstellen der Verbindung mit dem Verteiler.
	0	Verwenden Sie die SQL Server-Authentifizierung beim Herstellen einer Verbindung mit dem Verteiler.
dts_package_name		Gibt den Namen des SQL Server 2000 DTS-Pakets (Data Transformation Services) an. Dieser Wert kann nur bei einer Transaktions- oder Momentaufnahmeveröffentlichung angegeben werden.
dts_package_password		Gibt das Kennwort für das Paket an. dts_package_password ist "sysname" mit einem Standardwert von NULL, der angibt, dass die Kennworteigenschaft unverändert bleiben soll. Hinweis: Ein DTS-Paket muss über ein Kennwort verfügen. Dieser Wert kann nur bei einer Transaktions- oder Momentaufnahmeveröffentlichung angegeben werden.
dts_package_location		Speicherort, an dem das DTS-Paket gespeichert ist. Dieser Wert kann nur bei einer Transaktions- oder Momentaufnahmeveröffentlichung angegeben werden.
dynamic_Momentaufnahme_location		Gibt den Pfad zum Ordner an, in dem die Momentaufnahmedateien gespeichert werden. Dieser Wert kann nur bei einer Mergeveröffentlichung angegeben werden.
ftp_address		Nur aus Gründen der Abwärtskompatibilität beibehalten
ftp_login		Nur aus Gründen der Abwärtskompatibilität beibehalten
ftp_password		Nur aus Gründen der Abwärtskompatibilität beibehalten
ftp_port		Nur aus Gründen der Abwärtskompatibilität beibehalten
hostname		Hostname, der beim Herstellen der Verbindung mit dem Verleger verwendet wird.
internet_login		Der Anmeldename, der vom Merge-Agent zum Herstellen einer Verbindung mit dem Webserver verwendet wird, der die Websynchronisierung mithilfe der Standardauthentifizierung hostet.
internet_password		Das vom Merge-Agent verwendete Kennwort für die Herstellung einer Verbindung mit dem Webserver, der die Websynchronisierung hostet, wobei die Verbindung über die Standardauthentifizierung erfolgt.
internet_security_mode	1	Verwendet für die Websynchronisierung die integrierte Windows-Authentifizierung. Wir empfehlen, bei der Websynchronisierung die Standardauthentifizierung zu verwenden. Weitere Informationen finden Sie unter Configure Web Synchronization.
	0	Verwendet für die Websynchronisierung die Standardauthentifizierung. Hinweis: Für die Websynchronisierung ist eine TLS-Verbindung mit dem Webserver erforderlich.
internet_timeout		Zeit in Sekunden, bevor eine Anforderung für eine Websynchronisierung abläuft.
internet_url		URL, die den Speicherort des Replikationslisteners für die Websynchronisierung darstellt.
merge_job_login		Anmeldename für das Windows-Konto, unter dem der Agent ausgeführt wird.
merge_job_password		Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird.
publisher_login		Der Benutzername des Verlegers. Das Ändern publisher_login wird nur für Abonnements zum Zusammenführen von Publikationen unterstützt.
publisher_password		Publisher-Kennwort. Das Ändern publisher_password wird nur für Abonnements zum Zusammenführen von Publikationen unterstützt.
publisher_security_mode	1	Verwendung der Windows-Authentifizierung für die Verbindung mit dem Verleger. Das Ändern publisher_security_mode wird nur für Abonnements zum Zusammenführen von Publikationen unterstützt.
	0	Verwenden Sie die SQL Server-Authentifizierung beim Herstellen einer Verbindung mit dem Publisher.
use_ftp	true	Verwendet FTP anstelle des regulären Protokolls zum Abrufen von Momentaufnahmen.
	false	Verwendet das reguläre Protokoll zum Abrufen von Momentaufnahmen.
use_web_sync	true	Aktiviert die Websynchronisierung.
	false	Deaktiviert die Websynchronisierung.
working_directory		Name des Arbeitsverzeichnisses für die temporäre Speicherung von Daten und Schemadateien für die Veröffentlichung, wenn für das Übertragen von Momentaufnahmedateien FTP (File Transfer Protocol) verwendet wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_change_subscription_properties wird in allen Replikationstypen verwendet.

sp_change_subscription_properties wird für Pullabonnements verwendet.

Für Oracle Publisher wird der Wert von publisher_db ignoriert, da Oracle nur eine Datenbank pro Instanz des Servers zulässt.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder db_owner festen Datenbankrolle können sp_change_subscription_properties ausgeführt werden.

Weitere Informationen

Anzeigen und Ändern der Eigenschaften von Pullabonnements
sp_addmergepullsubscription (Transact-SQL)
sp_addmergepullsubscription_agent (Transact-SQL)
sp_addpullsubscription (Transact-SQL)
sp_addpullsubscription_agent (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)