Create a Publication
In questo argomento viene descritto come creare una pubblicazione in SQL Server 2014 usando SQL Server Management Studio, Transact-SQL o Replica Management Objects (RMO).
Contenuto dell'articolo
Prima di iniziare:
Per creare una pubblicazione e definire articoli, utilizzando:
Prima di iniziare
Limitazioni e restrizioni
- I nomi di pubblicazioni e articoli non possono includere i caratteri seguenti: % , * , [ , ] , | , : , " , ? , ' , \ , / , < , >. Se gli oggetti nel database includono uno di questi caratteri e si desidera replicarli, è necessario specificare un nome di articolo diverso dal nome dell'oggetto nella finestra di dialogo Proprietà articolo - <Articolo> , disponibile nella 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, usare i servizi di crittografia forniti da Microsoft Windows .NET Framework.
Uso 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 pubblicazione nella finestra di dialogo Proprietà pubblicazione - <Pubblicazione> . Per informazioni sulla creazione di una pubblicazione da un database Oracle, vedere Creare una pubblicazione da un database Oracle.
Per creare una pubblicazione e definire articoli
Connettersi al server di pubblicazione in Microsoft SQL Server Management Studio e quindi espandere il nodo del server.
Espandere la cartella Replica e quindi fare clic con il pulsante destro del mouse sulla cartella Pubblicazioni locali .
Fare clic su Nuova pubblicazione.
Eseguire i vari passaggi della Creazione guidata nuova pubblicazione per:
Specificare un server di distribuzione se la distribuzione non è stata configurata sul server. Per altre informazioni sulla configurazione della distribuzione, vedere Configurare la pubblicazione e la 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 altre informazioni sulle impostazioni di sicurezza appropriate per la cartella, vedere Proteggere la 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 attivato nel server di distribuzione remoto.
Per altre informazioni, vedere Configure Distribution.
Scegliere un database di pubblicazione.
Selezionare un tipo di pubblicazione. Per altre 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 altre informazioni, vedere Filtrare i 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 Replication Agent Security Model e Replication Security Best Practices.
Facoltativamente, creare lo script della pubblicazione. Per altre informazioni, vedere Scripting Replication.
Specificare un nome per la pubblicazione.
Uso 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
Nel database di pubblicazione del server di pubblicazione eseguire sp_replicationdboption (Transact-SQL) per abilitare la pubblicazione del database corrente usando la replica snapshot o transazionale.
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.
Se non si è certi che esista un processo dell'agente di lettura log per un database pubblicato, eseguire sp_helplogreader_agent (Transact-SQL) nel server di pubblicazione nel database 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 in cui viene eseguito l'agente per @job_name e @password. Se l'agente userà SQL Server Autenticazione durante la connessione al server di pubblicazione, è necessario specificare anche un valore pari a 0 per @publisher_security_mode e le informazioni di accesso di Microsoft SQL Server per @publisher_login e @publisher_password. Procedere al passaggio 3.
Nel server di pubblicazione eseguire sp_addpublication (Transact-SQL). Specificare un nome di pubblicazione per @publication e, per il parametro @repl_freq , specificare un valore di per una pubblicazione snapshot o un valore di
snapshot
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:
% * [ ] | : " ? \ / <>
Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione usato nel passaggio 3 per @publication e le credenziali di Windows in cui viene eseguita la agente di snapshot per @snapshot_job_name e @password. Se l'agente userà SQL Server Autenticazione durante la connessione al server di pubblicazione, è necessario specificare anche un valore pari a 0 per @publisher_security_mode e le informazioni di accesso SQL Server per @publisher_login e @publisher_password. Verrà creato un processo dell'agente snapshot per la pubblicazione.
Importante
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 altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).
Aggiungere articoli alla pubblicazione. Per altre informazioni, vedere definire un articolo.
Avviare il processo dell'agente snapshot per generare lo snapshot iniziale per la pubblicazione. Per altre informazioni, vedere Creazione e applicazione dello snapshot iniziale.
Per creare una pubblicazione di tipo merge
Nel server di pubblicazione eseguire sp_replicationdboption (Transact-SQL) per abilitare la pubblicazione del database corrente usando la replica di tipo merge.
Nel database di pubblicazione del server di pubblicazione eseguire sp_addmergepublication (Transact-SQL). Specificare un nome per la pubblicazione per @publication e qualsiasi altra opzione di pubblicazione. In questo modo viene definita la pubblicazione.
Nota
I nomi delle pubblicazioni non possono includere i caratteri seguenti:
% * [ ] | : " ? \ / <>
Nel server di pubblicazione eseguire sp_addpublication_snapshot (Transact-SQL). Specificare il nome della pubblicazione usato nel passaggio 2 per @publication e le credenziali di Windows in cui viene eseguita la agente di snapshot per @snapshot_job_name e @password. Se l'agente userà SQL Server Autenticazione durante la connessione al server di pubblicazione, è necessario specificare anche un valore pari a 0 per @publisher_security_mode e le informazioni di accesso SQL Server per @publisher_login e @publisher_password. Verrà creato un processo dell'agente snapshot per la pubblicazione.
Importante
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 altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).
Aggiungere articoli alla pubblicazione. Per altre informazioni, vedere definire un articolo.
Avviare il processo dell'agente snapshot per generare lo snapshot iniziale per la pubblicazione. Per altre 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'120RTM';
-- Create a new snapshot job for the publication.
EXEC sp_addpublication_snapshot
@publication = @publication,
@job_login = @login,
@job_password = @password;
GO
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
Creare una connessione al server di pubblicazione tramite la classe ServerConnection .
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.Se la proprietà EnabledTransPublishing è impostata su
false
, impostarla sutrue
.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 sufalse
, eseguire le operazioni seguenti:Impostare i Login campi e Password o SecurePassword* di LogReaderAgentProcessSecurity per fornire le credenziali per l'account Microsoft Windows in cui viene eseguito l'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 altre 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.
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 altre 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# eOr
in Visual Basic) e l'operatore logico OR esclusivo (^
in Visual C# eXor
in Visual Basic) per impostare i valori di PublicationAttributes per la proprietà Attributes.(Facoltativo) Nome del server di pubblicazione per PublisherName quando il server di pubblicazione non è non SQL Server.
Chiamare il metodo Create per creare la pubblicazione.
Importante
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 altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).
Chiamare il metodo CreateSnapshotAgent per creare il processo dell'agente snapshot per la pubblicazione.
Per creare una pubblicazione di tipo merge
Creare una connessione al server di pubblicazione tramite la classe ServerConnection .
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.Se la proprietà EnabledMergePublishing è
false
, impostarla sutrue
e chiamare CommitPropertyChanges.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 altre informazioni, vedere Modello di sicurezza dell'agente di replica.(Facoltativo) Utilizzare l'operatore logico OR inclusivo (
|
in Visual C# eOr
in Visual Basic) e l'operatore logico OR esclusivo (^
in Visual C# eXor
in Visual Basic) per impostare i valori di PublicationAttributes per la proprietà Attributes.
Chiamare il metodo Create per creare la pubblicazione.
Importante
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 altre informazioni, vedere Abilitare le connessioni crittografate al motore di database (Gestione configurazione SQL Server).
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 Define an Article.
// 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 Define an Article.
// 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
Vedere anche
Utilizzo di sqlcmd con variabili di scripting
Pubblicare dati e oggetti di database
Concetti di base relativi a RMO (Replication Management Objects)
Define an Article
Visualizzare e modificare le proprietà della pubblicazione
Configurare la distribuzione
Proteggere il database di distribuzione
Proteggere il server di pubblicazione