sp_add_agent_profile (Transact-SQL)sp_add_agent_profile (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Crée un nouveau profil pour un Agent de réplication.Creates a new profile for a replication agent. Cette procédure stockée est exécutée sur n’importe quelle base de données du serveur de distribution.This stored procedure is executed at the Distributor on any database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
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 ]  

ArgumentsArguments

[ @profile_id = ] profile_idID associé au profil nouvellement inséré.[ @profile_id = ] profile_id Is the ID associated with the newly inserted profile. l’argument de l’argument est de type int et est un paramètre de sortie facultatif.profile_id is int and is an optional OUTPUT parameter. Si vous l'indiquez, la valeur définie est égale au numéro d'identification du nouveau profil.If specified, the value is set to the new profile ID.

[ @profile_name = ] 'profile_name'Nom du profil.[ @profile_name = ] 'profile_name' Is the name of the profile. profile_name est de type sysname, sans valeur par défaut.profile_name is sysname, with no default.

[ @agent_type = ] 'agent_type'Type d’agent de réplication.[ @agent_type = ] 'agent_type' Is the type of replication agent. agent_type est de type int, sans valeur par défaut, et peut prendre l’une des valeurs suivantes.agent_type is int, with no default, and can be one of these values.

ValueValue DescriptionDescription
11 Agent d'instantanéSnapshot Agent
22 l'Agent de lecture du journal ;Log Reader Agent
33 Agent de distributionDistribution Agent
44 Agent de fusionMerge Agent
99 Agent de lecture de la file d'attenteQueue Reader Agent

[ @profile_type = ] profile_typeType de profil. profile_type est de type int, avec 1comme valeur par défaut.[ @profile_type = ] profile_type Is the type of profile.profile_type is int, with a default of 1.

0 indique un profil système.0 indicates a system profile. 1 indique un profil personnalisé.1 indicates a custom profile. Seuls les profils personnalisés peuvent être créés à l’aide de cette procédure stockée. par conséquent, la seule valeur valide est 1.Only custom profiles can be created using this stored procedure; therefore the only valid value is 1. Crée MicrosoftMicrosoft uniquementSQL ServerSQL Server des profils système.Only MicrosoftMicrosoft SQL ServerSQL Server creates system profiles.

[ @description = ] 'description'Description du profil.[ @description = ] 'description' Is a description of the profile. Description est de type nvarchar (3000) , sans valeur par défaut.description is nvarchar(3000), with no default.

[ @default = ] defaultIndique si le profil est la valeur par défaut pour *agent_type * .[ @default = ] default Indicates whether the profile is the default for agent_type**. la valeur par défaut est bit, avec 0comme valeur par défaut.default is bit, with a default of 0. 1 indique que le profil ajouté deviendra le nouveau profil par défaut pour l’agent spécifié par agent_type.1 indicates that the profile being added will become the new default profile for the agent specified by agent_type.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_add_agent_profile est utilisé dans la réplication d’instantané, la réplication transactionnelle et la réplication de fusion.sp_add_agent_profile is used in snapshot replication, transactional replication, and merge replication.

Les profils d'agent personnalisés sont ajoutés avec les valeurs par défaut.Custom agent profiles are added with the default agent parameter values. Utilisez sp_change_agent_parameter (Transact-SQL) pour modifier ces valeurs par défaut ou (sp_add_agent_parameter Transact-) SQL pour ajouter des paramètres supplémentaires.Use sp_change_agent_parameter (Transact-SQL) to change these default values or sp_add_agent_parameter (Transact-SQL) to add additional parameters.

Quand sp_add_agent_profile est exécuté, une ligne est ajoutée pour le nouveau profil personnalisé dans la table (Transact-SQL) de MSagent_profiles et les paramètres par défaut associés pour ce profil sont ajoutés à la table MSagent_parameters. Table Transact-SQL) (When sp_add_agent_profile is executed, a row is added for the new custom profile in the MSagent_profiles (Transact-SQL) table and the associated default parameters for this profile are added to the MSagent_parameters (Transact-SQL) table.

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_add_agent_profile.Only members of the sysadmin fixed server role can execute sp_add_agent_profile.

Voir aussiSee Also

Utiliser des profils d’Agent de réplication Work with Replication Agent Profiles
Profils de l’Agent de réplication Replication Agent Profiles
sp_add_agent_parameter (Transact-SQL) sp_add_agent_parameter (Transact-SQL)
sp_change_agent_parameter (Transact-SQL) sp_change_agent_parameter (Transact-SQL)
sp_change_agent_profile (Transact-SQL) sp_change_agent_profile (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL) sp_drop_agent_parameter (Transact-SQL)
sp_drop_agent_profile (Transact-SQL) sp_drop_agent_profile (Transact-SQL)
sp_help_agent_parameter (Transact-SQL) sp_help_agent_parameter (Transact-SQL)
sp_help_agent_profile (Transact-SQL)sp_help_agent_profile (Transact-SQL)