TransPublication Klasse

Definition

Namespace:

Microsoft.SqlServer.Replication

Assembly:

Microsoft.SqlServer.Rmo.dll

Stellt eine Transaktionsveröffentlichung dar.

public ref class TransPublication sealed : Microsoft::SqlServer::Replication::Publication

public sealed class TransPublication : Microsoft.SqlServer.Replication.Publication

type TransPublication = class
    inherit Publication

Public NotInheritable Class TransPublication
Inherits Publication

Vererbung

Object

ReplicationObject

Publication

TransPublication

Beispiele

In diesem Beispiel wird eine Transaktionsveröffentlichung erstellt.

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";
string publisherName = publisherInstance;

ReplicationDatabase publicationDb;
TransPublication publication;

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


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

    // Enable the AdventureWorks2012 database for transactional publishing.
    publicationDb = new ReplicationDatabase(publicationDbName, conn);

    // If the database exists and is not already enabled, 
    // enable it for transactional publishing.
    if (publicationDb.LoadProperties())
    {
        if (!publicationDb.EnabledTransPublishing)
        {
            publicationDb.EnabledTransPublishing = true;
        }

        // If the Log Reader Agent does not exist, create it.
        if (!publicationDb.LogReaderAgentExists)
        {
            // Specify the Windows account under which the agent job runs.
            // This account will be used for the local connection to the 
            // Distributor and all agent connections that use Windows Authentication.
            publicationDb.LogReaderAgentProcessSecurity.Login = winLogin;
            publicationDb.LogReaderAgentProcessSecurity.Password = winPassword;

            // Explicitly set authentication mode for the Publisher connection
            // to the default value of Windows Authentication.
            publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = true;

            // Create the Log Reader Agent job.
            publicationDb.CreateLogReaderAgent();
        }
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The {0} database does not exist at {1}.",
            publicationDb, publisherName));
    }

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

    // Specify a transactional publication (the default).
    publication.Type = PublicationType.Transactional;

    // Activate the publication so that we can add subscriptions.
    publication.Status = State.Active;

    // Enable push and pull subscriptions and independent Distribition Agents.
    publication.Attributes |= PublicationAttributes.AllowPull;
    publication.Attributes |= PublicationAttributes.AllowPush;
    publication.Attributes |= PublicationAttributes.IndependentAgent;

    // Specify the Windows account under which the Snapshot Agent job runs.
    // This account will be used for the local connection to the 
    // Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

    // Explicitly set the security mode for the Publisher connection
    // Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

    if (!publication.IsExistingObject)
    {
        // Create the transactional publication.
        publication.Create();

        // Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The {0} publication already exists.", publicationName));
    }
}

catch (Exception ex)
{
    // Implement custom application error handling here.
    throw new ApplicationException(String.Format(
        "The publication {0} could not be created.", publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim publisherName As String = publisherInstance

Dim publicationDb As ReplicationDatabase
Dim publication As TransPublication

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

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

    ' Enable the AdventureWorks2012 database for transactional publishing.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    ' If the database exists and is not already enabled, 
    ' enable it for transactional publishing.
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledTransPublishing Then
            publicationDb.EnabledTransPublishing = True
        End If

        ' If the Log Reader Agent does not exist, create it.
        If Not publicationDb.LogReaderAgentExists Then
            ' Specify the Windows account under which the agent job runs.
            ' This account will be used for the local connection to the 
            ' Distributor and all agent connections that use Windows Authentication.
            publicationDb.LogReaderAgentProcessSecurity.Login = winLogin
            publicationDb.LogReaderAgentProcessSecurity.Password = winPassword

            ' Explicitly set authentication mode for the Publisher connection
            ' to the default value of Windows Authentication.
            publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = True

            ' Create the Log Reader Agent job.
            publicationDb.CreateLogReaderAgent()
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist at {1}.", _
         publicationDb, publisherName))
    End If

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

    ' Specify a transactional publication (the default).
    publication.Type = PublicationType.Transactional

    'Enable push and pull subscriptions and independent Distribition Agents.
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPull
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPush
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.IndependentAgent

    ' Activate the publication so that we can add subscriptions.
    publication.Status = State.Active

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    If Not publication.IsExistingObject Then
        ' Create the transactional publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

In diesem Beispiel wird eine Transaktionsveröffentlichung gelöscht.

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

TransPublication publication;
ReplicationDatabase publicationDb;

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

try
{
    conn.Connect();

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

    // Delete the publication, if it exists and has no subscriptions.
    if (publication.LoadProperties() && !publication.HasSubscription)
    {
        publication.Remove();
    }
    else
    {
        // Do something here if the publication does not exist
        // or has subscriptions.
        throw new ApplicationException(String.Format(
            "The publication {0} could not be deleted. " +
            "Ensure that the publication exists and that all " +
            "subscriptions have been deleted.",
            publicationName, publisherName));
    }

    // If no other transactional publications exists,
    // disable publishing on the database.
    publicationDb = new ReplicationDatabase(publicationDbName, conn);
    if (publicationDb.LoadProperties())
    {
        if (publicationDb.TransPublications.Count == 0)
        {
            publicationDb.EnabledTransPublishing = false;
        }
    }
    else
    {
        // Do something here if the database does not exist.
        throw new ApplicationException(String.Format(
            "The database {0} does not exist on {1}.",
            publicationDbName, publisherName));
    }
}
catch (Exception ex)
{
    // Implement application error handling here.
    throw new ApplicationException(String.Format(
        "The publication {0} could not be deleted.",
        publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Define the Publisher, publication database, 
' and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publication As TransPublication
Dim publicationDb As ReplicationDatabase

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

Try
    conn.Connect()

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

    ' Delete the publication, if it exists and has no subscriptions.
    If publication.LoadProperties() And Not publication.HasSubscription Then
        publication.Remove()
    Else
        ' Do something here if the publication does not exist
        ' or has subscriptions.
        Throw New ApplicationException(String.Format( _
         "The publication {0} could not be deleted. " + _
         "Ensure that the publication exists and that all " + _
         "subscriptions have been deleted.", _
         publicationName, publisherName))
    End If

    ' If no other transactional publications exists,
    ' disable publishing on the database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If publicationDb.TransPublications.Count = 0 Then
            publicationDb.EnabledTransPublishing = False
        End If
    Else
        ' Do something here if the database does not exist.
        Throw New ApplicationException(String.Format( _
         "The database {0} does not exist on {1}.", _
         publicationDbName, publisherName))
    End If
Catch ex As Exception
    ' Implement application error handling here.
    Throw New ApplicationException(String.Format( _
     "The publication {0} could not be deleted.", _
     publicationName), ex)
Finally
    conn.Disconnect()
End Try

Hinweise

Threadsicherheit

Alle öffentlichen statischen (Shared in Microsoft Visual Basic) Member dieses Typs sind für Multithreadvorgänge sicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Konstruktoren

TransPublication()	Erstellt eine neue Instanz der TransPublication-Klasse.
TransPublication(String, String, ServerConnection)	Erstellt eine neue Instanz der TransPublication-Klasse mit den erforderlichen Eigenschaften.
TransPublication(String, String, ServerConnection, Boolean)	Erstellt eine neue Instanz der TransPublication-Klasse mit den erforderlichen Eigenschaften und gibt an, ob der Momentaufnahme-Agent-Auftrag für die Veröffentlichung erstellt wird.

Eigenschaften

AltSnapshotFolder	Ruft den alternativen Momentaufnahmespeicherort für eine Veröffentlichung ab oder legt ihn fest. (Geerbt von Publication)
Attributes	Ruft die Veröffentlichungsattribute ab oder legt sie fest. (Geerbt von Publication)
CachePropertyChanges	Ruft ab oder legt fest, ob Änderungen an den Replikationseigenschaften zwischengespeichert oder sofort angewendet werden sollen. (Geerbt von ReplicationObject)
CompatibilityLevel	Ruft die früheste Version von Microsoft SQL Server ab, die auf den Abonnenten ausgeführt wird, die von der referenzierten Veröffentlichung unterstützt werden, oder legt diese fest. (Geerbt von Publication)
ConflictPolicy	Ruft die Konfliktrichtlinie für Veröffentlichungen ab, die das Aktualisieren von Abonnements unterstützen, oder legt sie fest.
ConflictRetention	Ruft die Anzahl von Tagen ab, für die Konfliktdatenzeilen in Konflikttabellen beibehalten werden, oder legt sie fest. (Geerbt von Publication)
ConnectionContext	Ruft die Verbindung mit einer Instanz von Microsoft SQL Server ab oder legt sie fest. (Geerbt von ReplicationObject)
ContinueOnConflict	Legt fest, ob der Verteilungs-Agent nach Erkennung eines Konflikts die Verarbeitung von Änderungen fortsetzt.
CreateSnapshotAgentByDefault	Ruft ab oder legt fest, ob der Momentaufnahme-Agent-Auftrag beim Erstellen der Veröffentlichung automatisch hinzugefügt wird. (Geerbt von Publication)
DatabaseName	Ruft den Namen der Veröffentlichungsdatenbank ab oder legt ihn fest. (Geerbt von Publication)
Description	Ruft eine Textbeschreibung der Veröffentlichung ab oder legt sie fest. (Geerbt von Publication)
FtpAddress	Ruft die Adresse des FTP-Servercomputers für Veröffentlichungen ab, die Abonnementinitialisierung über FTP ermöglichen, oder legt sie fest. (Geerbt von Publication)
FtpLogin	Ruft die Anmeldung ab oder legt sie fest, die verwendet wird, um eine Verbindung mit dem FTP-Server für Veröffentlichungen herzustellen, die die Abonnementinitialisierung über FTP ermöglichen. (Geerbt von Publication)
FtpPassword	Legt das Kennwort für die Anmeldung fest, die verwendet wird, um eine Verbindung mit dem FTP-Server für Veröffentlichungen herzustellen, die die Abonnementinitialisierung über FTP ermöglichen. (Geerbt von Publication)
FtpPort	Ruft den Port des FTP-Servers für Veröffentlichungen ab, die Abonnementinitialisierung über FTP ermöglichen, oder legt ihn fest. (Geerbt von Publication)
FtpSubdirectory	Ruft das Unterverzeichnis des FTP-Servers für Veröffentlichungen ab, die Abonnementinitialisierung über FTP ermöglichen, oder legt es fest. (Geerbt von Publication)
HasSubscription	Ruft ab, ob die Veröffentlichung ein oder mehrere Abonnements hat. (Geerbt von Publication)
IsExistingObject	Ruft ab, ob das Objekt auf dem Server vorhanden ist. (Geerbt von ReplicationObject)
Name	Ruft den Namen der Veröffentlichung ab oder legt diesen fest. (Geerbt von Publication)
PeerConflictDetectionEnabled	Ruft ab, ob die Peer-zu-Peer-Konflikterkennung mittels SetPeerConflictDetection(Boolean, Int32) aktiviert wurde.
PeerOriginatorID	+Ruft die ID für einen Knoten in einer Peer-zu-Peer-Topologie ab; diese ID wird für die Konflikterkennung verwendet, wenn PeerConflictDetectionEnabled auf true gesetzt wird.
PostSnapshotScript	Ruft den Namen und den vollständigen Pfad einer Transact-SQL-Skriptdatei ab, die ausgeführt wird, nachdem die anfängliche Momentaufnahme auf den Abonnenten angewendet wurde, oder legt diesen fest. (Geerbt von Publication)
PreSnapshotScript	Ruft den Namen und den vollständigen Pfad einer Transact-SQL-Skriptdatei ab, die ausgeführt wird, bevor die erste Momentaufnahme auf den Abonnenten angewendet wird, oder legt diesen fest. (Geerbt von Publication)
PubId	Ruft den Wert ab, der die Veröffentlichung eindeutig identifiziert. (Geerbt von Publication)
PublisherName	Ruft den Namen des Nicht-SQL Server-Verlegers ab oder legt ihn fest.
QueueType	Ruft den Typ der Warteschlange ab, der für Veröffentlichungen verwendet werden soll, die die verzögerte Aktualisierung von Abonnements über eine Warteschlange zulassen, oder legt ihn fest.
ReplicateDdl	Ruft die DDL-Replikationsoptionen ab, die bestimmen, ob DDL-Änderungen repliziert werden, oder legt sie fest. (Geerbt von Publication)
RetentionPeriod	Ruft den Zeitraum ab, der verstreichen kann, bevor ein Abonnement abläuft, wenn das Abonnement nicht mit der Veröffentlichung synchronisiert wird, oder legt sie fest. (Geerbt von Publication)
SecureFtpPassword	Legt das Kennwort (als SecureString-Objekt) für die Anmeldung fest, die verwendet wird, um eine Verbindung mit dem FTP-Server für Veröffentlichungen herzustellen, die die Abonnementinitialisierung über FTP ermöglichen. (Geerbt von Publication)
SnapshotAgentExists	Ruft ab, ob der SQL Server-Agent Auftrag vorhanden ist, um die erste Momentaufnahme für diese Veröffentlichung zu generieren. (Geerbt von Publication)
SnapshotAvailable	Ruft ab, ob die Momentaufnahmedateien für diese Veröffentlichung verwendet werden können.
SnapshotGenerationAgentProcessSecurity	Ruft ein Objekt ab, das das Windows-Konto festlegt, unter dem der Momentaufnahme-Agentauftrag ausgeführt wird. (Geerbt von Publication)
SnapshotGenerationAgentPublisherSecurity	Ruft den Sicherheitskontext ab, der vom Momentaufnahme-Agent verwendet wird, um eine Verbindung mit dem Verleger herzustellen. (Geerbt von Publication)
SnapshotJobId	Ruft die Momentaufnahme-Agentauftrags-ID für die aktuelle Veröffentlichung ab. (Geerbt von Publication)
SnapshotMethod	Ruft das Datendateiformat der Anfangsmomentaufnahme ab oder legt es fest. (Geerbt von Publication)
SnapshotSchedule	Ruft ein Objekt ab, das den Zeitplan für den Momentaufnahme-Agent für die aktuelle Veröffentlichung festlegt. (Geerbt von Publication)
SqlServerName	Ruft den Namen der Microsoft SQL Server-Instanz ab, mit der dieses Objekt verbunden ist. (Geerbt von ReplicationObject)
Status	Ruft den Status der Veröffentlichung ab oder legt ihn fest. (Geerbt von Publication)
TransArticles	Stellt die Artikel in der Veröffentlichung dar.
TransSubscriptions	Stellt Abonnements für die Veröffentlichung dar.
Type	Ruft den Typ der Veröffentlichung ab oder legt diesen fest. (Geerbt von Publication)
UserData	Ruft eine Objekteigenschaft ab, die es Benutzern ermöglicht, ihre eigenen Daten an das Objekt anzufügen, oder legt sie fest. (Geerbt von ReplicationObject)

Methoden

BrowseSnapshotFolder(String, String)	Gibt den vollständigen Pfad des Speicherorts zurück, an dem Momentaufnahmedateien für ein bestimmtes Abonnement generiert wurden.
CheckValidCreation()	Überprüft, ob die Replikationserstellung gültig ist. (Geerbt von ReplicationObject)
CheckValidDefinition(Boolean)	Gibt an, ob eine Definition auf ihre Gültigkeit überprüft werden soll. (Geerbt von Publication)
CommitPropertyChanges()	Sendet alle zwischengespeicherten Eigenschaftsänderungsanweisungen an die Instanz von Microsoft SQL Server. (Geerbt von ReplicationObject)
CopySnapshot(String, String, String)	Kopiert die jüngsten Momentaufnahmedateien für ein bestimmtes Abonnement in einen Zielordner.
Create()	Erstellt die Veröffentlichung. (Geerbt von Publication)
CreateSnapshotAgent()	Erstellt den SQL Server-Agent Auftrag, der zum Generieren der ersten Momentaufnahme für die Veröffentlichung verwendet wird, sofern dieser Auftrag noch nicht vorhanden ist. (Geerbt von Publication)
Decouple()	Entkoppelt das Replikationsobjekt, auf das verwiesen wird, vom Server. (Geerbt von ReplicationObject)
EnumArticles()	Gibt die Artikel in der Veröffentlichung zurück. (Geerbt von Publication)
EnumPublicationAccesses(Boolean)	Gibt Anmeldungen zurück, die Zugriff auf den Verleger haben. (Geerbt von Publication)
EnumSubscriptions()	Gibt die Abonnements zurück, die die Veröffentlichung abonnieren. (Geerbt von Publication)
GetChangeCommand(StringBuilder, String, String)	Gibt den Änderungsbefehl von der Replikation zurück. (Geerbt von ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Gibt den Erstellungsbefehl von der Replikation zurück. (Geerbt von ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Gibt den Löschbefehl von der Replikation zurück. (Geerbt von ReplicationObject)
GrantPublicationAccess(String)	Fügt der Veröffentlichungszugriffsliste (PAL) den angegebenen Anmeldenamen hinzu. (Geerbt von Publication)
InternalRefresh(Boolean)	Initiiert eine interne Aktualisierung von der Replikation. (Geerbt von ReplicationObject)
Load()	Lädt die Eigenschaften eines vorhandenen Objekts vom Server. (Geerbt von ReplicationObject)
LoadProperties()	Lädt die Eigenschaften eines vorhandenen Objekts vom Server. (Geerbt von ReplicationObject)
MakePullSubscriptionWellKnown(String, String, SubscriptionSyncType, TransSubscriberType)	Registriert ein Pullabonnement beim Verleger.
MakePullSubscriptionWellKnown(String, String, SubscriptionSyncType, TransSubscriberType, Boolean)	Stellt eine Transaktionsveröffentlichung dar.
PostTracerToken()	Stellt ein Überwachungstoken im Verlegerprotokoll bereit, um den Prozess der Latenzzeitbestimmung zu starten.
Refresh()	Lädt die Eigenschaften des Objekts erneut. (Geerbt von ReplicationObject)
RefreshSubscriptions()	Aktualisiert alle Abonnements für eine Veröffentlichung, um neu hinzugefügte Artikel aufzunehmen.
ReinitializeAllSubscriptions()	Markiert alle Abonnements der Veröffentlichung zur erneuten Initialisierung.
ReinitializeAllSubscriptions(Boolean)	Markiert alle Abonnements der Veröffentlichung zur erneuten Initialisierung mit der Option, eine vorhandene Momentaufnahme ungültig zu machen.
Remove()	Entfernt eine vorhandene Veröffentlichung. (Geerbt von Publication)
Remove(Boolean)	Entfernt eine vorhandene Veröffentlichung auch dann, wenn nicht auf den Verteiler zugegriffen werden kann. (Geerbt von Publication)
RemovePullSubscription(String, String)	Entfernt die Registrierung für ein Pullabonnement beim Verleger.
ReplicateUserDefinedScript(String)	Repliziert die Ausführung eines benutzerdefinierten Skripts bei den Abonnenten einer angegebenen Veröffentlichung. (Geerbt von Publication)
RevokePublicationAccess(String)	Entfernt die angegebene Anmeldung aus der Veröffentlichungszugriffsliste (PAL). (Geerbt von Publication)
Script(ScriptOptions)	Generiert ein Transact-SQL-Skript, das zum erneuten Erstellen der Veröffentlichung verwendet werden kann, wie in den Skriptoptionen angegeben. (Geerbt von Publication)
SetPeerConflictDetection(Boolean, Int32)	Aktiviert oder deaktiviert die Konflikterkennung für einen Knoten in einer Peer-zu-Peer-Topologie.
StartSnapshotGenerationAgentJob()	Startet den Auftrag, der die Anfangsmomentaufnahme für die Veröffentlichung generiert. (Geerbt von Publication)
StopSnapshotGenerationAgentJob()	Versucht, einen ausgeführten Momentaufnahmeagentauftrag zu beenden. (Geerbt von Publication)
ValidatePublication(ValidationOption, ValidationMethod, Boolean)	Ruft die Inlineveröffentlichungsvalidierung für alle Abonnements auf.
ValidateSubscriptions(String[], String[], ValidationOption, ValidationMethod, Boolean)	Ruft die Inlineveröffentlichungsvalidierung für das angegebene Abonnement auf.

Weitere Informationen

• sp_article_validation (Transact-SQL))