Compartilhar via


sp_add_agent_profile (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

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

Convenções de sintaxe de 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 = ] N'description' ]
    [ , [ @default = ] default ]

Argumentos

@profile_id [ = ] profile_id

A ID associada ao perfil recém-inserido. @profile_id é int e é um parâmetro opcional 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 ser um desses valores.

Valor Descrição
1 Snapshot Agent
2 Agente de Leitor de Log
3 Agente de Distribuição
4 Merge Agent
9 Queue Reader Agent

@profile_type [ = ] profile_type

O tipo de perfil. profile_type é int, com um padrão de 1.

0 indica um perfil do 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 SQL Server cria perfis do sistema.

@description [ = ] N'descrição'

Uma descrição do perfil. @description é nvarchar(3000), sem padrão.

@default [ = ] padrão

Indica se o perfil é o 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 pelo @agent_type.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_add_agent_profile é usado na replicação de instantâneo, replicação transacional e replicação de mesclagem.

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

Quando sp_add_agent_profile executado, uma linha é adicionada para o novo perfil personalizado na tabela MSagent_profiles e os parâmetros padrão associados para esse perfil são adicionados à tabela MSagent_parameters .

Permissões

Somente membros da função de servidor fixa sysadmin podem executar sp_add_agent_profile.