sp_repladdcolumn (Transact-SQL)sp_repladdcolumn (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

Ajoute une colonne à un article de table existant qui a été publié.Adds a column to an existing table article that has been published. Permet d'ajouter la nouvelle colonne à tous les serveurs de publication, ou à une publication spécifique, qui publient cette table.Allows the new column to be added to all publishers that publish this table, or just add the column to a specific publication that publishes the table. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database.

Important

Cette procédure stockée est déconseillée ; elle est prise en charge pour des raisons de compatibilité descendante.This stored procedure has been deprecated and is being supported for backward-compatibility. Elle doit être utilisée uniquement avec MicrosoftMicrosoft les serveurs SQL Server 2000 (8.x)SQL Server 2000 (8.x) de SQL Server 2000 (8.x)SQL Server 2000 (8.x) publication et les abonnés de republication.It should only be used with MicrosoftMicrosoftSQL Server 2000 (8.x)SQL Server 2000 (8.x) Publishers and SQL Server 2000 (8.x)SQL Server 2000 (8.x) republishing Subscribers. Cette procédure ne doit pas être utilisée sur des colonnes avec des types de données qui ont été introduits dans SQL Server 2005 (9.x)SQL Server 2005 (9.x) ou ultérieur.This procedure should not be used on columns with data types that were introduced in SQL Server 2005 (9.x)SQL Server 2005 (9.x) or higher.

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

SyntaxeSyntax

  
sp_repladdcolumn [ @source_object = ] 'source_object', [ @column = ] 'column' ]  
    [ , [ @typetext = ] 'typetext' ]  
    [ , [ @publication_to_add = ] 'publication_to_add' ]  
    [ , [ @from_agent = ] from_agent ]  
    [ , [ @schema_change_script = ] 'schema_change_script' ]  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  

ArgumentsArguments

[ @source_object =] 'source_object'[ @source_object =] 'source_object'
Nom de l'article de table contenant la nouvelle colonne à ajouter.Is the name of the table article that contains the new column to add. source_object est de type nvarchar (358), sans valeur par défaut.source_object is nvarchar(358), with no default.

[ @column =] 'colonne'[ @column =] 'column'
Nom de la colonne dans la table à ajouter pour la réplication.Is the name of the column in the table to be added for replication. Column est de type sysname, sans valeur par défaut.column is sysname, with no default.

[ @typetext =] 'TypeText'[ @typetext =] 'typetext'
Définition de la colonne ajoutée.Is the definition of the column being added. TypeText est de type nvarchar (3000) , sans valeur par défaut.typetext is nvarchar(3000), with no default. Par exemple, si la colonne order_filled est ajoutée et qu’il s’agit d’un champ à un seul caractère, et non NULL, et a une valeur par défaut de N, order_filled est le paramètre de colonne , alors que la définition de la colonne, char (1) n’est pas une contrainte null la valeur par défaut de constraint_name’N' est la valeur du paramètre TypeText .For example, if the column order_filled is being added, and it is a single character field, not NULL, and has a default value of N, order_filled would be the column parameter, while the definition of the column, char(1) NOT NULL CONSTRAINT constraint_name DEFAULT 'N' would be the typetext parameter value.

[ @publication_to_add =] 'publication_to_add'[ @publication_to_add =] 'publication_to_add'
Nom de la publication à laquelle la nouvelle colonne est ajoutée.Is the name of the publication to which the new column is added. publication_to_add est de type nvarchar (4000) , avec Allcomme valeur par défaut.publication_to_add is nvarchar(4000), with a default of ALL. Si la totalitéest, toutes les publications contenant cette table sont affectées.If ALL, then all publications containing this table are affected. Si publication_to_add est spécifié, seule la nouvelle colonne est ajoutée à cette publication.If publication_to_add is specified, then only this publication has the new column added.

[ @from_agent =] from_agent[ @from_agent = ] from_agent
Indique si la procédure stockée est exécutée par un agent de réplication.If the stored procedure is being executed by a replication agent. from_agent est de type int, avec 0comme valeur par défaut, où la valeur 1 est utilisée lorsque cette procédure stockée est exécutée par un agent de réplication, et dans tous les autres cas, la valeur par défaut 0doit être utilisée.from_agent is int, with a default of 0, where a value of 1 is used when this stored procedure is being executed by a replication agent, and in every other case the default value of 0should be used.

[ @schema_change_script =] 'schema_change_script'[ @schema_change_script =] 'schema_change_script'
Spécifie le nom et le chemin d'accès d'un script SQL ServerSQL Server utilisé pour modifier les procédures stockées personnalisées générées par le système.Specifies the name and path of a SQL ServerSQL Server script used to modify the system generated custom stored procedures. schema_change_script est de type nvarchar (4000) , avec NULL comme valeur par défaut.schema_change_script is nvarchar(4000), with a default of NULL. La réplication permet aux procédures stockées personnalisées définies par l'utilisateur de remplacer une ou plusieurs procédures par défaut utilisées dans la réplication transactionnelle.Replication allows user-defined custom stored procedures to replace one or more of the default procedures used in transactional replication. schema_change_script est exécuté après une modification de schéma dans un article de table répliqué à l’aide de sp_repladdcolumn, et peut être utilisé pour effectuer l’une des opérations suivantes:schema_change_script is executed after a schema change is made to a replicated table article using sp_repladdcolumn, and can be used to do one of the following:

  • Si des procédures stockées personnalisées sont automatiquement régénérées, schema_change_script peut être utilisé pour supprimer ces procédures stockées personnalisées et les remplacer par des procédures stockées personnalisées définies par l’utilisateur qui prennent en charge le nouveau schéma.If custom stored procedures are automatically regenerated, schema_change_script can be used to drop these custom stored procedures and replace them with user-defined custom stored procedures that supports the new schema.

  • Si les procédures stockées personnalisées ne sont pas automatiquement régénérées, schema_change_scriptpeut être utilisé pour régénérer ces procédures stockées ou pour créer des procédures stockées personnalisées définies par l’utilisateur.If custom stored procedures are not automatically regenerated, schema_change_scriptcan be used to regenerate these stored procedures or to create user-defined custom stored procedures.

[ @force_invalidate_snapshot =] force_invalidate_snapshot[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Active ou désactive la possibilité d'invalider un instantané.Enables or disables the ability to have a snapshot invalidated. force_invalidate_snapshot est un bit, avec 1comme valeur par défaut.force_invalidate_snapshot is a bit, with a default of 1.

1 indique que les modifications apportées à l’article peuvent entraîner la non-validité de l’instantané. Si tel est le cas, la valeur 1 accorde l’autorisation de se produire pour le nouvel instantané.1 specifies that changes to the article may cause the snapshot to be invalid, and if that is the case, a value of 1 gives permission for the new snapshot to occur.

0 indique que les modifications apportées à l’article n’entraînent pas la non-validité de l’instantané.0 specifies that changes to the article do not cause the snapshot to be invalid.

[ @force_reinit_subscription =] force_reinit_subscription[ @force_reinit_subscription = ] force_reinit_subscription
Active ou désactive la possibilité de réinitialiser l'abonnement.Enables or disables the ability to have the subscription reinitializated. force_reinit_subscription est un bit avec 0comme valeur par défaut.force_reinit_subscription is a bit with a default of 0.

0 indique que les modifications apportées à l’article n’entraînent pas la réinitialisation de l’abonnement.0 specifies that changes to the article do not cause the subscription to be reinitialized.

1 indique que les modifications apportées à l’article peuvent provoquer la réinitialisation de l’abonnement. Si tel est le cas, la valeur 1 accorde l’autorisation de réinitialisation de l’abonnement.1 specifies that changes to the article may cause the subscription to be reinitialized, and if that is the case, a value of 1 gives permission for the subscription reinitialization to occur.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin et du rôle de base de données fixe db_owner peuvent exécuter sp_repladdcolumn.Only members of the sysadmin fixed server role and the db_owner fixed database role can execute sp_repladdcolumn.

Voir aussiSee Also

Fonctionnalités dépréciées dans Réplication SQL Server Deprecated Features in SQL Server Replication
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)