Partilhar via


Como trabalhar com perfis de agente de replicação (programação RMO)

Os perfis de agentes de replicação são usados para definir os valores padrão quando é criado um trabalho de agente. Cada agente tem um perfil padrão e alguns agentes têm perfis adicionais predefinidos. Você pode criar perfis definidos pelo usuário usando RMO (Replication Management Objects). Para obter informações sobre perfis, consulte Perfis do Replication Agent.

Para criar um perfil de agente novo

  1. Crie uma conexão para o Distribuidor usando uma instância da classe ServerConnection.

  2. Crie uma instância da classe AgentProfile.

  3. Defina as seguintes propriedades no objeto:

    • Name - o nome para o perfil.

    • AgentType- um valor AgentType que especifica o tipo de agente de replicação para o qual está sendo criado o perfil.

    • ConnectionContext - o ServerConnection criado na etapa 1.

    • (Opcional) Description- uma descrição do perfil.

    • (Opcional) Default - defina essa propriedade para true se todos os trabalhos de agente novos para essa AgentType utilizarão, por padrão, esse perfil.

  4. Chame o método Create para criar o perfil no servidor.

  5. Uma vez que o perfil existir no servidor, você poderá personalizá-lo adicionando, removendo ou modificando os valores dos parâmetros do agente de replicação.

  6. Para atribuir o perfil a um trabalho de agente de replicação existente, chame o método AssignToAgent. Passe o nome do banco de dados de distribuição para distributionDBName e a ID do trabalho para agentID.

Para modificar um perfil de agente existente

  1. Crie uma conexão para o Distribuidor usando uma instância da classe ServerConnection.

  2. Crie uma instância da classe ReplicationServer. Passe o objeto ServerConnection criado na etapa 1.

  3. Chame o método LoadProperties. Se esse método retornar false, verifique se o Distribuidor existe.

  4. Chame o método EnumAgentProfiles. Passe um valor AgentType para reduzir os perfis retornados a um tipo específico de agente de replicação.

  5. Obtenha o objeto desejado AgentProfile dos ArrayList retornados, nos quais a propriedade Name do objeto corresponda ao nome do perfil.

  6. Chame um dos métodos seguintes de AgentProfile para alterar o perfil:

    • AddParameter - adiciona um parâmetro com suporte ao perfil, onde name é o nome parâmetro do agente de replicação e value é o valor especificado. Para enumerar todos os parâmetros de agente com suporte para um determinado tipo de agente, chame o método EnumParameterInfo. Este método retorna um ArrayList de objetos AgentProfileParameterInfo que representam todos os parâmetros com suporte.

    • RemoveParameter- remove um parâmetro existente do perfil, onde name é o nome do parâmetro do agente de replicação. Para enumerar todos os parâmetros de agente atuais definidos para o perfil, chame o método EnumParameters. Este método retorna um ArrayList de objetos AgentProfileParameter que representam o parâmetro existente para este perfil.

    • ChangeParameter - altera a configuração de um parâmetro existente no perfil, onde name é o nome do parâmetro do agente de replicação e newValue é o valor para o qual o parâmetro está sendo alterado. Para enumerar todos os parâmetros de agente atuais definidos para o perfil, chame o método EnumParameters. Este método retorna um ArrayList de objetos AgentProfileParameter que representam o parâmetro existente para este perfil. Para enumerar todas as configurações de parâmetro de agente com suporte, chame o método EnumParameterInfo. Este método retorna um ArrayList de objetos AgentProfileParameterInfo que representam os valores com suporte para todos os parâmetros.

Para excluir um perfil de agente

  1. Crie uma conexão para o Distribuidor usando uma instância da classe ServerConnection.

  2. Crie uma instância da classe AgentProfile. Defina o nome do perfil para Name e o ServerConnection da etapa 1 para ConnectionContext.

  3. Chame o método LoadProperties. Se este método retornar false, o banco de dados com o nome especificado estava incorreto ou o perfil não existe no servidor.

  4. Verifique se a propriedade Type é definida como User, o que indica um perfil de cliente. Você não deve remover um perfil que possui um valor de System para Type.

  5. Chame o método Remove para remover o perfil definido pelo usuário representado por esse objeto do servidor.