Beispiel für ActiveX-Replikationssteuerelemente

Aktualisiert: 14. April 2006

Diese Infodatei beschreibt detailliert, wie Sie das Beispiel für ActiveX-Replikationssteuerelemente installieren und ausführen.

Szenario

Dieses Beispiel zeigt, wie Sie das SQL-Verteilungssteuerelement und das SQL-Mergesteuerelement in eine benutzerdefinierte Anwendung aufnehmen. Das Beispiel verwendet für den Verleger, den Verteiler und den Abonnenten jeweils dieselbe Instanz von Microsoft SQL Server 2005. In diesem Fall werden das SQL-Verteilungssteuerelement und das SQL-Mergesteuerelement auf dem Verteiler ausgeführt. Das Beispiel enthält zwei separate Beispielprojekte: eine Microsoft Visual C++ 6.0-Konsolenanwendung und eine formularbasierte Microsoft Visual Basic 6.0-Anwendung. Jedes Projekt demonstriert sowohl das SQL-Verteilungssteuerelement als auch das SQL-Mergesteuerelement. Das Beispiel zeigt außerdem, wie mithilfe der Rückruffunktionalität der Steuerelemente der Synchronisierungsstatus überwacht werden kann. Mit der Visual Basic 6.0-Anwendung können Sie außerdem Abonnementeigenschaften ändern.

Hinweis:
Verwenden Sie für Anwendungen mit verwaltetem Code die Klassen TransSynchronizationAgent und MergeSynchronizationAgent im Microsoft.SqlServer.Replication-Namespace. Weitere Informationen finden Sie unter Planning for Replication Programming.

Sprachen

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

Voraussetzungen

Stellen Sie vor dem Ausführen dieses Beispiels sicher, dass die folgende Software installiert ist:

• SQL Server 2005, einschließlich der folgenden optional installierten Komponenten:
  • Datenbankdienste (einschließlich Replikation).
  • Komponenten zur Clientkonnektivität.
  • Software Development Kit (SDK).
  • Die OLTP-Beispieldatenbank AdventureWorks. Diese Beispieldatenbank ist im Lieferumfang von SQL Server 2005 enthalten und auch im SQL Server Developer Center verfügbar.
  • Die Beispiele zu SQL Server 2005. Diese Beispiele sind in SQL Server 2005 enthalten und außerdem im SQL Server Developer Center verfügbar. Weitere Informationen finden Sie unter Installieren von Beispielen.
  • Visual Studio 6.0, Visual Basic 6.0 oder Visual C++ 6.0.

  Hinweis:
  Dieses Beispiel wird nicht auf 64-Bit-Plattformen (IA64) unterstützt.

Erforderliche Berechtigungen

Das Beispiel für ActiveX-Replikationssteuerelemente verwendet die Windows-Authentifizierung. Die zum Konfigurieren und Ausführen des Beispiels erforderlichen Berechtigungen basieren auf Replikationssicherheitsanforderungen und lauten wie folgt:

• Zum Ausführen von InstallReplicationControlSample.bat, wobei eine Arbeitsfreigabe für die Replikation erstellt, die Replikation konfiguriert, die Publikationen erstellt und die Anfangssnapshots generiert werden, muss das Windows-Konto ein Mitglied der festen Serverrolle sysadmin sein.
• Zum Starten des SQL-Verteilungssteuerelements oder des SQL-Mergesteuerelements für die Synchronisierung der Beispielabonnements muss das Windows-Konto ein Mitglied der festen Datenbankrolle db_owner in den Verteilungs- und Abonnementdatenbanken sein.

Erstellen und Konfigurieren des Beispiels

Gehen Sie wie folgt vor, um das Beispielprojekt zu erstellen und die Replikationstopologie zu konfigurieren:

• Führen Sie das Skript für die Replikationsinstallation aus.
• Erstellen Sie die Visual Basic- oder Visual C++ -Version des Beispiels mit Visual Studio 6.0, Visual Basic 6.0 oder Visual C++ 6.0.

So konfigurieren Sie das Beispiel für Replikationssteuerelemente

1. Stellen Sie sicher, dass die AdventureWorks-Beispieldatenbank installiert und die Datenbank angefügt wurde. Falls die Datenbank nicht angefügt ist, finden Sie weitere Informationen unter Installieren der Beispieldatenbanken und Beispiele für AdventureWorks in der SQL Server-Onlinedokumentation.

2. Stellen Sie sicher, dass die neueste Version der SQL Server-Datenbankmodul-Beispiele installiert wurde. Weitere Informationen finden Sie unter Downloaden und Aktualisieren der Onlinedokumentation in der SQL Server-Onlinedokumentation.

3. Stellen Sie sicher, dass der SQL Server-Agent ausgeführt wird. Den Status dieses Dienstes können Sie im Objekt-Explorer in SQL Server Management Studio anzeigen. Von dort aus können Sie diesen Dienst auch starten.

4. Navigieren Sie zum Installationsverzeichnis der Skripts für das Beispiel für ActiveX-Replikationssteuerelemente. Standardmäßig ist dies C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\Scripts.

5. Führen Sie InstallReplicationControlSample.bat aus, und geben Sie, wenn Sie dazu aufgefordert werden, den Anmeldenamen (mit Unterscheidung nach Groß-/Kleinschreibung im Format "DOMÄNE\Anmeldename") und das Kennwort für das Windows-Konto ein, unter dem der Snapshot-Agentauftrag ausgeführt wird. Damit wird das Dienstprogramm sqlcmd.exe zur Ausführung von CreateReplicationControlPublications.sql aufgerufen, welches Folgendes durchführt:

   • Überprüft, ob die Replikation auf dem lokalen Server konfiguriert wurde. Falls dies nicht der Fall ist, wird die Replikation als Verleger mit lokalem Verteiler konfiguriert, der die Verteilungsdatenbank verwendet.
   • Löscht die Beispielpublikationen und erstellt sie neu.
   • Fügt den Publikationen Artikel hinzu.
   • Startet die Snapshot-Agentaufträge zum Generieren der Anfangssnapshots für die Publikationen.
   • Erstellt und registriert Abonnements für die Publikationen.

So erstellen Sie das Beispiel für ActiveX-Replikationssteuerelemente mithilfe von Visual C++ 6.0

1. Öffnen Sie Visual C++ 6.0. Klicken Sie im Hauptmenü auf Datei, klicken Sie auf Arbeitsbereich öffnen, navigieren Sie zum Speicherort der C++-Projektdateien (standardmäßig ist dies das Verzeichnis C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6), und öffnen Sie dann distsamp.dsw.

2. Klicken Sie auf der Registerkarte für Verzeichnisse in der Dropdownliste Verzeichnisse anzeigen für auf Bibliotheksdateien, und fügen sie dann den Pfad C:\Programme\Microsoft SQL Server\90\COM hinzu. Diese Pfadangabe setzt voraus, dass SQL Server 2005 im Standardverzeichnis installiert wurde.

3. Klicken Sie im Menü Erstellen auf die Option zum Erstellen von distsamp.exe. Die erstellte Datei distsamp.exe wird, abhängig von der Buildkonfiguration, standardmäßig in C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Debug oder C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Release gespeichert.

4. Wiederholen Sie die Schritte 1 bis 3, um die Datei mergsamp.exe zu erstellen.

So erstellen Sie das Beispiel für ActiveX-Replikationssteuerelemente mithilfe von Visual Basic 6.0

1. Starten Sie Visual Basic 6.0. Klicken Sie im Hauptmenü auf Datei, klicken Sie auf Projekt öffnen, navigieren Sie zum Verzeichnis C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6, und öffnen Sie dann replsamp.vbp.

2. Klicken Sie im Menü Projekt auf Verweise, und stellen Sie dann sicher, dass unter Verfügbare Verweise die folgenden Verweise aktiviert sind:

   • Microsoft SQL Server-Verteilungssteuerelement 9.0
   • Microsoft SQL Server-Mergesteuerelement 9.0
   • Microsoft SQL-Replikationsfehler 9.0

3. Klicken Sie im Menü Datei auf Make ReplSamp.exe. Die erstellte Datei ReplSamp.exe wird standardmäßig in C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6 gespeichert.

Ausführen des Beispiels

Zum Verwenden des Beispiels müssen Sie zum Speicherort der erstellten ausführbaren Dateien navigieren und diese ausführen.

So führen Sie die Visual C++ 6.0-Version des Beispiels für ActiveX-Replikationssteuerelemente aus

1. Navigieren Sie zum Speicherort der erstellten Visual C++ 6.0-Version des Beispiels für ActiveX-Replikationssteuerelemente. Dies ist standardmäßig C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Debug.

2. Führen Sie distsamp.exe aus, um den Verteilungs-Agent zum Synchronisieren des Pullabonnements für die Transaktionspublikation zu starten, und führen Sie mergsamp.exe aus, um das Pullabonnement mit der Mergepublikation zu synchronisieren.

So führen Sie die Visual Basic 6.0-Version des Beispiels für ActiveX-Replikationssteuerelemente aus

1. Navigieren Sie zum Speicherort der erstellten Visual Basic 6.0-Version des Beispiels für ActiveX-Replikationssteuerelemente. Dies ist standardmäßig C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6.

2. Führen Sie ReplSamp.exe aus.

3. Wählen Sie auf dem Formular für das Beispiel für ActiveX-Replikationssteuerelemente die Option für die Transaktionsreplikation**** oder für das Zusammenführen aus der Dropdownliste Publikationstyp aus, und klicken Sie auf die Option zum Abrufen der Abonnementeigenschaften. Dadurch werden die Eigenschaften des ausgewählten Abonnements geladen.

4. (Optional) Mit dieser Anwendung können auch beliebige andere Pullabonnements auf dem lokalen Computer synchronisiert werden. Klicken Sie auf Bearbeiten, um die Abonnementeigenschaften zu ändern, und klicken Sie danach auf Aktualisieren.

5. Klicken Sie auf Synchronisieren, um das Abonnement zu synchronisieren.

6. (Optional) Um von einem der Standardabonnements eine Schnellsynchronisation auszuführen, klicken Sie im Menü Synchronisieren auf die Option für die Transaktionsreplikation oder auf die Option für das Zusammenführen****.

Entfernen des Beispiels

Mithilfe des folgenden Verfahrens können Sie das Beispiel für ActiveX-Replikationssteuerelemente entfernen.

So entfernen Sie das Beispiel für ActiveX-Replikationssteuerelemente

1. Navigieren Sie zum Installationsverzeichnis der Skripts für das Beispiel für ActiveX-Replikationssteuerelemente. Dies ist standardmäßig C:\Programme\Microsoft SQL Server\90\Samples\Replication\ActiveX\Scripts.

2. Führen Sie die Batchdatei RemoveReplicationControlSample.bat aus.

3. Wenn Sie dazu aufgefordert werden, geben Sie "Y" ein, und drücken Sie die Eingabetaste, um alle Replikationsobjekte auf dem Verleger sowie in der Abonnementdatenbank zu entfernen und die Veröffentlichung und Verteilung auf dem Verleger zu deinstallieren.

   Wichtig:

   Dieses Skript entfernt die gesamte Replikationsinfrastruktur. Wenn Sie andere Publikationen erstellt haben, die diesen Verleger oder Verteiler verwenden, dürfen Sie RemoveReplicationControlSample.bat nicht ausführen. Entfernen Sie in diesem Fall die Beispielpublikationen manuell. Weitere Informationen finden Sie unter Vorgehensweise: Löschen einer Publikation (SQL Server Management Studio) oder How to: Delete a Publication (Replication Transact-SQL Programming) in der SQL Server-Onlinedokumentation.

4. Führen Sie für die AdventureWorksLocal-Datenbank den Befehl sp_removedbreplication aus.

5. Stellen Sie den Datenbankkontext auf die master-Datenbank um, und führen Sie DROP DATABASE AdventureWorksLocal aus.

Kommentar

Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für den Einsatz in einer Produktionsumgebung gedacht und wurden auch nicht in einer Produktionsumgebung getestet. Microsoft leistet keinen technischen Support für diese Beispiele. Beispielanwendungen und Assemblys sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder verwendet werden. Microsoft bietet für diese Beispiele keinen technischen Support. Beispielanwendungen und Assemblys sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Produktionsdatenbank oder dem Berichtsserver verbunden sein oder verwendet werden.

Siehe auch

Konzepte

Replikationsbeispiele

Andere Ressourcen

Planning for Replication Programming
Replikationsentwickler (InfoCenter)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf