sp_add_agent_profile (Transact-SQL)

Artigo
05/07/2013

Cria um perfil novo para um agente de replicação. Esse procedimento armazenado é executado no Distribuidor em qualquer banco de dados.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

sp_add_agent_profile [ [ @profile_id= ] profile_id OUTPUT ]
        , [ @profile_name= ] 'profile_name'  
        , [ @agent_type= ] 'agent_type' ] 
    [ , [ @profile_type= ] profile_type ]
    [ , [ @description= ] 'description' ]
    [ , [ @default= ] default ]

Argumentos

[ @profile_id= ] profile_id
É a ID associada ao perfil inserido recentemente. profile_id é int, e é um parâmetro opcional de OUTPUT. Se especificado, o valor será definido como a nova ID do perfil.
[ @profile_name= ] 'profile_name'
É o nome do perfil. profile_name é sysname, sem padrão.
[ @agent_type= ] 'agent_type'
É o tipo de agente de replicação. agent_type é int, sem padrão, e pode ter um destes valores.

Valor

Descrição

1

Agente de Instantâneo

2

Agente de Leitor de Log

3

Agente de Distribuição

4

Agente de Mesclagem

9

Agente de Leitor de Fila
[ @profile_type= ] profile_type
É o tipo de perfil.profile_type é int, com um padrão de 1.

0 indica um perfil de sistema. 1 indica um perfil personalizado. Somente perfis personalizados podem ser criados usando esse procedimento armazenado; portanto, o único valor válido é 1. Somente o MicrosoftSQL Server cria perfis de sistema.
[ @description= ] 'description'
É uma descrição do perfil. description é nvarchar(3000), sem padrão.
[ @default= ] default
Indica se o perfil é padrão para agent_type*.* default é bit, com um padrão de 0. 1 indica que o perfil que está sendo adicionado se tornará o novo perfil padrão para o agente especificado por agent_type.

Valor	Descrição
1	Agente de Instantâneo
2	Agente de Leitor de Log
3	Agente de Distribuição
4	Agente de Mesclagem
9	Agente de Leitor de Fila

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_add_agent_profile é usado em replicação de instantâneo e replicação transacional.

Perfis de agente personalizados são adicionados com os valores de parâmetro de agente padrão. Use sp_change_agent_parameter (Transact-SQL) para alterar esses valores padrão ou sp_add_agent_parameter (Transact-SQL) para adicionar parâmetros adicionais.

Quando sp_add_agent_profile é executado, uma linha é adicionada para o novo perfil de cliente na tabela MSagent_profiles (Transact-SQL) e os parâmetros padrão associados a esse perfil são adicionados à tabela MSagent_parameters (Transact-SQL).