sp_droprolemember (Transact-SQL)

Si applica a:SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di sistemi analitici (PDW)

Rimuove un account di sicurezza da un ruolo di SQL Server nel database corrente.

Importante

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. In alternativa, usare ALTER ROLE .

Convenzioni di sintassi Transact-SQL

Sintassi

Sintassi per SQL Server e SQL Edge di Azure:

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

Sintassi per Azure Synapse Analytics e Parallel Data Warehouse:

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

Nota

Questa sintassi non è supportata da pool SQL serverless in Azure Synapse Analytics.

Argomenti

[ @rolename = ] N'rolename'

Nome del ruolo da cui viene rimosso il membro. @rolename è sysname, senza impostazione predefinita. @rolename deve esistere nel database corrente.

[ @membername = ] N'membername'

Nome dell'account di sicurezza rimosso dal ruolo. @membername è sysname, senza impostazione predefinita. @membername può essere un utente del database, un altro ruolo del database, un account di Windows o un gruppo di Windows. @membername deve esistere nel database corrente.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_droprolemember rimuove un membro da un ruolo del database eliminando una riga dalla sysmembers tabella. Quando un membro viene rimosso da un ruolo, il membro perde le autorizzazioni di appartenenza a tale ruolo.

Per rimuovere un utente da un ruolo predefinito del server, usare sp_dropsrvrolemember. Gli utenti non possono essere rimossi dal ruolo pubblico e dbo non può essere rimosso da alcun ruolo.

Usare sp_helpuser per visualizzare i membri di un ruolo di SQL Server e usare ALTER ROLE per aggiungere un membro a un ruolo.

Autorizzazioni

È richiesta ALTER l'autorizzazione per il ruolo.

Esempi

Nell'esempio seguente l'utente JonB viene rimosso dal ruolo Sales.

EXEC sp_droprolemember 'Sales', 'Jonb';

Esempi: Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW)

Nell'esempio seguente l'utente JonB viene rimosso dal ruolo Sales.

EXEC sp_droprolemember 'Sales', 'JonB'