Criar uma assinatura push
Aplica-se a: SQL Server Banco de Dados SQL do Azure
Este tópico descreve como criar uma assinatura push no SQL Server usando o SQL Server Management Studio, o Transact-SQL ou o Replication Management Objects (RMO). Para saber mais sobre como criar uma assinatura push para um assinante não SQL Server, confira Criar uma assinatura para um assinante não SQL Server.
Observação
A Instância Gerenciada de SQL do Azure pode ser um publicador, um distribuidor e um assinante para a replicação transacional e de instantâneo. Os bancos de dados do Banco de Dados SQL do Azure só podem ser assinantes por push para a replicação transacional e de instantâneo. Para obter mais informações, confira Replicação transacional com o Banco de Dados SQL do Azure e a Instância Gerenciada de SQL do Azure.
Como usar o SQL Server Management Studio.
Crie uma assinatura push no Publicador ou Assinante, usando o Assistente para Novas Assinaturas. Siga as páginas no assistente para:
Especificar o Publicador e a publicação.
Selecione onde os agentes de replicação executarão. Para uma assinatura push, selecione Executar todos os agentes no Distribuidor (assinaturas push) na página Local do Distribution Agent ou na página Local do Merge Agent , dependendo do tipo de publicação.
Especifique Assinantes e bancos de dados de assinatura.
Especifique os logons e senhas usadas para conexões feitas por agentes de replicação:
Para assinaturas para instantâneos e publicações transacionais, especifique as credenciais na página Segurança do Distribution Agent .
Para assinaturas para publicações de mesclagem, especifique as credenciais na página Segurança do Merge Agent .
Para saber mais sobre as permissões que cada agente requer, confira Modelo de segurança do agente de replicação.
Especifique uma agenda de sincronização e quando o Assinante deve ser inicializado.
Especifique opções adicionais para publicações de mesclagem: tipo de assinatura e valores para filtragem com parâmetros.
Especifique opções adicionais para publicações transacionais que permitem atualização de assinaturas. Uma opção é decidir se os Assinantes devem confirmar as alterações no Publicador imediatamente ou gravá-las em uma fila. Outra opção é configurar as credenciais usadas para conectar-se do Assinante ao Publicador.
Opcionalmente, faça o script da assinatura.
Para criar uma assinatura push do Publicador
Conecte-se ao Publicador no Microsoft SQL Server Management Studio e, em seguida, expanda o nó de servidor.
Expanda a pasta Replicação e, em seguida, a pasta Publicações Locais .
Clique com o botão direito do mouse na publicação na qual você deseja criar uma ou mais assinaturas e selecione Novas Assinaturas.
Complete as páginas no Assistente para Novas Assinaturas.
Para criar uma assinatura push do Assinante
Conecte-se ao Assinante no SQL Server Management Studio e, em seguida, expanda o nó de servidor.
Expanda a pasta Replicação .
Clique com o botão direito do mouse na pasta Assinaturas Locais e depois selecione Novas Assinaturas.
Na página Publicação do Assistente para Nova Assinatura, selecione <Encontrar publicador do SQL Server> ou <Encontrar publicador do Oracle> na lista suspensa Publicador.
Conecte-se ao Publicador na caixa de diálogo Conectar ao Servidor .
Selecione uma publicação na página Publicação .
Complete as páginas no Assistente para Novas Assinaturas.
Usando o Transact-SQL
É possível criar assinaturas push programaticamente usando procedimentos armazenados de replicação. Os procedimentos armazenados usados dependem do tipo de publicação ao qual a assinatura pertence.
Importante
Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Se for necessário armazenar credenciais em um arquivo de script, você deverá proteger o arquivo para impedir acesso não autorizado.
Para criar uma assinatura push em um instantâneo ou publicação transacional
No Publicador do banco de dados de publicação, verifique se a publicação dá suporte às assinaturas push, executando sp_helppublication.
Se o valor de allow_push for 1, as assinaturas push terão suporte.
Se o valor de allow_push for 0, execute sp_changepublication. Especifique allow_push para @property e true para @value.
No Publicador, no banco de dados da publicação, execute sp_addsubscription. Especifique @publication, @subscribere @destination_db. Especifique um valor push para @subscription_type. Para saber mais sobre como atualizar assinaturas, confira Criar uma assinatura atualizável em uma publicação transacional.
No Publicador do banco de dados de publicação, execute sp_addpushsubscription_agent. Especifique o seguinte:
Os parâmetros @subscriber, @subscriber_dbe @publication .
As credenciais do Microsoft Windows com as quais o Distribution Agent do Distribuidor é executado para @job_login e @job_password.
Observação
As conexões realizadas por meio da Autenticação Integrada do Windows sempre usam as credenciais do Windows especificadas por @job_login e @job_password. O Agente de Distribuição sempre faz a conexão local com o Distribuidor usando a Autenticação Integrada do Windows. Por padrão, o agente se conectará ao Assinante usando a Autenticação Integrada do Windows.
(Opcional) Um valor de 0 para @subscriber_security_mode e as informações de logon do Microsoft SQL Server para @subscriber_login e @subscriber_password. Especifique esses parâmetros se for necessário usar a Autenticação do SQL Server para conexão com o Assinante.
Agenda para o trabalho do Distribution Agent para essa assinatura. Para saber mais, confira Especificar agendamentos de sincronização.
Importante
Quando você está criando uma assinatura push em um Publicador com um Distribuidor remoto, os valores especificados para todos os parâmetros, inclusive job_login e job_password, são enviados para o Distribuidor como texto sem formatação. Você deve criptografar a conexão entre o Publicador e seu Distribuidor remoto antes de executar esse procedimento armazenado. Para obter mais informações, confira Habilitar conexões criptografadas para o mecanismo de banco de dados (SQL Server Configuration Manager).
Para criar uma assinatura push para publicação de mesclagem
No Publicador do banco de dados de publicação, verifique se a publicação dá suporte às assinaturas push executando sp_helpmergepublication.
Se o valor de allow_push for 1, a publicação dará suporte às assinaturas push.
Se o valor de allow_push não for 1, execute sp_changemergepublication. Especifique allow_push para @property e true para @value.
No Publicador do banco de dados da publicação, execute sp_addmergesubscription. Especifique os seguintes parâmetros:
@publication. Esse é o nome da publicação.
@subscriber_type. Para uma assinatura de cliente, especifique local. Para uma assinatura de servidor, especifique global.
@subscription_priority. Para uma assinatura de servidor, especifique uma prioridade para a assinatura de (0,00 a 99,99).
Para saber mais, confira Detecção e resolução de conflito de replicação de mesclagem avançada.
No Publicador do banco de dados da publicação, execute sp_addmergepushsubscription_agent. Especifique o seguinte:
Os parâmetros @subscriber, @subscriber_dbe @publication .
As credenciais do Windows sob as quais o Merge Agent no Distribuidor é executado para o @job_login e @job_password.
Observação
As conexões realizadas por meio da Autenticação Integrada do Windows sempre usam as credenciais do Windows especificadas por @job_login e @job_password. O Agente de Mesclagem sempre faz a conexão local com o Distribuidor usando a Autenticação Integrada do Windows. Por padrão, o agente se conectará ao Assinante usando a Autenticação Integrada do Windows.
(Opcional) Valor de 0 para @subscriber_security_mode e informações de logon do SQL Server para @subscriber_login e @subscriber_password. Especifique esses parâmetros se for necessário usar a Autenticação do SQL Server para conexão com o Assinante.
(Opcional) Valor de 0 para @publisher_security_mode e informações de logon do SQL Server para @publisher_login e @publisher_password. Especifique esses valores se for necessário usar a Autenticação do SQL Server para conexão com o Publicador.
Agenda para o trabalho do Merge Agent para essa assinatura. Para saber mais, confira Especificar agendamentos de sincronização.
Importante
Quando você está criando uma assinatura push em um Publicador com um Distribuidor remoto, os valores especificados para todos os parâmetros, inclusive job_login e job_password, são enviados para o Distribuidor como texto sem formatação. Você deve criptografar a conexão entre o Publicador e seu Distribuidor remoto antes de executar esse procedimento armazenado. Para obter mais informações, confira Habilitar conexões criptografadas para o mecanismo de banco de dados (SQL Server Configuration Manager).
Exemplos (Transact-SQL)
O exemplo a seguir cria uma nova assinatura push para uma publicação transacional. Os valores de logon e senha são fornecidos em runtime por meio de variáveis de script sqlcmd.
-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). 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 @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorks2022Replica';
--Add a push subscription to a transactional publication.
USE [AdventureWorks2022]
EXEC sp_addsubscription
@publication = @publication,
@subscriber = @subscriber,
@destination_db = @subscriptionDB,
@subscription_type = N'push';
--Add an agent job to synchronize the push subscription.
EXEC sp_addpushsubscription_agent
@publication = @publication,
@subscriber = @subscriber,
@subscriber_db = @subscriptionDB,
@job_login = $(Login),
@job_password = $(Password);
GO
O exemplo a seguir cria uma nova assinatura push para uma publicação de mesclagem. Os valores de logon e senha são fornecidos em runtime por meio de variáveis de script sqlcmd.
-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). 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 @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @hostname AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorksReplica';
SET @hostname = N'adventure-works\david8'
-- Add a push subscription to a merge publication.
USE [AdventureWorks2022];
EXEC sp_addmergesubscription
@publication = @publication,
@subscriber = @subscriber,
@subscriber_db = @subscriptionDB,
@subscription_type = N'push',
@hostname = @hostname;
--Add an agent job to synchronize the push subscription.
EXEC sp_addmergepushsubscription_agent
@publication = @publication,
@subscriber = @subscriber,
@subscriber_db = @subscriptionDB,
@job_login = $(Login),
@job_password = $(Password);
GO
Usar Replication Management Objects
Crie assinaturas push de forma programada, usando RMO (Replication Management Objects). As classes RMO usadas para criar uma assinatura push dependem do tipo de publicação no qual a assinatura é criada.
Importante
Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Se for preciso armazenar credenciais, use os serviços criptográficos fornecidos pelo Microsoft Windows .NET Framework.
Para criar uma assinatura push em um instantâneo ou publicação transacional
Crie uma conexão com o Publicador usando a classe ServerConnection .
Crie uma instância da classe TransPublication usando a conexão com o Publicador da etapa 1. Especifique Name, DatabaseName, e ConnectionContext.
Chame o método LoadProperties . Se esse método retornar false, as propriedades especificadas na etapa 2 estarão incorretas ou a publicação não existe no servidor.
Realize uma lógica AND de bit a bit (& no Visual C# e And no Visual Basic) entre a propriedade Attributes e AllowPush. Se o resultado for None, defina Attributes para o resultado de uma lógica bit a bit OR (| no Visual C# e Or em Visual Basic) entre Attributes e AllowPush. Em seguida, chame CommitPropertyChanges para ativar assinaturas push.
Se não houver banco de dados de assinatura, crie-o usando a classe Database . Para saber mais, confira Criar, alterar e remover bancos de dados.
Criar uma instância da classe TransSubscription.
Defina as seguintes propriedades de assinatura:
O ServerConnection para o Publicador criado na Etapa 1 para ConnectionContext.
Nome do banco de dados de assinatura para SubscriptionDBName.
Nome do Assinante para SubscriberName.
Nome do banco de dados de publicação para DatabaseName.
Nome da publicação para PublicationName.
Os parâmetros Login e Password de SynchronizationAgentProcessSecurity para fornecer as credenciais para a conta do Microsoft Windows em que o Distribution Agent é executado no Distribuidor. Essa conta é usada para fazer conexões locais com o Distribuidor e para fazer conexões remotas usando a Autenticação do Windows.
Observação
Configurar SynchronizationAgentProcessSecurity não é necessário quando a assinatura é criada por um membro da função de servidor fixa sysadmin, mas recomendamos fazer isso. Nesse caso, o agente representará a conta do SQL Server Agent. Para saber mais, confira Modelo de segurança do Agente de Replicação.
(Opcional) Valor de true (padrão) para CreateSyncAgentByDefault para criar um trabalho de agente que seja usado para sincronizar a assinatura. Se você especificar false, a assinatura só poderá ser sincronizada programaticamente.
(Opcional) Defina WindowsAuthentication como False e os campos SqlStandardLogin e SqlStandardPassword ou SecureSqlStandardPassword de SubscriberSecurity ao usar a Autenticação do SQL Server para conexão com o Assinante.
Chame o método Create .
Importante
Ao criar uma assinatura push em um Publicador com um Distribuidor remoto, os valores fornecidos para todas as propriedades, inclusive SynchronizationAgentProcessSecurity, são enviados para o Distribuidor como texto sem formatação. É necessário criptografar a conexão entre o Publicador e o respectivo Distribuidor remoto antes de chamar o método Create. Para obter mais informações, confira Habilitar conexões criptografadas para o mecanismo de banco de dados (SQL Server Configuration Manager).
Para criar uma assinatura push para publicação de mesclagem
Crie uma conexão com o Publicador usando a classe ServerConnection .
Crie uma instância da classe MergePublication usando a conexão com o Publicador da etapa 1. Especifique Name, DatabaseName, e ConnectionContext.
Chame o método LoadProperties . Se esse método retornar false, as propriedades especificadas na etapa 2 estarão incorretas ou a publicação não existe no servidor.
Realize uma lógica AND de bit a bit (& no Visual C# e And no Visual Basic) entre a propriedade Attributes e AllowPush. Se o resultado for None, defina Attributes para o resultado de uma lógica bit a bit OR (| no Visual C# e Or em Visual Basic) entre Attributes e AllowPush. Em seguida, chame CommitPropertyChanges para ativar assinaturas push.
Se não houver banco de dados de assinatura, crie-o usando a classe Database . Para saber mais, confira Criar, alterar e remover bancos de dados.
Criar uma instância da classe MergeSubscription.
Defina as seguintes propriedades de assinatura:
O ServerConnection para o Publicador criado na Etapa 1 para ConnectionContext.
Nome do banco de dados de assinatura para SubscriptionDBName.
Nome do Assinante para SubscriberName.
Nome do banco de dados de publicação para DatabaseName.
Nome da publicação para PublicationName.
Os parâmetros Login e Password de SynchronizationAgentProcessSecurity para fornecer as credenciais para a conta do Microsoft Windows na qual o Merge Agent é executado no Distribuidor. Essa conta é usada para fazer conexões locais com o Distribuidor e para fazer conexões remotas por meio da Autenticação do Windows.
Observação
Configurar SynchronizationAgentProcessSecurity não é necessário quando a assinatura é criada por um membro da função de servidor fixa sysadmin, mas recomendamos fazer isso. Nesse caso, o agente representará a conta do SQL Server Agent. Para saber mais, confira Modelo de segurança do Agente de Replicação.
(Opcional) Valor de true (padrão) para CreateSyncAgentByDefault para criar um trabalho de agente que seja usado para sincronizar a assinatura. Se você especificar false, a assinatura só poderá ser sincronizada programaticamente.
(Opcional) Defina os campos SqlStandardLogin e SqlStandardPassword ou SecureSqlStandardPassword de SubscriberSecurity ao usar a Autenticação do SQL Server para conexão com o Assinante.
(Opcional) Defina WindowsAuthentication como False e os campos SqlStandardLogin e SqlStandardPassword ou SecureSqlStandardPassword de PublisherSecurity ao usar a Autenticação do SQL Server para conexão com o Publicador.
Chame o método Create .
Importante
Ao criar uma assinatura push em um Publicador com um Distribuidor remoto, os valores fornecidos para todas as propriedades, inclusive SynchronizationAgentProcessSecurity, são enviados para o Distribuidor como texto sem formatação. É necessário criptografar a conexão entre o Publicador e o respectivo Distribuidor remoto antes de chamar o método Create. Para obter mais informações, confira Habilitar conexões criptografadas para o mecanismo de banco de dados (SQL Server Configuration Manager).
Exemplos (RMO)
Esse exemplo cria uma nova assinatura push para uma publicação transacional. As credenciais da conta do Windows usadas para executar o trabalho do Agente de Distribuição são passadas em runtime.
// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksProductTran";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2022Replica";
string publicationDbName = "AdventureWorks2022";
//Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
// Create the objects that we need.
TransPublication publication;
TransSubscription subscription;
try
{
// Connect to the Publisher.
conn.Connect();
// Ensure that the publication exists and that
// it supports push subscriptions.
publication = new TransPublication();
publication.Name = publicationName;
publication.DatabaseName = publicationDbName;
publication.ConnectionContext = conn;
if (publication.IsExistingObject)
{
if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
{
publication.Attributes |= PublicationAttributes.AllowPush;
}
// Define the push subscription.
subscription = new TransSubscription();
subscription.ConnectionContext = conn;
subscription.SubscriberName = subscriberName;
subscription.PublicationName = publicationName;
subscription.DatabaseName = publicationDbName;
subscription.SubscriptionDBName = subscriptionDbName;
// Specify the Windows login credentials for the Distribution Agent job.
subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
subscription.SynchronizationAgentProcessSecurity.Password = winPassword;
// By default, subscriptions to transactional publications are synchronized
// continuously, but in this case we only want to synchronize on demand.
subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand;
// Create the push subscription.
subscription.Create();
}
else
{
// Do something here if the publication does not exist.
throw new ApplicationException(String.Format(
"The publication '{0}' does not exist on {1}.",
publicationName, publisherName));
}
}
catch (Exception ex)
{
// Implement the appropriate error handling here.
throw new ApplicationException(String.Format(
"The subscription to {0} could not be created.", publicationName), ex);
}
finally
{
conn.Disconnect();
}
' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2022Replica"
Dim publicationDbName As String = "AdventureWorks2022"
'Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransSubscription
Try
' Connect to the Publisher.
conn.Connect()
' Ensure that the publication exists and that
' it supports push subscriptions.
publication = New TransPublication()
publication.Name = publicationName
publication.DatabaseName = publicationDbName
publication.ConnectionContext = conn
If publication.IsExistingObject Then
If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
publication.Attributes = publication.Attributes _
Or PublicationAttributes.AllowPush
End If
' Define the push subscription.
subscription = New TransSubscription()
subscription.ConnectionContext = conn
subscription.SubscriberName = subscriberName
subscription.PublicationName = publicationName
subscription.DatabaseName = publicationDbName
subscription.SubscriptionDBName = subscriptionDbName
' Specify the Windows login credentials for the Distribution Agent job.
subscription.SynchronizationAgentProcessSecurity.Login = winLogin
subscription.SynchronizationAgentProcessSecurity.Password = winPassword
' By default, subscriptions to transactional publications are synchronized
' continuously, but in this case we only want to synchronize on demand.
subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand
' Create the push subscription.
subscription.Create()
Else
' Do something here if the publication does not exist.
Throw New ApplicationException(String.Format( _
"The publication '{0}' does not exist on {1}.", _
publicationName, publisherName))
End If
Catch ex As Exception
' Implement the appropriate error handling here.
Throw New ApplicationException(String.Format( _
"The subscription to {0} could not be created.", publicationName), ex)
Finally
conn.Disconnect()
End Try
Esse exemplo cria uma nova assinatura push para uma publicação de mesclagem. As credenciais da conta do Windows usadas para executar o trabalho do Agente de Mesclagem são passadas em runtime.
// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksSalesOrdersMerge";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2022Replica";
string publicationDbName = "AdventureWorks2022";
string hostname = @"adventure-works\garrett1";
//Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
// Create the objects that we need.
MergePublication publication;
MergeSubscription subscription;
try
{
// Connect to the Publisher.
conn.Connect();
// Ensure that the publication exists and that
// it supports push subscriptions.
publication = new MergePublication();
publication.Name = publicationName;
publication.DatabaseName = publicationDbName;
publication.ConnectionContext = conn;
if (publication.IsExistingObject)
{
if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
{
publication.Attributes |= PublicationAttributes.AllowPush;
}
// Define the push subscription.
subscription = new MergeSubscription();
subscription.ConnectionContext = conn;
subscription.SubscriberName = subscriberName;
subscription.PublicationName = publicationName;
subscription.DatabaseName = publicationDbName;
subscription.SubscriptionDBName = subscriptionDbName;
subscription.HostName = hostname;
// Set a schedule to synchronize the subscription every 2 hours
// during weekdays from 6am to 10pm.
subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.Weekly;
subscription.AgentSchedule.FrequencyInterval = Convert.ToInt32(0x003E);
subscription.AgentSchedule.FrequencyRecurrenceFactor = 1;
subscription.AgentSchedule.FrequencySubDay = ScheduleFrequencySubDay.Hour;
subscription.AgentSchedule.FrequencySubDayInterval = 2;
subscription.AgentSchedule.ActiveStartDate = 20051108;
subscription.AgentSchedule.ActiveEndDate = 20071231;
subscription.AgentSchedule.ActiveStartTime = 060000;
subscription.AgentSchedule.ActiveEndTime = 100000;
// Specify the Windows login credentials for the Merge Agent job.
subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
subscription.SynchronizationAgentProcessSecurity.Password = winPassword;
// Create the push subscription.
subscription.Create();
}
else
{
// Do something here if the publication does not exist.
throw new ApplicationException(String.Format(
"The publication '{0}' does not exist on {1}.",
publicationName, publisherName));
}
}
catch (Exception ex)
{
// Implement the appropriate error handling here.
throw new ApplicationException(String.Format(
"The subscription to {0} could not be created.", publicationName), ex);
}
finally
{
conn.Disconnect();
}
' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2022Replica"
Dim publicationDbName As String = "AdventureWorks2022"
Dim hostname As String = "adventure-works\garrett1"
'Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
' Create the objects that we need.
Dim publication As MergePublication
Dim subscription As MergeSubscription
Try
' Connect to the Publisher.
conn.Connect()
' Ensure that the publication exists and that
' it supports push subscriptions.
publication = New MergePublication()
publication.Name = publicationName
publication.DatabaseName = publicationDbName
publication.ConnectionContext = conn
If publication.IsExistingObject Then
If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
publication.Attributes = publication.Attributes _
Or PublicationAttributes.AllowPush
End If
' Define the push subscription.
subscription = New MergeSubscription()
subscription.ConnectionContext = conn
subscription.SubscriberName = subscriberName
subscription.PublicationName = publicationName
subscription.DatabaseName = publicationDbName
subscription.SubscriptionDBName = subscriptionDbName
subscription.HostName = hostname
' Set a schedule to synchronize the subscription every 2 hours
' during weekdays from 6am to 10pm.
subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.Weekly
subscription.AgentSchedule.FrequencyInterval = Convert.ToInt32("0x003E", 16)
subscription.AgentSchedule.FrequencyRecurrenceFactor = 1
subscription.AgentSchedule.FrequencySubDay = ScheduleFrequencySubDay.Hour
subscription.AgentSchedule.FrequencySubDayInterval = 2
subscription.AgentSchedule.ActiveStartDate = 20051108
subscription.AgentSchedule.ActiveEndDate = 20071231
subscription.AgentSchedule.ActiveStartTime = 60000
subscription.AgentSchedule.ActiveEndTime = 100000
' Specify the Windows login credentials for the Merge Agent job.
subscription.SynchronizationAgentProcessSecurity.Login = winLogin
subscription.SynchronizationAgentProcessSecurity.Password = winPassword
' Create the push subscription.
subscription.Create()
Else
' Do something here if the publication does not exist.
Throw New ApplicationException(String.Format( _
"The publication '{0}' does not exist on {1}.", _
publicationName, publisherName))
End If
Catch ex As Exception
' Implement the appropriate error handling here.
Throw New ApplicationException(String.Format( _
"The subscription to {0} could not be created.", publicationName), ex)
Finally
conn.Disconnect()
End Try