sp_droprolemember (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Quita una cuenta de seguridad de un rol de SQL Server de la base de datos actual.

Importante

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Use ALTER ROLE en su lugar.

Convenciones de sintaxis de Transact-SQL

Sintaxis

Sintaxis para SQL Server y Azure SQL Edge:

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

Sintaxis para Azure Synapse Analytics y Almacenamiento de datos en paralelo:

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

Nota:

El grupo de SQL sin servidor no admite esta sintaxis en Azure Synapse Analytics.

Argumentos

[ @rolename = ] N'rolename'

Nombre del rol del que se va a quitar el miembro. @rolename es sysname, sin ningún valor predeterminado. @rolename deben existir en la base de datos actual.

[ @membername = ] N'membername'

Nombre de la cuenta de seguridad que se va a quitar del rol. @membername es sysname, sin ningún valor predeterminado. @membername puede ser un usuario de base de datos, otro rol de base de datos, una cuenta de Windows o un grupo de Windows. @membername debe existir en la base de datos actual.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_droprolemember quita un miembro de un rol de base de datos eliminando una fila de la sysmembers tabla. Cuando se quita un miembro de un rol, el miembro pierde los permisos que tiene al pertenecer a ese rol.

Para quitar un usuario de un rol fijo de servidor, use sp_dropsrvrolemember. Los usuarios no se pueden quitar del rol público y dbo no se puede quitar de ningún rol.

Use sp_helpuser para ver los miembros de un rol de SQL Server y use ALTER ROLE para agregar un miembro a un rol.

Permisos

Requiere ALTER permiso para el rol.

Ejemplos

En este ejemplo se quita al usuario JonB del rol Sales.

EXEC sp_droprolemember 'Sales', 'Jonb';

Ejemplos: Azure Synapse Analytics y Sistema de la plataforma de análisis (PDW)

En este ejemplo se quita al usuario JonB del rol Sales.

EXEC sp_droprolemember 'Sales', 'JonB'

Contenido relacionado