Anzeigen und Ändern von VeröffentlichungseigenschaftenView and Modify Publication Properties

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

In diesem Thema wird beschrieben, wie die Veröffentlichungseigenschaften in SQL ServerSQL Server mit SQL Server Management StudioSQL Server Management Studio, Transact-SQLTransact-SQLoder Replikationsverwaltungsobjekten (RMO) angezeigt und geändert werden.This topic describes how to view and modify publication properties in SQL ServerSQL Server by using SQL Server Management StudioSQL Server Management Studio, Transact-SQLTransact-SQL, or Replication Management Objects (RMO).

In diesem ThemaIn This Topic

VorbereitungenBefore You Begin

EinschränkungenLimitations and Restrictions

  • Einige Eigenschaften können nicht geändert werden, nachdem eine Veröffentlichung erstellt wurde. Andere Eigenschaften können nicht geändert werden, wenn Abonnements für die Veröffentlichung vorhanden sind.Some properties cannot be modified after a publication has been created, and others cannot be modified if there are subscriptions to the publication. Eigenschaften, die nicht geändert werden können, werden als schreibgeschützt angezeigt.Properties that cannot be modified are displayed as read-only.

EmpfehlungenRecommendations

Verwenden von SQL Server Management StudioUsing SQL Server Management Studio

Sie können die Eigenschaften von Veröffentlichungen im Dialogfeld Veröffentlichungseigenschaften - <<Veröffentlichung> anzeigen und ändern. Dieses Dialogfeld ist in SQL Server Management StudioSQL Server Management Studio und im Replikationsmonitor verfügbar.View and modify publication properties in the Publication Properties - <Publication> dialog box, which is available in SQL Server Management StudioSQL Server Management Studio and Replication Monitor. Informationen zum Starten des Replikationsmonitors finden Sie unter Starten des Replikationsmonitors.For information about starting Replication Monitor, see Start the Replication Monitor.

Das Dialogfeld Veröffentlichungseigenschaften - <<Veröffentlichung> enthält folgende Seiten:The Publication Properties - <Publication> dialog box includes the following pages:

  • Die Seite Allgemein enthält den Namen und die Beschreibung der Veröffentlichung, den Datenbanknamen, den Typ der Veröffentlichung und die Einstellungen für den Abonnementablauf.The General page includes the publication name and description, the database name, the type of publication, and the subscription expiration settings.

  • Die Seite Artikel entspricht der Seite Artikel des Assistenten für neue Veröffentlichung.The Articles page corresponds to the Articles page in the New Publication Wizard. Verwenden Sie diese Seite, um Artikel hinzuzufügen und zu löschen und um Eigenschaften sowie die Spaltenfilterung für Artikel zu ändern.Use this page to add and delete articles, and to change properties and column filtering for articles.

  • Die Seite Zeilen filtern entspricht der Seite Tabellenzeilen filtern des Assistenten für neue Veröffentlichung.The Filter Rows page corresponds to the Filter Table Rows page in the New Publication Wizard. Mithilfe dieser Seite können Sie statische Zeilenfilter für sämtliche Veröffentlichungstypen hinzufügen, bearbeiten und löschen sowie parametrisierte Zeilenfilter und Joinfilter für Mergeveröffentlichungen hinzufügen, bearbeiten und löschen.Use this page to add, edit, and delete static row filters for all types of publications, and to add, edit, and delete parameterized row filters and join filters for merge publications.

  • Auf der Seite Momentaufnahme können Sie das Format und den Speicherort der Momentaufnahme angeben und zudem angeben, ob die Momentaufnahme komprimiert werden soll und ob Skripts ausgeführt werden sollen, bevor und nachdem die Momentaufnahme angewendet wird.The Snapshot page allows you to specify the format and location of the snapshot, whether the snapshot should be compressed, and scripts to run before and after the snapshot is applied.

  • Die Seite FTP-Momentaufnahme (bei Momentaufnahme- und Transaktionsveröffentlichungen sowie Mergeveröffentlichungen für Verleger, auf denen frühere Versionen als SQL Server 2005 ausgeführt werden) bietet die Möglichkeit anzugeben, ob Abonnenten Momentaufnahmedateien über FTP (File Transfer Protocol) herunterladen können.The FTP Snapshot page (for snapshot and transactional publications, and merge publications for Publishers running versions prior to SQL Server 2005) allows you to specify whether Subscribers can download snapshot files through File Transfer Protocol (FTP).

  • Auf der Seite FTP-Momentaufnahme und Internet (bei Mergeveröffentlichungen von Verlegern, auf denen SQL Server 2005 oder höher ausgeführt wird) können Sie angeben, ob Abonnenten Momentaufnahmedateien per FTP herunterladen können und ob Abonnenten Abonnements über HTTPS synchronisieren können.The FTP Snapshot and Internet page (for merge publications from Publishers running SQL Server 2005 or later) allows you to specify whether Subscribers can download snapshot files through FTP, and whether Subscribers can synchronize subscriptions through HTTPS.

  • Auf der Seite Abonnementoptionen können Sie eine Reihe von Optionen festlegen, die auf alle Abonnements angewendet werden.The Subscription Options page allows you to set a number of options that apply to all subscriptions. Die Optionen hängen vom Veröffentlichungstyp ab.The options differ depending on the type of publication.

  • Auf der Seite Veröffentlichungszugriffsliste können Sie angeben, welche Anmeldungen und Gruppen auf eine Veröffentlichung zugreifen können.The Publication Access List page allows you to specify which logins and groups can access a publication.

  • Über die Seite Agentsicherheit können Sie auf die Einstellungen für die Konten zugreifen, unter denen folgende Agents ausgeführt werden. Sie können außerdem Verbindungen mit den Computern in einer Replikationstopologie herstellen: Momentaufnahme-Agent für alle Veröffentlichungen, Protokolllese-Agent für alle Transaktionsveröffentlichungen und Warteschlangenlese-Agent für Transaktionsveröffentlichungen, die Abonnements mit verzögertem Update über eine Warteschlange zulassen.The Agent Security page allows you to access settings for the accounts under which the following agents run and make connections to the computers in a replication topology: the Snapshot Agent for all publications; the Log Reader Agent for all transactional publications; and the Queue Reader Agent for transactional publications that allow queued updating subscriptions.

  • Auf der Seite Datenpartitionen (für Mergeveröffentlichungen von Verlegern, auf denen SQL Server 2005 oder höher ausgeführt wird) können Sie angeben, ob Abonnenten von Veröffentlichungen mit parametrisierten Filtern eine Momentaufnahme anfordern können, wenn diese nicht verfügbar ist.The Data Partitions page (for merge publications from Publishers running SQL Server 2005 or later) allows you to specify whether Subscribers to publications with parameterized filters can request a snapshot if one is not available. Sie haben zudem die Möglichkeit, Momentaufnahmen für eine oder mehrere Partitionen entweder einmalig oder wiederkehrend gemäß einem Zeitplan zu generieren.It also allows you to generate snapshots for one or more partitions, either once or on a recurring schedule.

So zeigen Sie Veröffentlichungseigenschaften in Management Studio an und ändern sieTo view and modify publication properties in Management Studio

  1. Stellen Sie in Management StudioManagement Studioeine Verbindung mit dem Verleger her, und erweitern Sie dann den Serverknoten.Connect to the Publisher in Management StudioManagement Studio, and then expand the server node.

  2. Erweitern Sie den Ordner Replikation , und erweitern Sie dann den Ordner Lokale Veröffentlichungen .Expand the Replication folder, and then expand the Local Publications folder.

  3. Klicken Sie mit der rechten Maustaste auf eine Veröffentlichung, und klicken Sie dann auf Eigenschaften.Right-click a publication, and then click Properties.

  4. Ändern Sie die Eigenschaften nach Bedarf, und klicken Sie dann auf OK.Modify any properties if necessary, and then click OK.

So zeigen Sie Veröffentlichungseigenschaften im Replikationsmonitor an und ändern sieTo view and modify publication properties in Replication Monitor

  1. Erweitern Sie im linken Bereich des Replikationsmonitors eine Verlegergruppe, und erweitern Sie dann einen Verleger.Expand a Publisher group in the left pane of Replication Monitor, and then expand a Publisher.

  2. Klicken Sie mit der rechten Maustaste auf eine Veröffentlichung, und klicken Sie dann auf Eigenschaften.Right-click a publication, and then click Properties.

  3. Ändern Sie die Eigenschaften nach Bedarf, und klicken Sie dann auf OK.Modify any properties if necessary, and then click OK.

Verwenden von Transact-SQLUsing Transact-SQL

Veröffentlichungen können mithilfe gespeicherter Replikationsprozeduren programmgesteuert geändert und ihre Eigenschaften zurückgegeben werden.Publications can be modified and their properties returned programmatically using replication stored procedures. Welche gespeicherten Prozeduren Sie verwenden, hängt vom Typ der Veröffentlichung ab.The stored procedures that you use will depend on the type of publication.

So zeigen Sie die Eigenschaften einer Momentaufnahme oder einer Transaktionsveröffentlichung anTo view the properties of a snapshot or transactional publication

  1. Führen Sie sp_helppublication aus, und geben Sie dabei den Namen der Veröffentlichung für den @publication-Parameter an.Execute sp_helppublication, specifying the name of the publication for the @publication parameter. Wenn Sie diesen Parameter nicht angeben, werden Informationen über alle Veröffentlichungen beim Verleger zurückgegeben.If you do not specify this parameter, information on all publications at the Publisher is returned.

So ändern Sie die Eigenschaften einer Momentaufnahme oder einer TransaktionsveröffentlichungTo change the properties of a snapshot or transactional publication

  1. Führen Sie sp_changepublicationaus, und geben Sie dabei die zu ändernde Veröffentlichungseigenschaft im @property-Parameter und den neuen Wert dieser Eigenschaft im @value-Parameter an.Execute sp_changepublication, specifying the publication property to change in the @property parameter and the new value of this property in the @value parameter.

    Hinweis

    Wenn die Änderung das Generieren einer neuen Momentaufnahme erfordert, müssen Sie zudem den Wert 1 für @force_invalidate_snapshot angeben, und wenn die Änderung das nochmalige Initialisieren der Abonnenten erfordert, müssen Sie den Wert 1 für @force_reinit_subscription angeben.If the change will require the generation of a new snapshot, you must also specify a value of 1 for @force_invalidate_snapshot, and if the change will require that Subscribers be reinitialized, you must specify a value of 1 for @force_reinit_subscription. Weitere Informationen über Eigenschaften, die bei Änderung eine neue Momentaufnahme oder eine erneute Initialisierung erfordern, finden Sie unter Ändern von Veröffentlichungs- und Artikeleigenschaften.For more information on the properties that, when changed, require a new snapshot or reinitialization, see Change Publication and Article Properties.

So zeigen Sie die Eigenschaften einer Mergeveröffentlichung anTo view the properties of a merge publication

  1. Führen Sie sp_helpmergepublication aus, und geben Sie dabei den Namen der Veröffentlichung für den @publication-Parameter an.Execute sp_helpmergepublication, specifying the name of the publication for the @publication parameter. Wenn Sie diesen Parameter nicht angeben, werden Informationen über alle Veröffentlichungen beim Verleger zurückgegeben.If you do not specify this parameter, information on all publications at the Publisher is returned.

So ändern Sie die Eigenschaften einer MergeveröffentlichungTo change the properties of a merge publication

  1. Führen Sie sp_changemergepublication aus, und geben Sie dabei die zu ändernde Veröffentlichungseigenschaft im @property-Parameter und den neuen Wert dieser Eigenschaft im @value-Parameter an.Execute sp_changemergepublication, specifying the publication property being changed in the @property parameter and the new value of this property in the @value parameter.

    Hinweis

    Wenn die Änderung das Generieren einer neuen Momentaufnahme erfordert, müssen Sie zudem den Wert 1 für @force_invalidate_snapshot angeben, und wenn die Änderung das nochmalige Initialisieren der Abonnenten erfordert, müssen Sie den Wert1 für @force_reinit_subscription angeben. Weitere Informationen über Eigenschaften, die bei Änderung einer neuen Momentaufnahme oder eine nochmalige Initialisierung erfordern, finden Sie unter Ändern von Veröffentlichungs- und Artikeleigenschaften.If the change will require the generation of a new snapshot, you must also specify a value of 1 for @force_invalidate_snapshot, and if the change will require that Subscribers be reinitialized, you must specify a value of 1 for @force_reinit_subscription For more information on the properties that, when changed, require a new snapshot or reinitialization, see Change Publication and Article Properties.

So zeigen Sie die Eigenschaften einer Momentaufnahme anTo view the properties of a snapshot

  1. Führen Sie sp_helppublication_snapshotaus, und geben Sie dabei den Namen der Veröffentlichung für den @publication-Parameter an.Execute sp_helppublication_snapshot, specifying the name of the publication for the @publication parameter.

So ändern Sie die Eigenschaften einer MomentaufnahmeTo change the properties of a snapshot

  1. Führen Sie sp_changepublication_snapshotaus, und geben Sie dabei eine oder mehrere der neuen Momentaufnahmeeigenschaften für die entsprechenden Momentaufnahmeparameter an.Execute sp_changepublication_snapshot, specifying one or more of the new snapshot properties for the appropriate snapshot parameters.

Beispiele (Transact-SQL)Examples (Transact-SQL)

In diesem Beispiel für Transaktionsreplikation werden die Eigenschaften der Veröffentlichung zurückgegeben.This transactional replication example returns the properties of the publication.

DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran' 

USE [AdventureWorks2012]
EXEC sp_helppublication @publication = @myTranPub
GO

In diesem Beispiel für Transaktionsreplikation wird die Schemareplikation für die Veröffentlichung deaktiviert.This transactional replication example disables schema replication for the publication.

DECLARE @publication AS sysname
SET @publication = N'AdvWorksProductTran' 

-- Turn off DDL replication for the transactional publication.
USE [AdventureWorks2012]
EXEC sp_changepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0
GO

In diesem Beispiel für Mergereplikation werden die Eigenschaften der Veröffentlichung zurückgegeben.This merge replication example returns the properties of the publication.

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

USE [AdventureWorks2012]
EXEC sp_helpmergepublication @publication = @publication;
GO

In diesem Beispiel für Mergereplikation wird die Schemareplikation für die Veröffentlichung deaktiviert.This merge replication example disables schema replication for the publication.

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

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

Verwenden von Replikationsverwaltungsobjekten (RMO)Using Replication Management Objects (RMO)

Sie können Veröffentlichungen ändern und mithilfe von Replikationsverwaltungsobjekten (RMO) programmgesteuert auf ihre Eigenschaften zugreifen.You can modify publications and access their properties programmatically by using Replication Management Objects (RMO). Welche RMO-Klassen zum Anzeigen oder Ändern von Veröffentlichungseigenschaften verwendet werden, hängt vom Typ der Veröffentlichung ab.The RMO classes that you use to view or modify publication properties depend on the type of publication.

So zeigen Sie die Eigenschaften einer Momentaufnahme- oder einer Transaktionsveröffentlichung an oder ändern dieseTo view or modify properties of a snapshot or transactional publication

  1. Erstellen Sie eine Verbindung mit dem Verleger, indem Sie die ServerConnection -Klasse verwenden.Create a connection to the Publisher by using the ServerConnection class.

  2. Erstellen Sie eine Instanz der TransPublication -Klasse, legen Sie die Name -Eigenschaft und die DatabaseName -Eigenschaft der Veröffentlichung fest, und legen Sie die ConnectionContext -Eigenschaft auf die in Schritt 1 erstellte Verbindung fest.Create an instance of the TransPublication class, set the Name and DatabaseName properties for the publication, and set the ConnectionContext property to the connection created in step 1.

  3. Rufen Sie die LoadProperties -Methode auf, um die Eigenschaften des Objekts abzurufen.Call the LoadProperties method to get the properties of the object. Wenn diese Methode falsezurückgibt, sind die Veröffentlichungseigenschaften in Schritt 2 falsch definiert, oder die Veröffentlichung ist nicht vorhanden.If this method returns false, either the publication properties in step 2 were defined incorrectly or the publication does not exist.

  4. (Optional) Um Eigenschaften zu ändern, legen Sie einen neuen Wert für eine oder mehrere festlegbaren Eigenschaften fest.(Optional) To change properties, set a new value for one or more of the settable properties. Verwenden Sie den logischen AND-Operator ( & in Microsoft Visual C# and And in Microsoft Visual Basic), um zu ermitteln, ob ein gegebener PublicationAttributes -Wert für die Attributes -Eigenschaft festgelegt wurde.Use the logical AND operator (& in Microsoft Visual C# and And in Microsoft Visual Basic) to determine if a given PublicationAttributes value is set for the Attributes property. Verwenden Sie den inklusiven logischen OR-Operator ( | in Visual C# and Or in Visual Basic) und den exklusiven logischen OR-Operator ( ^ in Visual C# and Xor in Visual Basic), um die PublicationAttributes -Werte für die Attributes -Eigenschaft festgelegt wurde.Use the inclusive logical OR operator (| in Visual C# and Or in Visual Basic) and the exclusive logical OR operator (^ in Visual C# and Xor in Visual Basic) to change the PublicationAttributes values for the Attributes property.

  5. (Optional) Wenn Sie den Wert true für CachePropertyChangesangegeben haben, rufen Sie die CommitPropertyChanges -Methode auf, um die Änderungen auf dem Server einzutragen.(Optional) If you specified a value of true for CachePropertyChanges, call the CommitPropertyChanges method to commit changes on the server. Wenn Sie den Wert false für CachePropertyChanges (die Standardeinstellung) angegeben haben, werden die Änderungen sofort an den Server gesendet.If you specified a value of false for CachePropertyChanges (the default), changes are sent to the server immediately.

So zeigen Sie die Eigenschaften einer Mergeveröffentlichung an oder ändern dieseTo view or modify properties of a merge publication

  1. Erstellen Sie eine Verbindung mit dem Verleger, indem Sie die ServerConnection -Klasse verwenden.Create a connection to the Publisher by using the ServerConnection class.

  2. Erstellen Sie eine Instanz der MergePublication -Klasse, legen Sie die Name -Eigenschaft und die DatabaseName -Eigenschaft der Veröffentlichung fest, und legen Sie die ConnectionContext -Eigenschaft auf die in Schritt 1 erstellte Verbindung fest.Create an instance of the MergePublication class, set the Name and DatabaseName properties for the publication, and set the ConnectionContext property to the connection created in step 1.

  3. Rufen Sie die LoadProperties -Methode auf, um die Eigenschaften des Objekts abzurufen.Call the LoadProperties method to get the properties of the object. Wenn diese Methode falsezurückgibt, sind die Veröffentlichungseigenschaften in Schritt 2 falsch definiert, oder die Veröffentlichung ist nicht vorhanden.If this method returns false, either the publication properties in step 2 were defined incorrectly or the publication does not exist.

  4. (Optional) Um Eigenschaften zu ändern, legen Sie einen neuen Wert für eine oder mehrere festlegbaren Eigenschaften fest.(Optional) To change properties, set a new value for one or more of the settable properties. Verwenden Sie den logischen AND-Operator ( & in Visual C# and And in Microsoft Visual Basic), um zu ermitteln, ob ein gegebener PublicationAttributes -Wert für die Attributes -Eigenschaft festgelegt wurde.Use the logical AND operator (& in Visual C# and And in Visual Basic) to determine if a given PublicationAttributes value is set for the Attributes property. Verwenden Sie den inklusiven logischen OR-Operator ( | in Visual C# and Or in Visual Basic) und den exklusiven logischen OR-Operator ( ^ in Visual C# and Xor in Visual Basic), um die PublicationAttributes -Werte für die Attributes -Eigenschaft festgelegt wurde.Use the inclusive logical OR operator (| in Visual C# and Or in Visual Basic) and the exclusive logical OR operator (^ in Visual C# and Xor in Visual Basic) to change the PublicationAttributes values for the Attributes property.

  5. (Optional) Wenn Sie den Wert true für CachePropertyChangesangegeben haben, rufen Sie die CommitPropertyChanges -Methode auf, um die Änderungen auf dem Server einzutragen.(Optional) If you specified a value of true for CachePropertyChanges, call the CommitPropertyChanges method to commit changes on the server. Wenn Sie den Wert false für CachePropertyChanges (die Standardeinstellung) angegeben haben, werden die Änderungen sofort an den Server gesendet.If you specified a value of false for CachePropertyChanges (the default), changes are sent to the server immediately.

Beispiele (RMO)Examples (RMO)

In diesem Beispiel werden Veröffentlichungsattribute einer Transaktionsveröffentlichung festgelegt.This example sets publication attributes for a transactional publication. Die Änderungen werden zwischengespeichert, bis sie explizit zum Server gesendet werden.The changes are cached until explicitly sent to the server.

// Define the server, database, and publication names
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";

TransPublication publication;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

try
{
    // Connect to the Publisher.
    conn.Connect();

    // Set the required properties for the publication.
    publication = new TransPublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;

    // Explicitly enable caching of property changes on this object.
    publication.CachePropertyChanges = true;

    // If we can't get the properties for this publication, 
    // throw an application exception.
    if (publication.LoadProperties())
    {
        // Enable support for push subscriptions and disable support 
        // for pull subscriptions.
        if ((publication.Attributes & PublicationAttributes.AllowPull) != 0)
        {
            publication.Attributes ^= PublicationAttributes.AllowPull;
        }
        if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
        {
            publication.Attributes |= PublicationAttributes.AllowPush;
        }

        // Send changes to the server.
        publication.CommitPropertyChanges();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "Settings could not be retrieved for the publication. " +
            "Ensure that the publication {0} exists on {1}.",
            publicationName, publisherName));
    }
}
catch (Exception ex)
{
    // Do error handling here.
    throw new ApplicationException(
        "The publication property could not be changed.", ex);
}
finally
{
    conn.Disconnect();
}
' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publication As TransPublication

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Set the required properties for the publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Explicitly enable caching of property changes on this object.
    publication.CachePropertyChanges = True

    ' If we can't get the properties for this publication, 
    ' throw an application exception.
    If publication.LoadProperties() Then
        ' Enable support for push subscriptions and disable support 
        ' for pull subscriptions.
        If (publication.Attributes And PublicationAttributes.AllowPull) <> 0 Then
            publication.Attributes = publication.Attributes _
            Xor PublicationAttributes.AllowPull
        End If
        If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPush
        End If

        ' Send changes to the server.
        publication.CommitPropertyChanges()
    Else
        Throw New ApplicationException(String.Format( _
         "Settings could not be retrieved for the publication. " + _
         "Ensure that the publication {0} exists on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Do error handling here.
    Throw New ApplicationException( _
        "The publication property could not be changed.", ex)
Finally
    conn.Disconnect()
End Try

In diesem Beispiel wird die DDL-Replikation für eine Mergeveröffentlichung deaktiviert.This example disables DDL replication for a merge publication.

// Define the server, database, and publication names
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";

MergePublication publication;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

try
{
    // Connect to the Publisher.
    conn.Connect();

    // Set the required properties for the publication.
    publication = new MergePublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;


    // If we can't get the properties for this merge publication, then throw an application exception.
    if (publication.LoadProperties())
    {
        // If DDL replication is currently enabled, disable it.
        if (publication.ReplicateDdl == DdlReplicationOptions.All)
        {
            publication.ReplicateDdl = DdlReplicationOptions.None;
        }
        else
        {
            publication.ReplicateDdl = DdlReplicationOptions.All;
        }
    }
    else
    {
        throw new ApplicationException(String.Format(
            "Settings could not be retrieved for the publication. " +
            "Ensure that the publication {0} exists on {1}.",
            publicationName, publisherName));
    }
}
catch (Exception ex)
{
    // Do error handling here.
    throw new ApplicationException(
        "The publication property could not be changed.", ex);
}
finally
{
    conn.Disconnect();
}
' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publication As MergePublication

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Set the required properties for the publication.
    publication = New MergePublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' If we can't get the properties for this merge publication, then throw an application exception.
    If publication.LoadProperties() Then
        ' If DDL replication is currently enabled, disable it.
        If publication.ReplicateDdl = DdlReplicationOptions.All Then
            publication.ReplicateDdl = DdlReplicationOptions.None
        Else
            publication.ReplicateDdl = DdlReplicationOptions.All
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "Settings could not be retrieved for the publication. " + _
         "Ensure that the publication {0} exists on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Do error handling here.
    Throw New ApplicationException( _
        "The publication property could not be changed.", ex)
Finally
    conn.Disconnect()
End Try

Weitere InformationenSee Also

Veröffentlichen von Daten und Datenbankobjekten Publish Data and Database Objects
Ändern von Veröffentlichungs- und Artikeleigenschaften Change Publication and Article Properties
Vornehmen von Schemaänderungen in Veröffentlichungsdatenbanken Make Schema Changes on Publication Databases
Replication System Stored Procedures Concepts Replication System Stored Procedures Concepts
Hinzufügen von Artikeln zu einer Veröffentlichung und Löschen von Artikeln aus einer Veröffentlichung (SQL Server Management Studio) Add Articles to and Drop Articles from a Publication (SQL Server Management Studio)
View information and perform tasks using Replication Monitor (Anzeigen von Informationen und Ausführen von Aufgaben mit dem Replikationsmonitor) View Information and Perform Tasks using Replication Monitor
Anzeigen und Ändern von ArtikeleigenschaftenView and Modify Article Properties