Freigeben über

  • Artikel

IS_MEMBER (Transact-SQL)

Zeigt an, ob der aktuelle Benutzer ein Mitglied der angegebenen Microsoft Windows-Gruppe oder SQL Server-Datenbankrolle ist.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

IS_MEMBER ( { 'group' | 'role' } )

Argumente

  • 'group'
    Der Name der Windows-Gruppe, die überprüft wird. Dieser muss das Format Domäne\Gruppe aufweisen. group ist ein Wert vom Datentyp sysname.

  • 'role'
    Der Name der SQL Server-Rolle, die überprüft wird. role ist ein Wert vom Datentyp sysname. Er kann feste Datenbankrollen oder benutzerdefinierte Rollen, nicht jedoch Serverrollen einschließen.

Rückgabetypen

int

Hinweise

IS_MEMBER gibt folgende Werte zurück.

Rückgabewert

Beschreibung

0

Der aktuelle Benutzer ist kein Mitglied von group oder role.

1

Der aktuelle Benutzer ist Mitglied von group oder role.

NULL

Entweder ist group oder role ungültig. Bei Abfrage durch eine SQL Server-Anmeldung oder eine Anmeldung, die eine Anwendungsrolle verwendet, wird NULL für eine Windows-Gruppe zurückgegeben.

IS_MEMBER bestimmt die Windows-Gruppenmitgliedschaft durch Analysieren eines Zugriffstokens, das von Windows erstellt wird. Das Zugriffstoken spiegelt keine Änderungen an der Gruppenmitgliedschaft wider, die vorgenommen werden, nachdem ein Benutzer eine Verbindung mit einer Instanz von SQL Server hergestellt hat. Die Windows-Gruppenmitgliedschaft kann nicht von einer SQL Server-Anmeldung oder einer SQL Server-Anwendungsrolle abgefragt werden.

Diese Funktion wertet die Rollenmitgliedschaft aus, nicht die zugrunde liegende Berechtigung. Die feste Datenbankrolle db_owner besitzt z. B. die CONTROL DATABASE-Berechtigung. Wenn der Benutzer die CONTROL DATABASE-Berechtigung besitzt, aber nicht Mitglied der Rolle ist, meldet diese Funktion ordnungsgemäß, dass der Benutzer nicht Mitglied der db_owner-Rolle ist, obwohl der Benutzer dieselben Berechtigungen besitzt.

Beispiele

Im folgenden Beispiel wird überprüft, ob der aktuelle Benutzer ein Mitglied einer Datenbankrolle oder einer Windows-Domänengruppe ist.

-- Test membership in db_owner and print appropriate message.
IF IS_MEMBER ('db_owner') = 1
   PRINT 'Current user is a member of the db_owner role'
ELSE IF IS_MEMBER ('db_owner') = 0
   PRINT 'Current user is NOT a member of the db_owner role'
ELSE IF IS_MEMBER ('db_owner') IS NULL
   PRINT 'ERROR: Invalid group / role specified'
GO

-- Execute SELECT if user is a member of ADVWORKS\Shipping.
IF IS_MEMBER ('ADVWORKS\Shipping') = 1
   SELECT 'User ' + USER + ' is a member of ADVWORKS\Shipping.' 
GO