TransPublication Classe

Définition

Espace de noms:

Microsoft.SqlServer.Replication

Assembly:

Microsoft.SqlServer.Rmo.dll

Représente une publication transactionnelle.

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

Héritage

Object

ReplicationObject

Publication

TransPublication

Exemples

Cet exemple crée une publication transactionnelle.

// 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

Cet exemple supprime une publication transactionnelle.

// 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

Remarques

Cohérence de thread

Tous les membres statiques publics (Shared dans Microsoft Visual Basic) de ce type sont sécurisés pour les opérations multithread. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Constructeurs

TransPublication()	Crée une instance de la classe TransPublication.
TransPublication(String, String, ServerConnection)	Crée une nouvelle instance de la classe TransPublication avec les propriétés nécessaires.
TransPublication(String, String, ServerConnection, Boolean)	Crée une nouvelle instance de la classe TransPublication avec les propriétés nécessaires et indique si le travail de l'Agent d'instantané pour la publication est créé.

Propriétés

AltSnapshotFolder	Obtient ou définit l'autre emplacement de fichier d'instantanés pour une publication. (Hérité de Publication)
Attributes	Obtient ou définit les attributs de publication. (Hérité de Publication)
CachePropertyChanges	Obtient ou définit s'il faut mettre en cache des modifications effectuées sur les propriétés de réplication ou les appliquer immédiatement. (Hérité de ReplicationObject)
CompatibilityLevel	Obtient ou définit la version la plus ancienne de Microsoft SQL Server s’exécutant sur les Abonnés que la publication référencée peut prendre en charge. (Hérité de Publication)
ConflictPolicy	Obtient ou définit la stratégie de conflit pour les publications qui prennent en charge des abonnements de mise à jour.
ConflictRetention	Obtient ou définit le nombre de jours pendant lequel les lignes de données de conflit sont conservées dans les tables de conflit. (Hérité de Publication)
ConnectionContext	Obtient ou définit la connexion à une instance de Microsoft SQL Server. (Hérité de ReplicationObject)
ContinueOnConflict	Détermine si l'Agent de distribution continue à traiter les modifications lorsqu'un conflit est détecté.
CreateSnapshotAgentByDefault	Obtient ou définit si le travail de l'Agent d'instantané est ajouté automatiquement lorsque la publication est créée. (Hérité de Publication)
DatabaseName	Obtient ou définit le nom de la base de données de publication. (Hérité de Publication)
Description	Obtient ou définit une description textuelle de la publication. (Hérité de Publication)
FtpAddress	Obtient ou définit l'adresse du serveur FTP (File Transfer Protocol) pour les publications qui autorisent l'initialisation de l'abonnement sur le FTP. (Hérité de Publication)
FtpLogin	Obtient ou définit la connexion utilisée pour se connecter au serveur FTP (File Transfer Protocol) pour les publications qui autorisent l'initialisation de l'abonnement sur le FTP. (Hérité de Publication)
FtpPassword	Définit le mot de passe pour la connexion utilisée pour se connecter au serveur FTP (File Transfer Protocol) pour les publications qui autorisent l'initialisation de l'abonnement sur le FTP. (Hérité de Publication)
FtpPort	Obtient ou définit le port du serveur FTP (File Transfer Protocol) pour les publications qui autorisent l'initialisation de l'abonnement sur le FTP. (Hérité de Publication)
FtpSubdirectory	Obtient ou définit le sous-répertoire du serveur FTP (File Transfer Protocol) pour les publications qui autorisent l'initialisation de l'abonnement sur le FTP. (Hérité de Publication)
HasSubscription	Détermine si la publication possède un ou plusieurs abonnements. (Hérité de Publication)
IsExistingObject	Détermine si l'objet existe ou non sur le serveur. (Hérité de ReplicationObject)
Name	Obtient ou définit le nom de la publication. (Hérité de Publication)
PeerConflictDetectionEnabled	Détermine si la détection de conflit d'égal à égal a été activée à l'aide de la méthode SetPeerConflictDetection(Boolean, Int32).
PeerOriginatorID	Obtient l'ID d'un nœud dans une topologie d'égal à égal ; cet ID est utilisé pour la détection de conflit si la propriété PeerConflictDetectionEnabled a la valeur true.
PostSnapshotScript	Obtient ou définit le nom et le chemin d’accès complet d’un fichier de script Transact-SQL exécuté après l’application de l’instantané initial à l’Abonné. (Hérité de Publication)
PreSnapshotScript	Obtient ou définit le nom et le chemin complet d’un fichier de script Transact-SQL exécuté avant l’application de l’instantané initial à l’Abonné. (Hérité de Publication)
PubId	Obtient la valeur qui identifie de façon unique la publication. (Hérité de Publication)
PublisherName	Obtient ou définit le nom du serveur de publication non-SQL Server.
QueueType	Obtient ou définit le type de file d'attente à utiliser pour les publications qui autorisent les abonnements de mise à jour en attente.
ReplicateDdl	Obtient ou définit les options de la réplication DDL (Data Definition Language) qui déterminent si les modifications DDL sont répliquées. (Hérité de Publication)
RetentionPeriod	Obtient ou définit la durée avant l'expiration d'un abonnement lorsqu'il n'est pas synchronisé avec la publication. (Hérité de Publication)
SecureFtpPassword	Définit le mot de passe (sous forme d'objet SecureString) pour la connexion utilisée pour se connecter au serveur FTP (File Transfer Protocol) pour les publications qui autorisent l'initialisation de l'abonnement via FTP. (Hérité de Publication)
SnapshotAgentExists	Obtient si le travail SQL Server Agent existe pour générer l’instantané initial pour cette publication. (Hérité de Publication)
SnapshotAvailable	Détermine si les fichiers d'instantanés pour cette publication sont disponibles.
SnapshotGenerationAgentProcessSecurity	Obtient un objet qui définit le compte Windows sous lequel est exécuté le travail de l'Agent d'instantané. (Hérité de Publication)
SnapshotGenerationAgentPublisherSecurity	Obtient le contexte de sécurité utilisé par l'Agent d'instantané pour se connecter au serveur de publication. (Hérité de Publication)
SnapshotJobId	Obtient l'ID de travail de l'Agent d'instantané pour la publication actuelle. (Hérité de Publication)
SnapshotMethod	Obtient ou définit le format de fichier de données de l'instantané initial. (Hérité de Publication)
SnapshotSchedule	Obtient un objet qui définit la planification pour l'Agent d'instantané pour la publication actuelle. (Hérité de Publication)
SqlServerName	Obtient le nom de l’instance Microsoft SQL Server à laquelle cet objet est connecté. (Hérité de ReplicationObject)
Status	Obtient ou définit l'état de la publication. (Hérité de Publication)
TransArticles	Représente les articles dans la publication.
TransSubscriptions	Représente des abonnements à la publication.
Type	Obtient ou définit le type de la publication. (Hérité de Publication)
UserData	Obtient ou définit une propriété d'objet qui permet aux utilisateurs d'attacher leurs propres données à l'objet. (Hérité de ReplicationObject)

Méthodes

BrowseSnapshotFolder(String, String)	Retourne le chemin d'accès complet de l'emplacement où les fichiers d'instantanés ont été générés pour un abonnement spécifique.
CheckValidCreation()	Vérifie la création de la réplication valide. (Hérité de ReplicationObject)
CheckValidDefinition(Boolean)	Indique s'il faut vérifier la définition non valide. (Hérité de Publication)
CommitPropertyChanges()	Envoie toutes les instructions de modification de propriété mises en cache à l’instance de Microsoft SQL Server. (Hérité de ReplicationObject)
CopySnapshot(String, String, String)	Copie les fichiers d'instantanés les plus récents pour un abonnement spécifique dans un dossier de destination.
Create()	Crée la publication. (Hérité de Publication)
CreateSnapshotAgent()	Crée le travail SQL Server Agent utilisé pour générer l’instantané initial de la publication, si ce travail n’existe pas déjà. (Hérité de Publication)
Decouple()	Dissocie l'objet de réplication référencé du serveur. (Hérité de ReplicationObject)
EnumArticles()	Retourne les articles dans la publication. (Hérité de Publication)
EnumPublicationAccesses(Boolean)	Retourne des connexions qui ont accès au serveur de publication. (Hérité de Publication)
EnumSubscriptions()	Retourne les abonnements qui s'abonnent à la publication. (Hérité de Publication)
GetChangeCommand(StringBuilder, String, String)	Retourne la commande de modification de la réplication. (Hérité de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Retourne la commande de création de la réplication. (Hérité de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Retourne la commande de suppression de la réplication. (Hérité de ReplicationObject)
GrantPublicationAccess(String)	Ajoute la connexion spécifiée à la liste d'accès à la publication (PAL). (Hérité de Publication)
InternalRefresh(Boolean)	Initialise une actualisation interne de la réplication. (Hérité de ReplicationObject)
Load()	Charge les propriétés d'un objet existant à partir du serveur. (Hérité de ReplicationObject)
LoadProperties()	Charge les propriétés d'un objet existant à partir du serveur. (Hérité de ReplicationObject)
MakePullSubscriptionWellKnown(String, String, SubscriptionSyncType, TransSubscriberType)	Inscrit un abonnement par extraction sur le serveur de publication.
MakePullSubscriptionWellKnown(String, String, SubscriptionSyncType, TransSubscriberType, Boolean)	Représente une publication transactionnelle.
PostTracerToken()	Publie un jeton de suivi dans le journal du serveur de publication pour démarrer le processus de détermination de la latence.
Refresh()	Recharge les propriétés de l'objet. (Hérité de ReplicationObject)
RefreshSubscriptions()	Met à jour tous les abonnements à une publication pour inclure tous les articles nouvellement ajoutés.
ReinitializeAllSubscriptions()	Signale tous les abonnements à la publication pour la réinitialisation.
ReinitializeAllSubscriptions(Boolean)	Signale tous les abonnements à la publication pour la réinitialisation, avec la possibilité d'invalider un instantané existant.
Remove()	Supprime une publication existante. (Hérité de Publication)
Remove(Boolean)	Supprime une publication existante même s'il n'est pas possible d'accéder au serveur de distribution. (Hérité de Publication)
RemovePullSubscription(String, String)	Supprime l'inscription pour un abonnement par extraction sur le serveur de publication.
ReplicateUserDefinedScript(String)	Réplique l'exécution d'un script défini par l'utilisateur sur les Abonnés d'une publication spécifiée. (Hérité de Publication)
RevokePublicationAccess(String)	Supprime la connexion spécifiée de la liste d'accès à la publication (PAL). (Hérité de Publication)
Script(ScriptOptions)	Génère un script Transact-SQL qui peut être utilisé pour recréer la publication comme spécifié par les options de script. (Hérité de Publication)
SetPeerConflictDetection(Boolean, Int32)	Active ou désactive la détection de conflit pour un nœud dans une topologie d'égal à égal.
StartSnapshotGenerationAgentJob()	Démarre le travail qui génère l'instantanée initial pour la publication. (Hérité de Publication)
StopSnapshotGenerationAgentJob()	Tente d'arrêter un travail de l'Agent d'instantané en cours d'exécution. (Hérité de Publication)
ValidatePublication(ValidationOption, ValidationMethod, Boolean)	Appelle la validation de publication incluse pour tous les abonnements.
ValidateSubscriptions(String[], String[], ValidationOption, ValidationMethod, Boolean)	Appelle la validation de publication incluse pour l'abonnement spécifié.

Voir aussi

• sp_article_validation (Transact-SQL))