sp_add_agent_profile (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL Managed Instance

Crée un nouveau profil pour un Agent de réplication. Cette procédure stockée est exécutée sur le serveur de distribution sur n’importe quelle base de données.

Conventions de la syntaxe Transact-SQL

Syntaxe

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 ]

Arguments

[ @profile_id = ] profile_id

ID associé au profil nouvellement inséré. @profile_id est int et est un paramètre OUTPUT facultatif. Si vous l'indiquez, la valeur définie est égale au numéro d'identification du nouveau profil.

[ @profile_name = ] 'profile_name'

Nom du profil. @profile_name est sysname, sans valeur par défaut.

[ @agent_type = ] agent_type

Type d’agent de réplication. @agent_type est int, sans valeur par défaut, et peut être l’une de ces valeurs.

Valeur Description
1 Agent d'instantané
2 l'Agent de lecture du journal ;
3 Agent de distribution
4 Agent de fusion
9 Agent de lecture de la file d'attente

[ @profile_type = ] profile_type

Type de profil. profile_type est int, avec la valeur par défaut 1.

0 indique un profil système. 1 indique un profil personnalisé. 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. Seul SQL Server crée des profils système.

[ @description = ] N’description'

Description du profil. @description est nvarchar(3000), sans valeur par défaut.

[ @default = ] par défaut

Indique si le profil est la valeur par défaut pour @agent_type. @default est bit, avec la valeur par défaut 0. 1 indique que le profil ajouté deviendra le nouveau profil par défaut de l’agent spécifié par @agent_type.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

sp_add_agent_profileest utilisé dans instantané réplication, la réplication transactionnelle et la réplication de fusion.

Les profils d'agent personnalisés sont ajoutés avec les valeurs par défaut. 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.

Lorsqu’elle sp_add_agent_profile est exécutée, une ligne est ajoutée pour le nouveau profil personnalisé dans la table MSagent_profiles (Transact-SQL) et les paramètres par défaut associés pour ce profil sont ajoutés à la table MSagent_parameters (Transact-SQL).

Autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent s’exécuter.sp_add_agent_profile

Contenu connexe