sp_add_agent_profile (Transact-SQL)

适用于:SQL Server (所有受支持的版本) Azure SQL 托管实例

为复制代理创建新的配置文件。 此存储过程在分发服务器上的任何数据库中执行。

主题链接图标Transact-SQL 语法约定

语法

  
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 ]  

参数

[ @profile_id = ] profile_id 与新插入的配置文件关联的 ID。 profile_id为 int,是可选的 OUTPUT 参数。 如果指定该 ID,则值将设置为新的配置文件 ID。

[ @profile_name = ] 'profile_name' 配置文件的名称。 profile_namesysname,没有默认值。

[ @agent_type = ] 'agent_type' 复制代理的类型。 agent_type为 int,没有默认值,可以是其中一个值。

说明
1 快照代理
2 日志读取器代理
3 分发代理
4 合并代理
9 队列读取器代理

[ @profile_type = ] profile_type 配置文件的类型。profile_typeint,默认值为 1

0 表示系统配置文件。 1 表示自定义配置文件。 只能使用此存储过程创建自定义配置文件;因此,唯一有效的值为 1。 只有 Microsoft SQL Server创建系统配置文件。

[ @description = ] 'description' 配置文件的说明。 说明nvarchar (3000) ,无默认值。

[ @default = ] default指示配置文件是否为 agent_type*.* 默认值的默认值,默认值01 表示要添加的配置文件将成为 由agent_type指定的代理的新默认配置文件。

返回代码值

0 (成功) 或 1 (失败)

备注

sp_add_agent_profile 用于快照复制、事务复制和合并复制。

自定义代理配置文件与默认代理参数值一起添加。 使用 sp_change_agent_parameter (Transact-SQL) 更改这些默认值或 sp_add_agent_parameter (Transact-SQL) 来添加其他参数。

执行 sp_add_agent_profile 后,将为 MSagent_profiles (transact-SQL) 表中的新自定义配置文件添加一行,并将此配置文件的相关默认参数添加到 transact-SQL) 表中MSagent_parameters (

权限

只有 sysadmin 固定服务器角色的成员才能执行 sp_add_agent_profile

另请参阅

处理复制代理配置文件
复制代理配置文件
sp_add_agent_parameter (Transact-SQL)
sp_change_agent_parameter (Transact-SQL)
sp_change_agent_profile (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_drop_agent_profile (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
sp_help_agent_profile (Transact-SQL)