Compartir a través de


TransSubscription Clase

Definición

Representa una suscripción de inserción a una publicación transaccional o de instantáneas.

public ref class TransSubscription sealed : Microsoft::SqlServer::Replication::Subscription
public sealed class TransSubscription : Microsoft.SqlServer.Replication.Subscription
type TransSubscription = class
    inherit Subscription
Public NotInheritable Class TransSubscription
Inherits Subscription
Herencia

Ejemplos

           // Define the Publisher, publication, and databases.
           string publicationName = "AdvWorksProductTran";
           string publisherName = publisherInstance;
           string subscriberName = subscriberInstance;
           string subscriptionDbName = "AdventureWorks2012Replica";
           string publicationDbName = "AdventureWorks2012";

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

           // Create the objects that we need.
           TransPublication publication;
           TransSubscription subscription;

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

               // Ensure that the publication exists and that 
               // it supports push subscriptions.
               publication = new TransPublication();
               publication.Name = publicationName;
               publication.DatabaseName = publicationDbName;
               publication.ConnectionContext = conn;

               if (publication.IsExistingObject)
               {
                   if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
                   {
                       publication.Attributes |= PublicationAttributes.AllowPush;
                   }

                   // Define the push subscription.
                   subscription = new TransSubscription();
                   subscription.ConnectionContext = conn;
                   subscription.SubscriberName = subscriberName;
                   subscription.PublicationName = publicationName;
                   subscription.DatabaseName = publicationDbName;
                   subscription.SubscriptionDBName = subscriptionDbName;

                   // Specify the Windows login credentials for the Distribution Agent job.
                   subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
                   subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

                   // By default, subscriptions to transactional publications are synchronized 
                   // continuously, but in this case we only want to synchronize on demand.
                   subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand;

                   // Create the push subscription.
                   subscription.Create();
               }
               else
               {
                   // Do something here if the publication does not exist.
                   throw new ApplicationException(String.Format(
                       "The publication '{0}' does not exist on {1}.",
                       publicationName, publisherName));
               }
           }
           catch (Exception ex)
           {
               // Implement the appropriate error handling here.
               throw new ApplicationException(String.Format(
                   "The subscription to {0} could not be created.", publicationName), ex);
           }
           finally
           {
               conn.Disconnect();
           }
' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

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

' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransSubscription

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

    ' Ensure that the publication exists and that 
    ' it supports push subscriptions.
    publication = New TransPublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = conn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPush
        End If

        ' Define the push subscription.
        subscription = New TransSubscription()
        subscription.ConnectionContext = conn
        subscription.SubscriberName = subscriberName
        subscription.PublicationName = publicationName
        subscription.DatabaseName = publicationDbName
        subscription.SubscriptionDBName = subscriptionDbName

        ' Specify the Windows login credentials for the Distribution Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' By default, subscriptions to transactional publications are synchronized 
        ' continuously, but in this case we only want to synchronize on demand.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand

        ' Create the push subscription.
        subscription.Create()
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If

Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

Comentarios

Al configurar un publicador con un distribuidor remoto, los valores proporcionados para todos los parámetros, incluidos SynchronizationAgentProcessSecurity, se envían al distribuidor como texto sin formato. Debe cifrar la conexión entre el publicador y su distribuidor remoto antes de llamar al método Create . Para obtener más información, vea sp_reinitsubscription (Transact-SQL).

Cuando la suscripción pertenece a un publicador que no es de SQL Server, la ConnectionContext propiedad se establece en el distribuidor en lugar de en Publisher, la DatabaseName propiedad se establece en la base de datos de distribución en lugar de en la base de datos de publicación y la PublisherName propiedad se establece en el nombre del publicador que no es de SQL Server.

Seguridad para subprocesos

Los miembros estáticos públicos (Shared en Microsoft Visual Basic) de este tipo son seguros para las operaciones multiproceso. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Constructores

TransSubscription()

Crea una nueva instancia de la clase TransSubscription.

TransSubscription(String, String, String, String, ServerConnection)

Crea una nueva instancia de la TransSubscription clase con la publicación, base de datos, suscriptor y base de datos de suscriptor especificada, y con la conexión especificada a la instancia de Microsoft SQL Server.

Propiedades

AgentJobId

Obtiene el identificador del trabajo del agente utilizado para sincronizar la suscripción.

(Heredado de Subscription)
AgentOffload

Obtiene o establece si el agente de sincronización se ejecuta en un equipo distinto del equipo donde se creó el trabajo de agente. Esta propiedad ya no es compatible con distribuidores que ejecutan Microsoft SQL Server 2005 y versiones posteriores.

(Heredado de Subscription)
AgentOffloadServer

Obtiene o establece el nombre del equipo remoto donde se ejecuta el agente cuando se usa la activación remota del agente.

(Heredado de Subscription)
AgentSchedule

Obtiene el trabajo del agente utilizado para sincronizar la suscripción.

(Heredado de Subscription)
BackupInformation

Obtiene o establece la información necesaria para inicializar una suscripción desde una copia de seguridad.

CachePropertyChanges

Obtiene o establece si los cambios realizados en las propiedades de replicación se almacenan en memoria caché o se aplican inmediatamente.

(Heredado de ReplicationObject)
ConnectionContext

Obtiene o establece la conexión a una instancia de Microsoft SQL Server.

(Heredado de ReplicationObject)
CreateSyncAgentByDefault

Obtiene o establece si de forma predeterminada se crea el trabajo de agente utilizado para sincronizar la suscripción.

(Heredado de Subscription)
DatabaseName

Obtiene o establece el nombre de la base de datos de publicación.

(Heredado de Subscription)
DtsPackageLocation

Obtiene o establece la ubicación del paquete de Servicios de transformación de datos (DTS) de Microsoft SQL Server 2000.

DtsPackageName

Obtiene o establece el nombre del paquete de Servicios de transformación de datos (DTS) de Microsoft SQL Server 2000 que se aplica en el suscriptor.

DtsPackagePassword

Establece la contraseña usada para ejecutar el paquete de Servicios de transformación de datos (DTS) de Microsoft SQL Server 2000.

EnabledForSynchronizationManager

Especifica si la suscripción se puede sincronizar mediante el Administrador de sincronización de Microsoft Windows.

(Heredado de Subscription)
FullSubscription

Obtiene un valor que indica si la suscripción está completa.

IsExistingObject

Obtiene si el objeto existe en el servidor.

(Heredado de ReplicationObject)
LoopBackDetection

Obtiene o establece si el agente de distribución envía o no las transacciones originadas en el suscriptor al mismo suscriptor.

MemoryOptimized

Representa una suscripción de inserción a una publicación transaccional o de instantáneas.

Name

Obtiene el nombre asignado a una suscripción existente.

(Heredado de Subscription)
PublicationName

Obtiene o establece el nombre de la publicación a la que se realiza la suscripción.

(Heredado de Subscription)
PublisherName

Obtiene o establece el nombre del publicador cuando la suscripción pertenece a un publicador que no es de SQL Server.

SecureDtsPackagePassword

Establece la contraseña (como un SecureString objeto) que se usa para ejecutar el paquete de Servicios de transformación de datos (DTS) de Microsoft SQL Server 2000.

SqlServerName

Obtiene el nombre de la instancia de Microsoft SQL Server a la que está conectado este objeto.

(Heredado de ReplicationObject)
Status

Obtiene el estado de la suscripción.

(Heredado de Subscription)
SubscriberCatalog

Obtiene o establece el catálogo utilizado al realizar una conexión con el proveedor OLE DB para un suscriptor que no sea SQL Server.

SubscriberDatasource

Nombre del origen de datos tal y como entiende el proveedor OLE DB para un suscriptor que no sea SQL Server.

SubscriberDatasourceType

Identifica el tipo de origen de datos que es un suscriptor que no es SQL Server.

SubscriberLocation

Ubicación de la base de datos tal y como entiende el proveedor OLE DB para el suscriptor que no es de SQL Server.

SubscriberName

Obtiene o establece el nombre de la instancia de Microsoft SQL Server que es el suscriptor.

(Heredado de Subscription)
SubscriberProvider

Identificador de programación único (PROGID) con el que está registrado el proveedor OLE DB para el suscriptor que no es SQL Server

SubscriberProviderString

La cadena de conexión específica del proveedor OLE DB se usa para conectarse al origen de datos para suscriptores que no son de SQL Server.

SubscriberSecurity

Obtiene el contexto de seguridad que usa para la conexión al suscriptor.

(Heredado de Subscription)
SubscriberType

Obtiene o establece el comportamiento de actualización de los cambios en los datos en el suscriptor.

SubscriptionDBName

Obtiene o establece el nombre de la base de datos del suscriptor que recibe los datos replicados.

(Heredado de Subscription)
SubscriptionLSN

Obtiene o establece el número de secuencia de registro de la suscripción.

SubscriptionType

Obtiene si el registro de la suscripción es para una suscripción de inserción o de extracción.

(Heredado de Subscription)
SynchronizationAgent

Obtiene una instancia de la clase TransSynchronizationAgent que puede utilizarse para sincronizar la suscripción.

SynchronizationAgentName

Obtiene o establece el nombre del trabajo de agente creado para sincronizar la suscripción.

(Heredado de Subscription)
SynchronizationAgentProcessSecurity

Obtiene el contexto de seguridad que se usa para especificar la cuenta de Microsoft Windows con la que se ejecuta el trabajo del agente de sincronización para sincronizar la suscripción.

(Heredado de Subscription)
SyncType

Obtiene o establece la manera en la que se inicializa la suscripción.

(Heredado de Subscription)
UserData

Obtiene o establece una propiedad de un objeto que permite a los usuarios adjuntar sus propios datos al objeto.

(Heredado de ReplicationObject)

Métodos

CheckValidCreation()

Comprueba la creación de replicación válida.

(Heredado de ReplicationObject)
CheckValidDefinition(Boolean)

Indica si la definición de suscripción es válida.

(Heredado de Subscription)
CommitPropertyChanges()

Envía todas las instrucciones de cambio de propiedad almacenadas en caché a la instancia de Microsoft SQL Server.

(Heredado de ReplicationObject)
Create()

Crea el registro de la suscripción en el publicador.

(Heredado de Subscription)
Decouple()

Desacopla del servidor el objeto de replicación al que se hace referencia.

(Heredado de ReplicationObject)
DoUpdateMemoryOptimizedProperty(String)

Representa una suscripción de inserción a una publicación transaccional o de instantáneas.

GetChangeCommand(StringBuilder, String, String)

Devuelve el comando de cambio de la replicación.

(Heredado de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Devuelve el comando de creación de la replicación.

(Heredado de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Devuelve el comando drop de la replicación.

(Heredado de ReplicationObject)
InternalRefresh(Boolean)

Inicia una actualización interna de la replicación.

(Heredado de ReplicationObject)
Load()

Carga las propiedades de un objeto existente desde el servidor.

(Heredado de ReplicationObject)
LoadProperties()

Carga las propiedades de un objeto existente desde el servidor.

(Heredado de ReplicationObject)
Refresh()

Vuelve a cargar las propiedades del objeto.

(Heredado de ReplicationObject)
Reinitialize()

Marca la suscripción para reinicializarla la próxima vez que se ejecute el Agente de distribución para sincronizar la suscripción.

Reinitialize(Boolean)

Reinicializa la suscripción.

Remove()

Elimina el registro de la suscripción en el publicador y quita los objetos de replicación del suscriptor para una suscripción de inserción.

(Heredado de Subscription)
Script(ScriptOptions)

Devuelve un script de Transact-SQL que se puede usar para crear o eliminar la suscripción.

(Heredado de Subscription)
StopSynchronizationJob()

Intenta detener un trabajo del Agente de distribución en ejecución que está sincronizando la suscripción actualmente.

SynchronizeWithJob()

Inicia el trabajo del agente para sincronizar la suscripción.

Se aplica a

Consulte también