sys.sp_add_agent_profile (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

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

Transact-SQL convenções de sintaxe

Syntax

sys.sp_add_agent_profile
    [ [ @profile_id = ] profile_id OUTPUT ]
    , [ @profile_name = ] N'profile_name'
    , [ @agent_type = ] agent_type
    [ , [ @profile_type = ] profile_type ]
    [ , [ @description = ] N'description' ]
    [ , [ @default = ] default ]
[ ; ]

Arguments

[ @profile_id = ] profile_id SAÍDA

O ID associado ao perfil recém-inserido. @profile_id é int e é um parâmetro opcional OUTPUT . Se especificado, o valor é definido para o novo ID de perfil.

[ @profile_name = ] N'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 destes valores.

Value Description
1 Agente de instantâneo
2 Agente Leitor de Logs
3 Agente de Distribuição
4 Agente de fusão
9 Agente leitor de filas

[ @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. Apenas perfis personalizados podem ser criados usando este procedimento armazenado; portanto, o único valor válido é 1. Só o SQL Server cria perfis de 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 a ser adicionado se tornará o novo perfil padrão do agente especificado pela @agent_type.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_add_agent_profile é usado na replicação de snapshot, replicação transacional e replicação de mesclagem.

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

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

Permissions

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

Conteúdo relacionado

  • Last updated on