Share via


sp_addrolemember (Transact-SQL)

Aggiunge un utente del database, un ruolo del database, un account di accesso di Windows o un gruppo di Windows a un ruolo del database nel database corrente.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sp_addrolemember [ @rolename = ] 'role',
    [ @membername = ] 'security_account'

Argomenti

  • [ @rolename= ] 'role'
    Nome del ruolo del database nel database corrente. role è di tipo sysname e non prevede alcun valore predefinito.

  • [ @membername= ] 'security_account'
    Account di sicurezza aggiunto al ruolo. security_account è di tipo sysname e non prevede alcun valore predefinito. security_account può essere un utente del database, un ruolo del database, un account di accesso di Windows oppure un gruppo di Windows.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

Un membro aggiunto al ruolo tramite sp_addrolemember eredita le autorizzazioni del ruolo. Se il nuovo membro è un'entità a livello di Windows senza un corrispondente utente del database, verrà creato un utente del database, che tuttavia potrebbe non essere mappato completamente all'account di accesso. Verificare sempre che l'account di accesso esista e che sia in grado di accedere al database.

Un ruolo non può includere sé stesso come membro. Tali definizioni "circolari" non sono valide anche quando l'appartenenza è indirettamente sottintesa da una o più appartenenze intermedie.

sp_addrolemember non è in grado di aggiungere un ruolo predefinito del database, un ruolo predefinito del server o dbo a un ruolo. sp_addrolemember non può inoltre essere eseguita all'interno di una transazione definita dall'utente.

Utilizzare sp_addrolemember solo per aggiungere un membro a un ruolo del database. Per aggiungere un membro a un ruolo del server, utilizzare sp_addsrvrolemember (Transact-SQL).

Autorizzazioni

Per l'aggiunta di membri ai ruoli del database definiti dall'utente è necessario uno degli elementi seguenti:

  • Appartenenza al ruolo predefinito del database db_securityadmin o db_owner.

  • Appartenenza al ruolo proprietario del ruolo.

  • Autorizzazione ALTER ANY ROLE o ALTER sul ruolo.

Per l'aggiunta di membri ai ruoli predefiniti del database è richiesta l'appartenenza al ruolo predefinito del database db_owner.

Esempi

A. Aggiunta di un account di accesso di Windows

Nell'esempio seguente l'account di accesso di Windows Contoso\Mary5 viene aggiunto al database AdventureWorks2008R2 come utente Mary5. L'utente Mary5 viene quindi aggiunto al ruolo Production.

Nota

Poiché Contoso\Mary5 è noto come utente del database Mary5 nel database AdventureWorks2008R2, è necessario specificare il nome utente Mary5. L'istruzione non verrà eseguita correttamente se non esiste un account di accesso Contoso\Mary5. Eseguire un test mediante un account di accesso dal dominio.

USE AdventureWorks2008R2;
GO
CREATE USER Mary5 FOR LOGIN [Contoso\Mary5] ;
GO
EXEC sp_addrolemember 'Production', 'Mary5'

B. Aggiunta di un utente del database

Nell'esempio seguente l'utente del database Mary5 viene aggiunto al ruolo del database Production nel database corrente.

EXEC sp_addrolemember 'Production', 'Mary5'