Esempio controlli ActiveX per le repliche

Data aggiornamento: 14 aprile 2006

Questo file Leggimi illustra come installare ed eseguire l'esempio dei controlli ActiveX per le repliche.

Scenario

Questo esempio illustra come includere i controlli distribuzione SQL e merge SQL in un'applicazione personalizzata utilizzando un'istanza singola di Microsoft SQL Server 2005 per il server di pubblicazione, il server di distribuzione e il sottoscrittore. In questo caso, il controllo distribuzione SQL e il controllo merge SQL vengono eseguiti sul server di distribuzione. L'esempio contiene due progetti di esempio separati: un'applicazione console Microsoft Visual C++ 6.0 e un'applicazione Microsoft Visual Basic 6.0 basata su form. Ogni progetto illustra sia il controllo distribuzione SQL che il controllo merge SQL. L'esempio dimostra inoltre come utilizzare la funzionalità di callback dei controlli per monitorare lo stato di sincronizzazione. L'applicazione Visual Basic 6.0 consente di modificare le proprietà di sottoscrizione.

[!NOTA] Per un'applicazione con codice gestito, utilizzare le classi TransSynchronizationAgent e MergeSynchronizationAgent nello spazio dei nomi Microsoft.SqlServer.Replication. Per ulteriori informazioni, vedere Planning for Replication Programming.

Linguaggi

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

Prerequisiti

Prima di eseguire questo esempio, verificare che siano installati i prodotti software seguenti:

• SQL Server 2005, inclusi facoltativamente i componenti seguenti:

  • Servizi di database (inclusa la replica).
  • Componenti di connettività client.
  • Software Development Kit (SDK).
  • Database OLTP di esempio AdventureWorks, incluso in SQL Server 2005 e disponibile nel Centro per sviluppatori di Microsoft SQL Server.
  • Gli esempi di SQL Server 2005, inclusi in SQL Server 2005 e disponibili nel Centro per sviluppatori di SQL Server. Per ulteriori informazioni, vedere Installazione degli esempi.
  • Visual Studio 6.0, Visual Basic 6.0 o Visual C++ 6.0.

  [!NOTA] Questo esempio non è supportato in piattaforme a 64 bit (IA64).

Autorizzazioni necessarie

L'esempio controlli ActiveX per le repliche utilizza l'autenticazione di Windows. Le autorizzazioni necessarie per configurare ed eseguire l'esempio si basano sui requisiti di protezione della replica e sono le seguenti:

• Per eseguire InstallReplicationControlSample.bat, che crea una condivisione di lavoro per la replica, configura la replica, crea le pubblicazioni e genera gli snapshot iniziali, l'account di Windows deve essere membro del ruolo predefinito del server sysadmin.
• Per avviare il controllo distribuzione SQL o merge SQL per la sincronizzazione delle sottoscrizioni dell'esempio, l'account di Windows deve essere membro del ruolo predefinito del server db_owner nei database di distribuzione e sottoscrizione.

Generazione e configurazione dell'esempio

Per generare il progetto di esempio e configurare la topologia di replica, eseguire le operazioni seguenti:

• Eseguire lo script di installazione della replica.
• Creare la versione Visual Basic o Visual C++ dell'esempio tramite Visual Studio 6.0, Visual Basic 6.0 o Visual C++ 6.0.

Per configurare l'esempio dei controlli per le repliche

1. Verificare che il database di esempio AdventureWorks sia installato e collegato. Se il database non è collegato, vedere Installazione dei database di esempio AdventureWorks e degli esempi nella documentazione in linea di SQL Server.

2. Verificare che sia installata la versione più recente degli esempi di Motore di database di SQL Server. Per ulteriori informazioni, vedere Download e aggiornamento della documentazione in linea nella documentazione in linea di SQL Server.

3. Verificare che SQL Server Agent sia in esecuzione. È possibile avviare il servizio o visualizzarne lo stato in Esplora oggetti in SQL Server Management Studio.

4. Passare alla cartella di installazione degli script dell'esempio dei controlli ActiveX per le repliche. Il percorso predefinito è C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\Scripts.

5. Eseguire InstallReplicationControlSample.bat e quando richiesto immettere l'account di accesso (nel formato "DOMAIN\login", rispettando maiuscole e minuscole) e la password per l'account di Windows con cui verrà eseguito il processo dell'agente snapshot. In questo modo viene chiamato sqlcmd.exe che esegue CreateReplicationControlPublications.sql che a sua volta esegue le operazioni seguenti:

   • Controlla che sul server locale sia configurata la replica. Se non è configurata, esegue una configurazione come server di pubblicazione con server di distribuzione locale utilizzando il database di distribuzione.
   • Elimina e ricrea le pubblicazioni di esempio.
   • Aggiunge articoli alle pubblicazioni.
   • Avvia i processi dell'agente snapshot per la generazione degli snapshot iniziali per le pubblicazioni.
   • Crea e registra le sottoscrizioni alle pubblicazioni.

Per generare l'esempio dei controlli ActiveX per le repliche tramite Visual C++ 6.0

1. Aprire Visual C++ 6.0. Scegliere Open Workspace dal menu File, passare al percorso in cui si trovano i file di progetto C++ e aprire distsamp.dsw. Il percorso predefinito è C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6.

2. Nella scheda Directories scegliere Library files dalla casella di riepilogo a discesa Show directories for e quindi aggiungere il percorso C:\Programmi\Microsoft SQL Server\90\COM. Questo precorso presuppone che SQL Server 2005 sia stato installato nella directory predefinita.

3. Scegliere Genera distsamp.exe dal menu Build. Il percorso predefinito del file distsamp.exe risultante è C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Debug o C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Release, in base alla configurazione di generazione.

4. Ripetere i passaggi da 1 a 3 per generare mergsamp.exe.

Per generare l'esempio dei controlli ActiveX per le repliche tramite Visual Basic 6.0

1. Avviare Visual Basic 6.0. Scegliere Apri progetto dal menu File, passare alla directory C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6 e quindi aprire replsamp.vbp.

2. Scegliere Riferimenti dal menu Progetto e quindi in Riferimenti disponibili verificare che siano abilitati i riferimenti seguenti:

   • Controllo distribuzione Microsoft SQL Server 9.0
   • Controllo merge Microsoft SQL Server 9.0
   • Microsoft SQL Replication Errors 9.0

3. Scegliere Crea ReplSamp.exe dal menu File. Il percorso predefinito del file ReplSamp.exe risultante è C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6.

Esecuzione dell'esempio

Per utilizzare l'esempio, è necessario passare al percorso dei file eseguibili generati ed eseguire i file.

Per eseguire la versione Visual C++ 6.0 dell'esempio dei controlli ActiveX per le repliche

1. Passare al percorso di generazione della versione Visual C++ 6.0 dell'esempio dei controlli ActiveX per le repliche. Il percorso predefinito è C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\CPP6\Debug.

2. Eseguire distsamp.exe per avviare l'agente di distribuzione per la sincronizzazione della sottoscrizione pull alla pubblicazione transazionale ed eseguire mergsamp.exe per la sincronizzazione alla sottoscrizione pull alla pubblicazione di tipo merge.

Per eseguire la versione Visual Basic 6.0 dell'esempio dei controlli ActiveX per le repliche

1. Passare al percorso di generazione della versione Visual Basic 6.0 dell'esempio dei controlli ActiveX per le repliche. Il percorso predefinito è C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\VB6.

2. Eseguire ReplSamp.exe.

3. Nel form Replication Controls ActiveX Sample selezionare Transazionale o Merge dalla casella di riepilogo a discesa Tipo di pubblicazione e fare clic su Ottieni proprietà sottoscrizione. Verranno caricate le proprietà della sottoscrizione selezionata.

4. (Facoltativo) Questa applicazione può essere utilizzata per sincronizzare le sottoscrizioni pull presenti nel computer locale. Fare clic su Modifica per modificare le proprietà della sottoscrizione e quindi su Aggiorna al termine.

5. Fare clic su Sincronizza per sincronizzare la sottoscrizione.

6. (Facoltativo) Per eseguire una sincronizzazione rapida di una delle sottoscrizioni predefinite, scegliere Transazionale o Merge dal menu Sincronizza.

Rimozione dell'esempio

Eseguire la procedura seguente per rimuovere l'esempio dei controlli ActiveX per le repliche.

Per rimuovere l'esempio dei controlli per le repliche

1. Passare alla cartella di installazione degli script dell'esempio dei controlli ActiveX per le repliche. Il percorso predefinito è C:\Programmi\Microsoft SQL Server\90\Samples\Replication\ActiveX\Scripts.

2. Eseguire il file batch RemoveReplicationControlSample.bat.

3. Quando richiesto, digitare "Y" e premere INVIO per rimuovere tutti gli oggetti di replica sul server di pubblicazione, rimuovere tutti gli oggetti di replica nel database di sottoscrizione e disinstallare la pubblicazione e la distribuzione sul server di pubblicazione.

   Importante:

   Questo script rimuove tutta l'infrastruttura di replica. Se sono state create altre pubblicazioni che utilizzano questo server di pubblicazione o server di distribuzione, non eseguire RemoveReplicationControlSample.bat, ma rimuovere le pubblicazioni di esempio manualmente. Per ulteriori informazioni, vedere Procedura: Eliminazione di una pubblicazione (SQL Server Management Studio) o How to: Delete a Publication (Replication Transact-SQL Programming) nella documentazione in linea di SQL Server.

4. Eseguire sp_removedbreplication nel database AdventureWorksLocal.

5. Modificare il contesto del database sul database master ed eseguire DROP DATABASE AdventureWorksLocal.

Commenti

Gli esempi vengono forniti esclusivamente a scopo didattico. Non sono destinati all'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non rende disponibile il supporto tecnico per questi esempi. Le applicazioni e gli assembly di esempio non devono essere connessi o utilizzati con il database di SQL Server o il server di report in un ambiente di produzione senza l'autorizzazione dell'amministratore di sistema. Microsoft non fornisce servizi di supporto tecnico per questi esempi. Le applicazioni e gli assembly di esempio non devono essere connessi o utilizzati con il database di SQL Server o il server di report in un ambiente di produzione senza l'autorizzazione dell'amministratore di sistema.

Vedere anche

Concetti

Esempi di replica

Altre risorse

Planning for Replication Programming
Centro informazioni per gli sviluppatori di soluzioni di replica

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche