sp_changemergepublication (Transact-SQL)

Aktualisiert: 12. Dezember 2006

Ändert die Eigenschaften einer Mergepublikation. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_changemergepublication [ @publication= ] 'publication'
    [ , [ @property= ] 'property' ]
    [ , [ @value= ] 'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]

Argumente

• [ @publication=] 'publication'
  Der Name der Publikation. publication ist vom Datentyp sysname und hat keinen Standardwert.

• [ @property=] 'property'
  Die Eigenschaft, die für die angegebene Publikation geändert werden soll. property ist vom Datentyp sysname. Die in der Tabelle aufgeführten Werte sind möglich.

• [ @value=] 'value'
  Der neue Wert der angegebenen Eigenschaft. value ist vom Datentyp nvarchar(255). Die in der Tabelle aufgeführten Werte sind möglich.

  Diese Tabelle beschreibt die änderbaren Eigenschaften der Publikation sowie die Einschränkungen für die Werte dieser Eigenschaften.

  Eigenschaft

• [ @force_invalidate_snapshot = ] force_invalidate_snapshot
  Bestätigt, dass die von dieser gespeicherten Prozedur ausgeführte Aktion einen vorhandenen Snapshot für ungültig erklären kann. force_invalidate_snapshot ist vom Datentyp bit, der Standardwert ist 0.

  Mit dem Wert 0 wird angegeben, dass der Snapshot nicht durch Änderungen an der Publikation ungültig werden kann. Wenn die gespeicherte Prozedur erkennt, dass die Änderungen einen neuen Snapshot erfordern, tritt ein Fehler auf und es werden keine Änderungen vorgenommen.

  Der Wert 1 gibt an, dass der Snapshot durch Ändern der Publikation ungültig werden kann. Wenn Abonnements vorhanden sind, die einen neuen Snapshot erfordern, wird mit diesem Wert die Berechtigung erteilt, den vorhandenen Snapshot als veraltet zu markieren und einen neuen Snapshot zu generieren.

  Weitere Informationen zu den Eigenschaften, bei deren Änderung die Generierung eines neuen Snapshots erforderlich ist, finden Sie im Abschnitt "Hinweise".

• [ @force_reinit_subscription = ] force_reinit_subscription
  Bestätigt, dass die von dieser gespeicherten Prozedur ausgeführte Aktion die erneute Initialisierung vorhandener Abonnements erfordern kann. force_reinit_subscription ist vom Datentyp bit, der Standardwert ist 0.

  Mit dem Wert 0 wird angegeben, dass Abonnements nicht durch Änderungen an der Publikation erneut initialisiert werden müssen. Wenn die gespeicherte Prozedur erkennt, dass die Änderung die erneute Initialisierung von vorhandenen Abonnements erfordert, tritt ein Fehler auf und es werden keine Änderungen ausgeführt.

  Der Wert 1 gibt an, dass Änderungen an der Publikation die erneute Initialisierung vorhandener Abonnements bewirken. Außerdem wird mit diesem Wert die Berechtigung zur erneuten Initialisierung des Abonnements erteilt.

  Weitere Informationen zu den Eigenschaften, bei deren Änderung die erneute Initialisierung aller vorhandenen Abonnements erforderlich ist, finden Sie im Abschnitt "Hinweise".

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changemergepublication wird für die Mergereplikation verwendet.

Das Ändern der folgenden Eigenschaften erfordert die Generierung eines neuen Snapshots, und Sie müssen einen Wert von 1 für den force_invalidate_snapshot-Parameter angeben.

• alt_snapshot_folder
• compress_snapshot
• dynamic_filters
• ftp_address
• ftp_login
• ftp_password
• ftp_port
• ftp_subdirectory
• post_snapshot_script
• publication_compatibility_level (nur 80SP3)
• pre_snapshot_script
• snapshot_in_defaultfolder
• sync_mode
• use_partition_groups

Das Ändern der folgenden Eigenschaften erfordert die erneute Initialisierung vorhandener Abonnements, und Sie müssen einen Wert von 1 für den force_reinit_subscription-Parameter angeben.

• dynamic_filters
• validate_subscriber_info

Das SQL Server-Objekt muss bereits in Active Directory erstellt sein, um Publikationsobjekte mithilfe von publish_to_active_directory aufzulisten.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_changemergepublication ausführen.

Beispiel

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge'; 

-- Disable DDL replication for the publication.
USE [AdventureWorks]
EXEC sp_changemergepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0,
  @force_invalidate_snapshot = 0, 
  @force_reinit_subscription = 0;
GO

Siehe auch

Verweis

sp_addmergepublication (Transact-SQL)
sp_dropmergepublication (Transact-SQL)
sp_helpmergepublication (Transact-SQL)
Gespeicherte Replikationsprozeduren (Transact-SQL)

Andere Ressourcen

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
Ändern von Publikations- und Artikeleigenschaften

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf