sp_repldropcolumn (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @source_object = ] N’source_object'

Nom de l’article de table qui contient la colonne à supprimer. @source_object est nvarchar(270), sans valeur par défaut.

[ @column = ] N’column'

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

[ @from_agent = ] from_agent

Spécifie si la procédure stockée est exécutée par un agent de réplication. @from_agent est int, avec la valeur par défaut 0.

Utilisez 1 cette procédure stockée lorsque cette procédure stockée est exécutée par un agent de réplication, sinon utilisez la valeur par défaut de 0.

[ @schema_change_script = ] N’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ée une fois qu’une modification de schéma est apportée à un article de table répliqué à l’aide sp_repldropcolumnde l’une des options suivantes :

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

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

Active ou désactive la possibilité d'invalider un instantané. @force_invalidate_instantané est bit, avec la valeur par défaut 1.

• 1spécifie que les modifications apportées à l’article peuvent entraîner l’instantané non valide et, si c’est le cas, une valeur de 1 donner l’autorisation pour la nouvelle instantané se produise.

• 0spécifie que les modifications apportées à l’article n’entraînent pas l’instantané non valide.

[ @force_reinit_subscription = ] force_reinit_subscription

Active ou désactive la possibilité de réinitialiser l’abonnement. @force_reinit_subscription est bit, avec la valeur par défaut 0.

• 0 spécifie que les modifications apportées à l’article n’entraînent pas la réinitialisation de l’abonnement.

• 1 spécifie que les modifications apportées à l’article peuvent entraîner la réinitialisation de l’abonnement et, si c’est le cas, une valeur d’autorisation de réinitialisation de 1 l’abonnement se produit.

Valeurs des codes 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 du db_owner ou db_ddladmin rôles de base de données fixes sur la base de données de publication peuvent s’exécuter sp_repldropcolumn.

Contenu connexe

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