Exemple des contrôles ActiveX de réplication

Mis à jour : 14 avril 2006

Ce fichier Lisez-moi explique en détail comment installer et exécuter l'exemple des contrôles ActiveX pour la réplication.

Scénario (Scenario)

Cet exemple illustre l'insertion des contrôles de distribution SQL et de fusion SQL dans une application personnalisée. Il utilise une instance unique de Microsoft SQL Server 2005 pour le serveur de publication, le serveur de distribution et l'Abonné. Dans ce cas, le contrôle de distribution SQL et le contrôle de fusion SQL s'exécutent au niveau du serveur de distribution. Cet exemple contient deux exemples de projets distincts : une application console Microsoft Visual C++  6.0 et une application Microsoft Visual Basic 6.0 basée sur les formulaires. Chaque projet met en évidence le contrôle de distribution SQL et le contrôle de fusion SQL. L'exemple montre également l'utilisation de la fonctionnalité de rappel des contrôles qui permet de suivre l'état de la synchronisation. Par ailleurs, l'application Visual Basic 6.0 vous permet de modifier les propriétés de l'abonnement.

Remarque :
Pour une application de code managé, utilisez les classes TransSynchronizationAgent et MergeSynchronizationAgent dans l'espace de noms Microsoft.SqlServer.Replication. Pour plus d'informations, consultez Planning for Replication Programming.

Langages

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

Configuration préalable

Avant d'exécuter cet exemple, assurez-vous que les logiciels suivants sont installés sur votre ordinateur :

• SQL Server 2005, notamment les composants suivants (dont l'installation est facultative) :
  • Database Services (y compris la réplication).
  • Composants de connectivité client.
  • Kit de développement logiciel (SDK).
  • Exemple de base de données OLTP AdventureWorks. Cette base de données exemple incluse dans SQL Server 2005 est également disponible sur la page Web du SQL Server Developer Center. (Centre des développeurs SQL Server).
  • Exemples du SQL Server 2005. Ces exemples sont intégrés à SQL Server 2005 et sont également disponibles sur la page Web du SQL Server Developer Center (Centre des développeurs SQL Server). Pour plus d'informations, consultez Installation des exemples.
  • Visual Studio 6.0, Visual Basic 6.0 ou Visual C++  6.0.

  Remarque :
  Cet exemple n'est pas pris en charge sur les plateformes 64 bits (IA64).

Autorisations requises

L'exemple des contrôles ActiveX de réplication utilise l'authentification Windows. Les autorisations nécessaires pour configurer et exécuter cet exemple sont basées sur les exigences de la sécurité de la réplication :

• Pour exécuter InstallReplicationControlSample.bat, qui crée un partage du travail de réplication, configure la réplication, crée des publications et génère la capture instantanée initiale, votre compte Windows doit être membre du rôle serveur fixe sysadmin.
• Pour démarrer le contrôle de distribution SQL ou le contrôle de fusion SQL afin de synchroniser les exemples d'abonnements, votre compte Windows doit être membre du rôle de base de données fixe db_owner dans les bases de données de distribution et d'abonnement.

Génération et configuration de l'exemple

Pour générer l'exemple de projet et configurer la topologie de la réplication, procédez de la façon suivante :

• Exécutez le script d'installation de la réplication.
• Générez la version Visual Basic ou Visual C++ de l'exemple à l'aide de Visual Studio 6.0, Visual Basic 6.0 ou Visual C++  6.0.

Pour configurer l'exemple des contrôles de réplication

1. Vérifiez que la base de données exemple AdventureWorks a été installée et qu'elle est attachée. Si cette base de données n'est pas attachée, consultez Installation des exemples de bases de données AdventureWorks et des autres exemples dans la documentation en ligne de SQL Server.

2. Vérifiez que la version la plus récente des exemples du moteur de base de données SQL Server 2005 est installée. Pour plus d'informations, consultez Téléchargement et mise à jour de la documentation en ligne dans la documentation en ligne de SQL Server.

3. Vérifiez que l'Agent SQL Server s'exécute. Vous pouvez afficher l'état de ce service et le démarrer à partir de l'Explorateur d'objets dans SQL Server Management Studio.

4. Accédez à l'emplacement de l'installation des scripts de l'exemple des contrôles ActiveX de réplication. Cet emplacement est par défaut C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\Scripts.

5. Exécutez InstallReplicationControlSample.bat et, lorsque vous êtes invité à le faire, entrez le nom d'utilisateur (sous la forme « DOMAINE\nom » en respectant la casse) et le mot de passe du compte Windows sous lequel le travail de l'Agent de capture instantanée s'exécute. L'utilitaire sqlcmd.exe est alors appelé pour exécuter CreateReplicationControlPublications.sql qui effectue les actions suivantes :

   • Il vérifie que la réplication a été configurée sur le serveur local et, dans la négative, il le configure comme serveur de publication avec un serveur de distribution local utilisant la base de données de distribution.
   • Il supprime et recrée les exemples de publication.
   • Il ajoute des articles aux publications.
   • Il démarre les travaux de l'Agent de capture instantanée pour générer les captures instantanées initiales pour les publications.
   • Il crée les abonnements et les inscrit aux publications.

Pour générer l'exemple des contrôles ActiveX de réplication à l'aide de Visual C++ 6.0

1. Ouvrez Visual C++  6.0. Dans le menu principal, cliquez sur Fichier, puis sur Ouvrir un espace de travail, accédez à l'emplacement des fichiers du projet C++ (par défaut, le répertoire C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6), puis ouvrez distsamp.dsw.

2. Affichez l'onglet Répertoires, dans la liste déroulante Afficher les répertoires pour, cliquez sur Fichiers bibliothèques, puis ajoutez le chemin d'accès C:\Program Files\Microsoft SQL Server\90\COM. Ce chemin implique l'installation de SQL Server 2005 dans le répertoire par défaut.

3. Dans le menu Générer, cliquez sur Générer distsamp.exe. L'emplacement par défaut de l'exécutable distsamp.exe alors créé est C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Debug ou C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Release, selon la configuration de génération.

4. Répétez les étapes 1 à 3 pour générer mergsamp.exe.

Pour générer l'exemple des contrôles ActiveX de réplication à l'aide de Visual Basic 6.0

1. Démarrez Visual Basic 6.0. Dans le menu principal, cliquez sur Fichier, puis sur Ouvrir, accédez à l'emplacement du répertoire C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6), puis ouvrez replsamp.vbp.

2. Dans le menu Projet, cliquez sur Références puis, sous Références disponibles, vérifiez l'activation des références suivantes :

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

3. Dans le menu Fichier, cliquez sur Créer ReplSamp.exe. L'emplacement par défaut de l'exécutable ReplSamp.exe alors créé est C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6.

Exécution de l'exemple

Pour utiliser l'exemple, vous devez accéder à l'emplacement des fichiers exécutables que vous avez générés et les exécuter.

Pour exécuter la version Visual C++ 6.0 de l'exemple des contrôles ActiveX de réplication

1. Accédez à l'emplacement de génération de la version Visual C++  6.0 de l'exemple des contrôles ActiveX de réplication. L'emplacement par défaut est C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Debug.

2. Exécutez distsamp.exe pour démarrer l'Agent de distribution et synchroniser l'abonnement par extraction de données avec la publication transactionnelle, puis exécutez mergsamp.exe pour synchroniser l'abonnement par extraction de données avec la publication de fusion.

Pour exécuter la version Visual Basic 6.0 de l'exemple des contrôles ActiveX de réplication

1. Accédez à l'emplacement de génération de la version Visual Basic 6.0 de l'exemple des contrôles ActiveX de réplication. L'emplacement par défaut est C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6.

2. Exécutez ReplSamp.exe.

3. Dans le formulaire Replication Controls ActiveX Sample, repérez la liste déroulante Types de publication, sélectionnez Transactionnel ou De fusion et cliquez sur Obtenir les propriétés de l'abonnement. Les propriétés de l'abonnement sélectionné sont ainsi chargées.

4. (Facultatif) Cette application peut être utilisée pour synchroniser tout autre abonnement par extraction de données sur la machine locale. Cliquez sur Modifier pour changer les propriétés de l'abonnement, puis sur Mettre à jour lorsque vous avez terminé.

5. Cliquez sur Synchroniser pour synchroniser l'abonnement.

6. (Facultatif) Pour exécuter une synchronisation rapide de l'un des abonnements par défaut, dans le menu Synchroniser, cliquez sur Transactionnel ou De fusion.

Suppression de l'exemple

Utilisez la procédure suivante pour supprimer l'exemple des contrôles ActiveX de réplication.

Pour supprimer l'exemple des contrôles ActiveX de réplication

1. Accédez à l'emplacement d'installation des scripts de l'exemple des contrôles ActiveX de réplication. L'emplacement par défaut est C:\Program Files\Microsoft SQL Server\90\Samples\Replication\ActiveX\Scripts.

2. Exécutez le fichier de commandes RemoveReplicationControlSample.bat.

3. Confirmez la suppression en tapant « Y » et en appuyant sur Entrée pour supprimer tous les objets de réplication sur le serveur de publication et dans la base de données d'abonnement, et désinstaller la publication et la distribution sur le serveur de publication.

   Important :

   Ce script supprime toute infrastructure de réplication. Si vous avez créé d'autres publications qui utilisent le serveur de distribution ou le serveur de publication, n'exécutez pas le fichier de commandes RemoveReplicationControlSample.bat. Supprimez les exemples de publication manuellement. Pour plus d'informations, consultez Procédure : supprimer une publication (SQL Server Management Studio) ou How to: Delete a Publication (Replication Transact-SQL Programming)dans la documentation en ligne de SQL Server.

4. Dans la base de données AdventureWorksLocal, exécutez sp_removedbreplication.

5. Changez le contexte de base de données en spécifiant la base de données master et exécutez DROP DATABASE AdventureWorksLocal.

Commentaires

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système. Microsoft n'assure pas de support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Voir aussi

Concepts

Exemples de réplication

Autres ressources

Planning for Replication Programming
Infocentre destiné aux développeurs de réplication

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
14 avril 2006	Nouveau contenu : Ajout d'une remarque indiquant que cet exemple n'est pas pris en charge sur les plateformes 64 bits (IA64).