Creazione di una pubblicazione

In questo argomento viene descritto come creare una pubblicazione in SQL Server 2012 tramite SQL Server Management Studio, Transact-SQL o RMO (Replication Management Objects).

Contenuto dell'argomento

• Prima di iniziare:

  Limitazioni e restrizioni

  Sicurezza

• Per creare una pubblicazione e definire articoli, utilizzando:

  SQL Server Management Studio

  Transact-SQL

  Oggetti RMO (Replication Management Objects)

Prima di iniziare

Limitazioni e restrizioni

• I nomi di pubblicazioni e articoli non possono includere i caratteri seguenti: % , * , [ , ] , | , : , " , ? , ' , \ , / , < , >. Se gli oggetti del database includono uno di questi caratteri e si desidera replicarli, è necessario specificare un nome di articolo diverso dal nome oggetto nella finestra di dialogo Proprietà articolo - <Articolo>, accessibile dalla pagina Articoli della procedura guidata.

Sicurezza

Se possibile, richiedere agli utenti di immettere le credenziali di sicurezza in fase di esecuzione. Se è necessario archiviare le credenziali, utilizzare i servizi di crittografia offerti da Microsoft Windows .NET Framework.

[Top]

Utilizzo di SQL Server Management Studio

Creare le pubblicazioni e definire gli articoli utilizzando la Creazione guidata nuova pubblicazione. Dopo aver creato una pubblicazione, visualizzare e modificare le proprietà della stessa nella finestra di dialogo Proprietà pubblicazione - <Publication>. Per informazioni sulla creazione di una pubblicazione da un database Oracle, vedere Creazione di una pubblicazione da un database Oracle.

Per creare una pubblicazione e definire articoli

1. Connettersi al server di pubblicazione in Microsoft SQL Server Management Studio e quindi espandere il nodo del server.

2. Espandere la cartella Replica e quindi fare clic con il pulsante destro del mouse sulla cartella Pubblicazioni locali.

3. Fare clic su Nuova pubblicazione.

4. Eseguire i vari passaggi della Creazione guidata nuova pubblicazione per:

   • Specificare un server di distribuzione se la distribuzione non è stata configurata sul server. Per ulteriori informazioni sulla configurazione della distribuzione, vedere Configurazione della pubblicazione e della distribuzione.

     Se nella pagina Server di distribuzione si specifica che il server di pubblicazione deve agire come server di distribuzione per se stesso (server di distribuzione locale) e il server non è configurato come server di distribuzione, la Creazione guidata nuova pubblicazione eseguirà la configurazione del server. Nella pagina Cartella snapshot è necessario specificare una cartella snapshot predefinita per il server di distribuzione. La cartella snapshot è semplicemente una directory designata come condivisione. Gli agenti che eseguono letture e scritture in questa cartella devono disporre di autorizzazioni sufficienti per accedervi. Per ulteriori informazioni sulle impostazioni di protezione appropriate per la cartella, vedere Sicurezza della cartella snapshot.

     Se si specifica che un altro server deve agire come server di distribuzione, è necessario immettere una password nella pagina Password amministrativa per le connessioni effettuate dal server di pubblicazione a quello di distribuzione. Questa password deve corrispondere a quella specificata quando il server di pubblicazione è stato abilitato nel server di distribuzione remoto.

     Per ulteriori informazioni, vedere Configurazione della distribuzione.

   • Scegliere un database di pubblicazione.

   • Selezionare un tipo di pubblicazione. Per ulteriori informazioni, vedere Tipi di replica.

   • Specificare i dati e gli oggetti di database da pubblicare; facoltativamente, filtrare le colonne dagli articoli di tabelle e impostare le proprietà degli articoli.

   • Facoltativamente, filtrate le righe dagli articoli di tabelle. Per ulteriori informazioni, vedere Filtro dei dati pubblicati.

   • Impostare la pianificazione dell'agente snapshot.

   • Specificare le credenziali con cui gli agenti di replica seguenti vengono eseguiti e stabiliscono le connessioni:

     - Agente snapshot per tutte le pubblicazioni.

     - Agente di lettura log per tutte le pubblicazioni transazionali.

     - Agente di lettura coda per le pubblicazioni transazionali che consentono le sottoscrizioni aggiornabili.

     Per ulteriori informazioni, vedere Modello di sicurezza dell'agente di replica e Procedure consigliate per la sicurezza della replica.

   • Facoltativamente, creare lo script della pubblicazione. Per ulteriori informazioni, vedere Creazione di script di replica.

   • Specificare un nome per la pubblicazione.

[Top]

Utilizzo di Transact-SQL

È possibile creare pubblicazioni a livello di programmazione tramite le stored procedure di replica. Le stored procedure utilizzate dipenderanno dal tipo di pubblicazione creato.

Per creare una pubblicazione snapshot o transazionale

1. Nel database di pubblicazione del server di pubblicazione eseguire sp_replicationdboption (Transact-SQL) per abilitare la pubblicazione del database corrente utilizzando la replica snapshot o transazionale.

2. Per una pubblicazione transazionale, determinare se esiste un processo dell'agente di lettura log per il database di pubblicazione. Questo passaggio non è necessario per le pubblicazioni snapshot.

   • Se per il database di pubblicazione esiste un processo dell'agente di lettura log, procedere con il passaggio 3.

   • Per sapere se un processo dell'agente di lettura log esiste per un database pubblicato, eseguire sp_helplogreader_agent (Transact-SQL) nel database di pubblicazione del server di pubblicazione.

   • Se il set di risultati è vuoto, creare un processo dell'agente di lettura log. Nel server di pubblicazione eseguire sp_addlogreader_agent (Transact-SQL). Specificare le credenziali di Microsoft Windows utilizzate per l'esecuzione dell'agente per @job_name e @job_password. Se l'agente utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le informazioni sull'account di accesso di Microsoft SQL Server per @publisher_login e @publisher_password. Procedere al passaggio 3.

3. Nel server di pubblicazione eseguire sp_addpublication (Transact-SQL). Specificare il nome della pubblicazione per @publication e per il parametro @repl_freq specificare il valore snapshot per una pubblicazione snapshot o il valore continuous per una pubblicazione transazionale. Specificare eventuali altre opzioni della pubblicazione. In questo modo viene definita la pubblicazione.

   [!NOTA]

   I nomi delle pubblicazioni non possono includere i caratteri seguenti:

   % * [ ] | : " ? \ / < >

4. Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione utilizzato al passaggio 3 per @publication e le credenziali di Windows utilizzate per l'agente snapshot per snapshot_job_name e @password. Se l'agente utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le informazioni sull'account di accesso di SQL Server per @publisher_login e @publisher_password. Verrà creato un processo dell'agente snapshot per la pubblicazione.

   Nota sulla sicurezza

   Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori specificati per tutti i parametri, inclusi job_login e job_password, vengono inviati al server di distribuzione come testo normale. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di eseguire questa stored procedure. Per ulteriori informazioni, vedere Abilitazione di connessioni crittografate al Motore di database (Gestione configurazione SQL Server).

5. Aggiungere articoli alla pubblicazione. Per ulteriori informazioni, vedere Definizione di un articolo.

6. Avviare il processo dell'agente snapshot per generare lo snapshot iniziale per la pubblicazione. Per ulteriori informazioni, vedere Creazione e applicazione dello snapshot iniziale.

Per creare una pubblicazione di tipo merge

1. Nel database di pubblicazione sp_replicationdboption (Transact-SQL) per abilitare la pubblicazione del database corrente utilizzando la replica di tipo merge.

2. Nel database di pubblicazione del server di pubblicazione eseguire sp_addmergepublication (Transact-SQL). Specificare il nome della pubblicazione per @publication e eventuali altre opzioni della pubblicazione. In questo modo viene definita la pubblicazione.

   [!NOTA]

   I nomi delle pubblicazioni non possono includere i caratteri seguenti:

   % * [ ] | : " ? \ / < >

3. Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione utilizzato al passaggio 2 per @publication e le credenziali di Windows utilizzate per l'agente snapshot per snapshot_job_name e @password. Se l'agente utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione, è inoltre necessario specificare il valore 0 per @publisher_security_mode e le informazioni sull'account di accesso di SQL Server per @publisher_login e @publisher_password. Verrà creato un processo dell'agente snapshot per la pubblicazione.

   Nota sulla sicurezza

   Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori specificati per tutti i parametri, inclusi job_login e job_password, vengono inviati al server di distribuzione come testo normale. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di eseguire questa stored procedure. Per ulteriori informazioni, vedere Abilitazione di connessioni crittografate al Motore di database (Gestione configurazione SQL Server).

4. Aggiungere articoli alla pubblicazione. Per ulteriori informazioni, vedere Definizione di un articolo.

5. Avviare il processo dell'agente snapshot per generare lo snapshot iniziale per la pubblicazione. Per ulteriori informazioni, vedere Creazione e applicazione dello snapshot iniziale.

Esempio (Transact-SQL)

In questo esempio viene creata una pubblicazione transazionale. Per passare le credenziali di Windows necessarie per la creazione di processi per l'agente snapshot e per l'agente di lettura log, vengono utilizzate variabili di scripting.

-- To avoid storing the login and password in the script file, the values 
-- are passed into SQLCMD as scripting variables. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks'; 
SET @publication = N'AdvWorksProductTran'; 
-- Windows account used to run the Log Reader and Snapshot Agents.
SET @login = $(Login); 
-- This should be passed at runtime.
SET @password = $(Password); 

-- Enable transactional or snapshot replication on the publication database.
EXEC sp_replicationdboption 
    @dbname=@publicationDB, 
    @optname=N'publish',
    @value = N'true';

-- Execute sp_addlogreader_agent to create the agent job. 
EXEC sp_addlogreader_agent 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;

-- Create a new transactional publication with the required properties. 
EXEC sp_addpublication 
    @publication = @publication, 
    @status = N'active',
    @allow_push = N'true',
    @allow_pull = N'true',
    @independent_agent = N'true';

-- Create a new snapshot job for the publication, using a default schedule.
EXEC sp_addpublication_snapshot 
    @publication = @publication, 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;
GO

In questo esempio viene creata una pubblicazione di tipo merge. Per passare le credenziali di Windows necessarie per la creazione del processo per l'agente snapshot, vengono utilizzate variabili di scripting.

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

--Declarations for adding a merge publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2012'; 
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @login = $(Login);
SET @password = $(Password);

-- Enable merge replication on the publication database, using defaults.
USE master
EXEC sp_replicationdboption 
  @dbname=@publicationDB, 
  @optname=N'merge publish',
  @value = N'true' 

-- Create a new merge publication, explicitly setting the defaults. 
USE [AdventureWorks2012]
EXEC sp_addmergepublication 
-- These parameters are optional.
  @publication = @publication,
  -- optional parameters 
  @description = N'Merge publication of AdventureWorks2012.',
  @publication_compatibility_level  = N'110RTM';

-- Create a new snapshot job for the publication.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = @login, 
  @job_password = @password;
GO

[Top]

Utilizzo di RMO (Replication Management Objects)

È possibile creare pubblicazioni a livello di programmazione tramite gli oggetti RMO (Replication Management Objects). Le classi RMO utilizzate per creare una pubblicazione dipendono dal tipo di pubblicazione creata.

Per creare una pubblicazione snapshot o transazionale

1. Creare una connessione al server di pubblicazione tramite la classe ServerConnection.

2. Creare un'istanza della classe ReplicationDatabase per il database di pubblicazione, impostare la proprietà ConnectionContext sull'istanza di ServerConnection del passaggio 1, quindi chiamare il metodo LoadProperties. Se LoadProperties restituisce false, verificare che il database esista.

3. Se la proprietà EnabledTransPublishing è impostata su false, impostarla su true.

4. Per una pubblicazione transazionale, verificare il valore della proprietà LogReaderAgentExists. Se questa proprietà è impostata su true, per il database esiste già un processo dell'agente di lettura log. Se questa proprietà è impostata su false, eseguire le operazioni seguenti:

   • Impostare i campi Login e Password o SecurePassword di LogReaderAgentProcessSecurity in modo da fornire le credenziali dell'account Microsoft Windows utilizzato per l'esecuzione dell'agente di lettura log.

     [!NOTA]

     Non è necessario impostare LogReaderAgentProcessSecurity quando la pubblicazione viene creata da un membro del ruolo predefinito del server sysadmin. In questo caso l'agente rappresenterà l'account di SQL Server Agent. Per ulteriori informazioni, vedere Modello di sicurezza dell'agente di replica.

   • (Facoltativo) Impostare i campi SqlStandardLogin e SqlStandardPassword o SecureSqlStandardPassword di LogReaderAgentPublisherSecurity quando si utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione.

   • Chiamare il metodo CreateLogReaderAgent per creare il processo dell'agente di lettura log per il database.

5. Creare un'istanza della classe TransPublication e impostare le proprietà seguenti per questo oggetto:

   • Oggetto ServerConnection indicato nel passaggio 1 per ConnectionContext.

   • Nome del database pubblicato per DatabaseName.

   • Nome per la pubblicazione per Name.

   • Valore PublicationType di Transactional o Snapshot.

   • Campi Login e Password di SnapshotGenerationAgentProcessSecurity per fornire le credenziali per l'account di Windows con cui verrà eseguito il processo dell'agente snapshot. Questo account viene utilizzato anche quando l'agente snapshot stabilisce connessioni al server di distribuzione locale e per qualsiasi connessione remota quando si utilizza l'autenticazione di Windows.

     [!NOTA]

     Non è necessario impostare SnapshotGenerationAgentProcessSecurity quando la pubblicazione viene creata da un membro del ruolo predefinito del server sysadmin. In questo caso l'agente rappresenterà l'account di SQL Server Agent. Per ulteriori informazioni, vedere Modello di sicurezza dell'agente di replica.

   • (Facoltativo) Campi SqlStandardLogin e SqlStandardPassword o SecureSqlStandardPassword di SnapshotGenerationAgentPublisherSecurity quando si utilizza l'autenticazione di SQL Server per la connessione al server di pubblicazione.

   • (Facoltativo) Utilizzare l'operatore logico OR inclusivo (| in Visual C# e Or in Visual Basic) e l'operatore logico OR esclusivo (^ in Visual C# e Xor in Visual Basic) per impostare i valori PublicationAttributes per la proprietà Attributes.

   • (Facoltativo) Nome del server di pubblicazione per PublisherName quando il server di pubblicazione non è non SQL Server.

6. Chiamare il metodo Create per creare la pubblicazione.

   Nota sulla sicurezza

   Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori specificati per tutte le proprietà, inclusa SnapshotGenerationAgentProcessSecurity, vengono inviati al server di distribuzione come testo normale. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di chiamare il metodo Create. Per ulteriori informazioni, vedere Abilitazione di connessioni crittografate al Motore di database (Gestione configurazione SQL Server).

7. Chiamare il metodo CreateSnapshotAgent per creare il processo dell'agente snapshot per la pubblicazione.

Per creare una pubblicazione di tipo merge

1. Creare una connessione al server di pubblicazione tramite la classe ServerConnection.

2. Creare un'istanza della classe ReplicationDatabase per il database di pubblicazione, impostare la proprietà ConnectionContext sull'istanza di ServerConnection del passaggio 1, quindi chiamare il metodo LoadProperties. Se LoadProperties restituisce false, verificare che il database esista.

3. Se la proprietà EnabledMergePublishing è false, impostarla su true e chiamare CommitPropertyChanges.

4. Creare un'istanza della classe MergePublication e impostare le proprietà seguenti per questo oggetto:

   • Oggetto ServerConnection indicato nel passaggio 1 per ConnectionContext.

   • Nome del database pubblicato per DatabaseName.

   • Nome per la pubblicazione per Name.

   • Campi Login e Password di SnapshotGenerationAgentProcessSecurity per fornire le credenziali per l'account di Windows con cui verrà eseguito il processo dell'agente snapshot. Questo account viene utilizzato anche quando l'agente snapshot stabilisce connessioni al server di distribuzione locale e per qualsiasi connessione remota quando si utilizza l'autenticazione di Windows.

     [!NOTA]

     Non è necessario impostare SnapshotGenerationAgentProcessSecurity quando la pubblicazione viene creata da un membro del ruolo predefinito del server sysadmin. Per ulteriori informazioni, vedere Modello di sicurezza dell'agente di replica.

   • (Facoltativo) Utilizzare l'operatore logico OR inclusivo (| in Visual C# e Or in Visual Basic) e l'operatore logico OR esclusivo (^ in Visual C# e Xor in Visual Basic) per impostare i valori PublicationAttributes per la proprietà Attributes.

5. Chiamare il metodo Create per creare la pubblicazione.

   Nota sulla sicurezza

   Quando si configura un server di pubblicazione con un server di distribuzione remoto, i valori specificati per tutte le proprietà, inclusa SnapshotGenerationAgentProcessSecurity, vengono inviati al server di distribuzione come testo normale. È consigliabile crittografare la connessione tra il server di pubblicazione e il server di distribuzione remoto prima di chiamare il metodo Create. Per ulteriori informazioni, vedere Abilitazione di connessioni crittografate al Motore di database (Gestione configurazione SQL Server).

6. Chiamare il metodo CreateSnapshotAgent per creare il processo dell'agente snapshot per la pubblicazione.

Esempi (RMO)

In questo esempio il database AdventureWorks viene abilitato per la pubblicazione transazionale, viene definito un processo dell'agente di lettura log e viene creata la pubblicazione AdvWorksProductTran. Per questa pubblicazione è necessario definire un articolo. Le credenziali dell'account di Windows necessarie per creare il processo dell'agente di lettura log e il processo dell'agente snapshot vengono passate in fase di esecuzione. Per informazioni sull'utilizzo di oggetti RMO per definire articoli snapshot e transazionali, vedere Definizione di un articolo.

           // Set the Publisher, publication database, and publication names.
            string publicationName = "AdvWorksProductTran";
            string publicationDbName = "AdventureWorks2012";
            string publisherName = publisherInstance;

            ReplicationDatabase publicationDb;
            TransPublication publication;

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


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

                // Enable the AdventureWorks2012 database for transactional publishing.
                publicationDb = new ReplicationDatabase(publicationDbName, conn);

                // If the database exists and is not already enabled, 
                // enable it for transactional publishing.
                if (publicationDb.LoadProperties())
                {
                    if (!publicationDb.EnabledTransPublishing)
                    {
                        publicationDb.EnabledTransPublishing = true;
                    }

                    // If the Log Reader Agent does not exist, create it.
                    if (!publicationDb.LogReaderAgentExists)
                    {
                        // Specify the Windows account under which the agent job runs.
                        // This account will be used for the local connection to the 
                        // Distributor and all agent connections that use Windows Authentication.
                        publicationDb.LogReaderAgentProcessSecurity.Login = winLogin;
                        publicationDb.LogReaderAgentProcessSecurity.Password = winPassword;

                        // Explicitly set authentication mode for the Publisher connection
                        // to the default value of Windows Authentication.
                        publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = true;

                        // Create the Log Reader Agent job.
                        publicationDb.CreateLogReaderAgent();
                    }
                }
                else
                {
                    throw new ApplicationException(String.Format(
                        "The {0} database does not exist at {1}.",
                        publicationDb, publisherName));
                }

                // Set the required properties for the transactional publication.
                publication = new TransPublication();
                publication.ConnectionContext = conn;
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;

                // Specify a transactional publication (the default).
                publication.Type = PublicationType.Transactional;

                // Activate the publication so that we can add subscriptions.
                publication.Status = State.Active;

                // Enable push and pull subscriptions and independent Distribition Agents.
                publication.Attributes |= PublicationAttributes.AllowPull;
                publication.Attributes |= PublicationAttributes.AllowPush;
                publication.Attributes |= PublicationAttributes.IndependentAgent;

                // Specify the Windows account under which the Snapshot Agent job runs.
                // This account will be used for the local connection to the 
                // Distributor and all agent connections that use Windows Authentication.
                publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
                publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

                // Explicitly set the security mode for the Publisher connection
                // Windows Authentication (the default).
                publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

                if (!publication.IsExistingObject)
                {
                    // Create the transactional publication.
                    publication.Create();

                    // Create a Snapshot Agent job for the publication.
                    publication.CreateSnapshotAgent();
                }
                else
                {
                    throw new ApplicationException(String.Format(
                        "The {0} publication already exists.", publicationName));
                }
            }

            catch (Exception ex)
            {
                // Implement custom application error handling here.
                throw new ApplicationException(String.Format(
                    "The publication {0} could not be created.", publicationName), ex);
            }
            finally
            {
                conn.Disconnect();
            }

' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim publisherName As String = publisherInstance

Dim publicationDb As ReplicationDatabase
Dim publication As TransPublication

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

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

    ' Enable the AdventureWorks2012 database for transactional publishing.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    ' If the database exists and is not already enabled, 
    ' enable it for transactional publishing.
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledTransPublishing Then
            publicationDb.EnabledTransPublishing = True
        End If

        ' If the Log Reader Agent does not exist, create it.
        If Not publicationDb.LogReaderAgentExists Then
            ' Specify the Windows account under which the agent job runs.
            ' This account will be used for the local connection to the 
            ' Distributor and all agent connections that use Windows Authentication.
            publicationDb.LogReaderAgentProcessSecurity.Login = winLogin
            publicationDb.LogReaderAgentProcessSecurity.Password = winPassword

            ' Explicitly set authentication mode for the Publisher connection
            ' to the default value of Windows Authentication.
            publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = True

            ' Create the Log Reader Agent job.
            publicationDb.CreateLogReaderAgent()
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist at {1}.", _
         publicationDb, publisherName))
    End If

    ' Set the required properties for the transactional publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Specify a transactional publication (the default).
    publication.Type = PublicationType.Transactional

    'Enable push and pull subscriptions and independent Distribition Agents.
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPull
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPush
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.IndependentAgent

    ' Activate the publication so that we can add subscriptions.
    publication.Status = State.Active

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    If Not publication.IsExistingObject Then
        ' Create the transactional publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

In questo esempio il database AdventureWorks viene abilitato per la pubblicazione di tipo merge e viene creata la pubblicazione AdvWorksSalesOrdersMerge. Per questa pubblicazione è ancora necessario definire gli articoli. Le credenziali dell'account di Windows necessarie per creare il processo dell'agente snapshot vengono passate in fase di esecuzione. Per informazioni sull'utilizzo di oggetti RMO per definire articoli di merge, vedere Definizione di un articolo.

         // Set the Publisher, publication database, and publication names.
            string publisherName = publisherInstance;
            string publicationName = "AdvWorksSalesOrdersMerge";
            string publicationDbName = "AdventureWorks2012";

            ReplicationDatabase publicationDb;
            MergePublication publication;

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

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

                // Enable the database for merge publication.               
                publicationDb = new ReplicationDatabase(publicationDbName, conn);
                if (publicationDb.LoadProperties())
                {
                    if (!publicationDb.EnabledMergePublishing)
                    {
                        publicationDb.EnabledMergePublishing = true;
                    }
                }
                else
                {
                    // Do something here if the database does not exist. 
                    throw new ApplicationException(String.Format(
                        "The {0} database does not exist on {1}.",
                        publicationDb, publisherName));
                }

                // Set the required properties for the merge publication.
                publication = new MergePublication();
                publication.ConnectionContext = conn;
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;

                // Enable precomputed partitions.
                publication.PartitionGroupsOption = PartitionGroupsOption.True;

                // Specify the Windows account under which the Snapshot Agent job runs.
                // This account will be used for the local connection to the 
                // Distributor and all agent connections that use Windows Authentication.
                publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
                publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

                // Explicitly set the security mode for the Publisher connection
                // Windows Authentication (the default).
                publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

                // Enable Subscribers to request snapshot generation and filtering.
                publication.Attributes |= PublicationAttributes.AllowSubscriberInitiatedSnapshot;
                publication.Attributes |= PublicationAttributes.DynamicFilters;

                // Enable pull and push subscriptions.
                publication.Attributes |= PublicationAttributes.AllowPull;
                publication.Attributes |= PublicationAttributes.AllowPush;

                if (!publication.IsExistingObject)
                {
                    // Create the merge publication.
                    publication.Create();
                    
                    // Create a Snapshot Agent job for the publication.
                    publication.CreateSnapshotAgent();
                }
                else
                {
                    throw new ApplicationException(String.Format(
                        "The {0} publication already exists.", publicationName));
                }
            }

            catch (Exception ex)
            {
                // Implement custom application error handling here.
                throw new ApplicationException(String.Format(
                    "The publication {0} could not be created.", publicationName), ex);
            }
            finally
            {
                conn.Disconnect();
            }

' Set the Publisher, publication database, and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publicationDb As ReplicationDatabase
Dim publication As MergePublication

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

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

    ' Enable the database for merge publication.                
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = True
        End If
    Else
        ' Do something here if the database does not exist. 
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist on {1}.", _
         publicationDb, publisherName))
    End If

    ' Set the required properties for the merge publication.
    publication = New MergePublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Enable precomputed partitions.
    publication.PartitionGroupsOption = PartitionGroupsOption.True

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    ' Enable Subscribers to request snapshot generation and filtering.
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowSubscriberInitiatedSnapshot
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.DynamicFilters

    ' Enable pull and push subscriptions
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPull
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPush

    If Not publication.IsExistingObject Then
        ' Create the merge publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

[Top]

Vedere anche

Concetti

Utilizzo di sqlcmd con variabili di scripting

Pubblicazione di dati e oggetti di database

Concetti di base relativi a RMO (Replication Management Objects)

Definizione di un articolo

Visualizzazione e modifica delle proprietà della pubblicazione

Configurazione della distribuzione

Sicurezza del database di distribuzione

Sicurezza del server di pubblicazione