sp_repldropcolumn (Transact-SQL)

S’applique à : SQL Server (toutes les versions prises en charge) Azure SQL Managed Instance

Supprime une colonne d'un article de table existant publié. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.

Important

Cette procédure stockée est déconseillée ; elle est essentiellement prise en charge pour des raisons de compatibilité descendante. Il ne doit être utilisé qu’avec Microsoft SQL Server 2000 (8.x) Publishers et SQL Server 2000 (8.x) republiant des Abonnés. Cette procédure ne doit pas être utilisée sur les colonnes avec des types de données introduits dans SQL Server 2005 (9,x) ou une version ultérieure.

Topic link iconConventions de la syntaxe Transact-SQL

Syntaxe

  
sp_repldropcolumn [ @source_object = ] 'source_object', [ @column = ] 'column'   
    [ , [ @from_agent = ] from_agent]   
    [ , [ @schema_change_script = ] 'schema_change_script' ]   
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]   
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]   

Arguments

[ @source_object = ] 'source_object'
Nom de l'article de table contenant la nouvelle colonne à supprimer. source_object est nvarchar(258), sans valeur par défaut.

[ @column = ] 'column'
Nom de la colonne dans la table à supprimer. la colonne est sysname, sans valeur par défaut.

[ @from_agent = ] from_agent
Indique si la procédure stockée est exécutée par un agent de réplication. from_agent est int, avec une valeur par défaut de 0, 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 de 0 doit être utilisée.

[ @schema_change_script = ] 'schema_change_script'
Spécifie le nom et le chemin d’accès d’un script SQL Server utilisé pour modifier les procédures stockées personnalisées générées par le système. schema_change_script est nvarchar(4000), avec la valeur par défaut 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. schema_change_script est exécuté une fois qu’une modification de schéma est apportée à un article de table répliqué à l’aide de sp_repldropcolumn et peut être utilisée pour effectuer l’une des opérations suivantes :

  • Si des procédures stockées personnalisées sont automatiquement régénérées, schema_change_script pouvez les utiliser 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.

  • Si les procédures stockées personnalisées ne sont pas régénérées automatiquement, schema_change_scriptpouvez ê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.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Active ou désactive la possibilité d'invalider un instantané. force_invalidate_snapshot est un peu, avec une valeur par défaut de 1.

1 spécifie que les modifications de l'article peuvent invalider l'instantané et dans ce cas, la valeur 1 autorise la réalisation du nouvel instantané.

0 spécifie que les modifications de l'article n'invalident pas l'instantané.

[ @force_reinit_subscription = ] force_reinit_subscription
Active ou désactive la possibilité de réinitialiser l'abonnement. force_reinit_subscription est un peu avec une valeur par défaut de 0.

0 spécifie que les modifications de l'article ne provoquent pas la réinitialisation de l'abonnement.

1 spécifie que les modifications de l'article peuvent provoquer la réinitialisation de l'abonnement et dans ce cas, la valeur 1 autorise cette réinitialisation.

Codet de retour

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

Autorisations

Seuls les membres du rôle serveur fixe sysadmin sur le serveur de publication ou les membres des rôles de base de données fixes db_owner ou db_ddladmin de la base de données de publication peuvent exécuter sp_repldropcolumn.

Voir aussi

Fonctionnalités dépréciées dans la réplication SQL Server
Procédures stockées système (Transact-SQL)