sp_droprolemember (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Supprime un compte de sécurité d'un rôle SQL Server dans la base de données actuelle.

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez à la place ALTER ROLE .

Conventions de la syntaxe Transact-SQL

Syntaxe

Syntaxe pour SQL Server et Azure SQL Edge :

sp_droprolemember
    [ @rolename = ] N'rolename'
    , [ @membername = ] N'membername'
[ ; ]

Syntaxe pour Azure Synapse Analytics et Parallel Data Warehouse :

sp_droprolemember N'rolename', 'membername'
[ ; ]

Remarque

Cette syntaxe n’est pas prise en charge par le pool SQL serverless dans Azure Synapse Analytics.

Arguments

[ @rolename = ] N’rolename'

Nom du rôle à partir duquel le membre est supprimé. @rolename est sysname, sans valeur par défaut. @rolename doit exister dans la base de données active.

[ @membername = ] N’membername'

Nom du compte de sécurité supprimé du rôle. @membername est sysname, sans valeur par défaut. @membername peut être un utilisateur de base de données, un autre rôle de base de données, un compte Windows ou un groupe Windows. @membername doit exister dans la base de données active.

Valeurs des codes de retour

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

Notes

sp_droprolemember supprime un membre d’un rôle de base de données en supprimant une ligne de la sysmembers table. Lorsqu’un membre est supprimé d’un rôle, le membre perd toutes les autorisations qu’il dispose de l’appartenance à ce rôle.

Pour supprimer un utilisateur d’un rôle serveur fixe, utilisez sp_dropsrvrolemember. Les utilisateurs ne peuvent pas être supprimés du rôle public, et dbo ne peut pas être supprimé d’un rôle.

Permet sp_helpuser de voir les membres d’un rôle SQL Server et d’utiliser ALTER ROLE pour ajouter un membre à un rôle.

Autorisations

Nécessite ALTER l’autorisation sur le rôle.

Exemples

Le code exemple suivant supprime l'utilisateur JonB dans le rôle Sales.

EXEC sp_droprolemember 'Sales', 'Jonb';

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

Le code exemple suivant supprime l'utilisateur JonB dans le rôle Sales.

EXEC sp_droprolemember 'Sales', 'JonB'

Contenu connexe