Compartir a través de

Replication ActiveX Controls (ejemplo)

  • Artículo

Actualizado: 14 de abril de 2006

Este archivo Léame incluye detalles sobre cómo instalar y ejecutar el ejemplo Replication ActiveX Controls.

Escenario

Este ejemplo muestra cómo incluir los controles de distribución SQL y mezcla SQL en una aplicación personalizada. En él se usa una instancia única de Microsoft SQL Server 2005 para el publicador, el distribuidor y el suscriptor. En este caso, el control de distribución SQL y el control de mezcla SQL se ejecutan en el distribuidor. El ejemplo contiene dos proyectos de ejemplo independientes: una aplicación de consola de Microsoft Visual C++ 6.0 y una aplicación basada en formularios de Microsoft Visual Basic 6.0. Cada proyecto muestra ambos controles. El ejemplo también muestra cómo usar la funcionalidad de devolución de llamada de los controles para supervisar el estado de sincronización. La aplicación de Visual Basic 6.0 también permite cambiar las propiedades de suscripción.

[!NOTA] En una aplicación de código administrado, use las clases TransSynchronizationAgent y MergeSynchronizationAgent del espacio de nombres Microsoft.SqlServer.Replication. Para obtener más información, vea Planning for Replication Programming.

Lenguajes

  • Microsoft Visual Basic 6.0
  • Microsoft Visual C++ 6.0
  • Transact-SQL

Requisitos previos

Antes de ejecutar este ejemplo, asegúrese de que esté instalado el siguiente software:

  • SQL Server 2005, incluidos los siguientes componentes instalados opcionalmente:

    • Servicios de bases de datos (incluso réplica).
    • Componentes de conectividad de clientes.
    • Kit de desarrollo de software (SDK).
    • Base de datos OLTP de ejemplo AdventureWorks. Esta base de datos de ejemplo está incluida en SQL Server 2005 y también está disponible en el Centro para programadores de SQL Server.
    • Los ejemplos del SQL Server 2005. Estos ejemplos están incluidos en SQL Server 2005 y también están disponibles en el Centro para programadores de SQL Server. Para obtener más información, vea Instalar ejemplos.
    • Visual Studio 6.0, Visual Basic 6.0 o Visual C++ 6.0.

    [!NOTA] Este ejemplo no es compatible con plataformas de 64 bits (IA64).

Permisos necesarios

En el ejemplo Replication ActiveX Controls se usa la autenticación de Windows. Los permisos necesarios para configurar y ejecutar el ejemplo se basan en las necesidades de seguridad de réplica y son los siguientes:

  • Para ejecutar InstallReplicationControlSample.bat, que crea un recurso compartido de trabajo de réplica, configura la réplica, crea las publicaciones y genera las instantáneas iniciales, la cuenta de Windows debe ser miembro de la función fija de servidor sysadmin.
  • Para iniciar el control de distribución SQL o el control de mezcla SQL con el fin de sincronizar las suscripciones de ejemplo, la cuenta de Windows debe ser miembro de la función fija de base de datos db_owner en las bases de datos de distribución y suscripción.

Generar y configurar el ejemplo

Para generar el proyecto de ejemplo y configurar la topología de réplica, haga lo siguiente:

  • Ejecute la secuencia de comandos de instalación de réplica.
  • Genere la versión de Visual Basic o Visual C++ del ejemplo mediante Visual Studio 6.0, Visual Basic 6.0 o Visual C++ 6.0.

Para configurar el ejemplo Replication ActiveX Controls

  1. Asegúrese de que la base de datos de ejemplo AdventureWorks se haya instalado y que esté adjunta. Si la base de datos no está adjunta, vea Instalar ejemplos y bases de datos de ejemplo AdventureWorks en los Libros en pantalla de SQL Server.

  2. Compruebe que se ha instalado la versión más reciente de los ejemplos de SQL Server Database Engine (Motor de base de datos de SQL Server). Para obtener más información, vea Descargar y actualizar los Libros en pantalla en los Libros en pantalla de SQL Server.

  3. Asegúrese de que el Agente SQL Server se esté ejecutando. Puede ver el estado de este servicio e iniciarlo desde el Explorador de objetos en SQL Server Management Studio.

  4. Vaya a la ubicación de instalación de las secuencias de comandos del ejemplo Replication ActiveX Controls. La ubicación predeterminada es C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\Scripts.

  5. Ejecute InstallReplicationControlSample.bat y, cuando se le solicite, escriba los datos de inicio de sesión (en el formato con distinción de mayúsculas y minúsculas "DOMINIO\inicioDeSesión") y la contraseña de la cuenta de Windows en la que se ejecutará el trabajo del Agente de instantáneas. De este modo se llama a sqlcmd.exe para que ejecute CreateReplicationControlPublications.sql, que hace lo siguiente:

    • Comprueba que la réplica esté configurada en el servidor local y, si no lo está, la configura como un publicador con distribuidor local que usa la base de datos de distribución.
    • Quita y vuelve a crear las publicaciones de ejemplo.
    • Agrega artículos a las publicaciones.
    • Inicia los trabajos del Agente de instantáneas para generar las instantáneas iniciales de las publicaciones.
    • Crea y registra las suscripciones de las publicaciones.

Para generar el ejemplo Replication ActiveX Controls con Visual C++ 6.0

  1. Abra Visual C++ 6.0. En el menú principal, haga clic en Archivo, haga clic en Abrir área de trabajo, vaya a la ubicación de los archivos del proyecto C++ (de forma predeterminada, C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6) y abra el archivo distsamp.dsw.

  2. En la ficha Directorios, en la lista desplegable Mostrar directorios para, haga clic en Archivos de biblioteca y, después, agregue la ruta de acceso C:\Archivos de programa\Microsoft SQL Server\90\COM. En esta ruta se da por supuesto que SQL Server 2005 se instaló en el directorio predeterminado.

  3. En el menú Generar, haga clic en Generar distsamp.exe. La ubicación predeterminada del archivo distsamp.exe resultante es C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Debug o C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Release, según la configuración de la generación.

  4. Repita los pasos 1 a 3 para generar mergsamp.exe.

Para generar el ejemplo Replication ActiveX Controls con Visual Basic 6.0

  1. Inicie Visual Basic 6.0. En el menú principal, haga clic en Archivo, haga clic en Abrir proyecto, vaya al directorio C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6 y, a continuación, abra replsamp.vbp.

  2. En el menú Proyecto, haga clic en Referencias y compruebe que las referencias siguientes están habilitadas en Referencias disponibles:

    • Microsoft SQL Distribution Control 9.0
    • Microsoft SQL Merge Control 9.0
    • Microsoft SQL Replication Errors 9.0

  3. En el menú Archivo, haga clic en Generar ReplSamp.exe. La ubicación predeterminada del archivo ReplSamp.exe resultante es C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6.

Ejecutar el ejemplo

Para usar el ejemplo, debe ir a la ubicación de los archivos ejecutables generados y ejecutarlos.

Para ejecutar la versión Visual C++ 6.0 del ejemplo Replication ActiveX Controls

  1. Vaya a la ubicación de generación de la versión Visual C++ 6.0 del ejemplo Replication ActiveX Controls. La ubicación predeterminada es C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Debug.

  2. Ejecute el archivo distsamp.exe para iniciar el Agente de distribución con el fin de sincronizar la suscripción de extracción para la publicación transaccional y ejecute mergsamp.exe para sincronizar la suscripción de extracción para la publicación de mezcla.

Para ejecutar la versión Visual Basic 6.0 del ejemplo Replication ActiveX Controls

  1. Vaya a la ubicación de generación de la versión Visual Basic 6.0 del ejemplo Replication ActiveX Controls. La ubicación predeterminada es C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6.

  2. Ejecute el archivo ReplSamp.exe.

  3. En el formulario Replication Controls ActiveX Sample, en la lista desplegable Tipo de publicación, seleccione Transaccional o Mezcla y haga clic en Obtener propiedades de suscripción. De este modo se cargan las propiedades de la suscripción seleccionada.

  4. (Opcional) Esta aplicación se puede usar para sincronizar cualquier otra suscripción de extracción en el equipo local. Haga clic en Editar para cambiar las propiedades de suscripción y, después, haga clic en Actualizar cuando termine.

  5. Haga clic en Sincronizar para sincronizar la suscripción.

  6. (Opcional) Para ejecutar una sincronización rápida de una de las suscripciones predeterminadas, en el menú Sincronizar haga clic en Transaccional o en Mezcla.

Quitar el ejemplo

Use el siguiente procedimiento para quitar el ejemplo Replication ActiveX Controls.

Para quitar el ejemplo Replication ActiveX Controls

  1. Vaya a la ubicación de instalación de las secuencias de comandos del ejemplo Replication ActiveX Controls. La ubicación predeterminada es C:\Archivos de programa\Microsoft SQL Server\90\Samples\Replication\ActiveX\Scripts.

  2. Ejecute el archivo por lotes RemoveReplicationControlSample.bat.

  3. Cuando se le solicite, escriba "Y" y presione ENTRAR para quitar todos los objetos de réplica del publicador, quitar todos los objetos de réplica de la base de datos de suscripciones y desinstalar la publicación y distribución del publicador.

    ms345272.note(es-es,SQL.90).gifImportante:
    Esta secuencia de comandos quita toda la infraestructura de réplica. Si ha creado otras publicaciones que usen este publicador o distribuidor, no ejecute el archivo RemoveReplicationControlSample.bat. En su lugar, debe quitar las publicaciones de ejemplo manualmente. Para obtener más información, vea Cómo eliminar una publicación (SQL Server Management Studio) o How to: Delete a Publication (Replication Transact-SQL Programming) en los Libros en pantalla de SQL Server.

  4. En la base de datos AdventureWorksLocal, ejecute sp_removedbreplication.

  5. Cambie el contexto de la base de datos por la base de datos master y ejecute DROP DATABASE AdventureWorksLocal.

Comentarios

Los ejemplos se proporcionan exclusivamente con fines formativos. No se han diseñado para utilizarse en un entorno de producción y no se han probado en ningún entorno de este tipo. Microsoft no ofrece soporte técnico para estos ejemplos. Las aplicaciones y los ensamblados de ejemplo no se deben conectar ni usar con la base de datos de SQL Server de producción ni con el servidor de informes sin el permiso del administrador del sistema. Microsoft no ofrece soporte técnico para estos ejemplos. Las aplicaciones y los ensamblados de ejemplo no se deben conectar ni usar con la base de datos de SQL Server de producción ni con el servidor de informes sin el permiso del administrador del sistema.

Vea también

Conceptos

Ejemplos de réplica

Otros recursos

Planning for Replication Programming
Centro de información del programador de réplica

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

14 de abril de 2006
Contenido nuevo:
  • Se agregó una nota que indica que este ejemplo no es compatible con plataformas de 64 bits (IA64).