sp_helpgroup (Transact-SQL)
Restituisce informazioni su un ruolo, o su tutti i ruoli, nel database corrente.
.gif "ms188925.note(it-it,SQL.90).gif") Importante: |
|---|
| sp_helpgroup è compatibile con le versioni precedenti di SQL Server. Questa funzionalità verrà rimossa a partire dalla prossima versione di Microsoft SQL Server. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Utilizzare la vista del catalogo sys.database_principals in alternativa. |
.gif "Icona di collegamento a un argomento")
Convenzioni della sintassi Transact-SQL
Sintassi
sp_helpgroup [ [ @grpname = ] 'role' ]
Argomenti
- [ @grpname = ] 'role'
Nome di un ruolo. role deve essere un ruolo esistente nel database corrente. role è di tipo sysname e il valore predefinito è NULL. Se role viene omesso, vengono restituite le informazioni sul nome e sui membri del ruolo. In caso contrario, vengono restituite le informazioni su tutti i ruoli nel database corrente.
Set di risultati
Se role viene omesso, le informazioni seguenti verranno restituite per tutti i ruoli.
| Nome colonna | Tipo di dati | Descrizione |
|---|---|---|
group_name |
sysname |
Nome del ruolo nel database corrente. |
group_id |
smallint |
ID del ruolo nel database corrente. |
Se role viene specificato, verranno restituite le informazioni seguenti.
| Nome colonna | Tipo di dati | Descrizione |
|---|---|---|
group_name |
sysname |
Nome del ruolo nel database corrente. |
group_id |
smallint |
ID del ruolo nel database corrente. |
users_in_group |
sysname |
Membro del ruolo nel database corrente. |
userid |
smallint |
ID utente del membro del ruolo. |
Osservazioni
Per visualizzare la autorizzazioni associate a un ruolo, utilizzare sp_helprotect.
Autorizzazioni
È richiesta l'appartenenza al ruolo public.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempi
A. Restituzione di informazioni su un singolo ruolo
La query seguente restituisce le informazioni relative al ruolo SammamishShippers.
EXEC sp_helpgroup 'SammamishShippers'
B. Restituzione di informazioni su tutti i ruoli
Nell'esempio seguente vengono restituite informazioni su tutti i ruoli nel database corrente.
EXEC sp_helpgroup
Vedere anche
Riferimento
Stored procedure del Motore di database (Transact-SQL)
sys.database_principals (Transact-SQL)
sp_helprotect (Transact-SQL)
sp_helprole (Transact-SQL)
sp_helpuser (Transact-SQL)
Stored procedure di sistema (Transact-SQL)