IS_MEMBER (Transact-SQL)
適用於： 
SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)
指出目前使用者是否為指定Microsoft Windows 群組、Microsoft Entra 群組或 SQL Server 資料庫角色的成員。
Microsoft Entra 群組支援IS_MEMBER函式。 如果群組是 SQL 實例Microsoft Entra 系統管理員，則IS_MEMBER無法運作的其中一個案例。
注意
Microsoft Entra ID 先前稱為 Azure Active Directory (Azure AD)。
語法
IS_MEMBER ( { 'group' | 'role' } )
引數
' group '
適用於：SQL Server 2008 (10.0.x) 和更新版本
這是正在檢查之 Windows 或 Microsoft Entra 群組的名稱。 Windows 群組的格式必須是網域\群組。 group 為 sysname。
' role '
這是要檢查的 SQL Server 角色名稱。 role 為 sysname，而且可以包含資料庫固定角色或使用者定義角色，但無法包含伺服器角色。
傳回型別
int
備註
IS_MEMBER 會傳回下列值。
| 傳回值 | 描述 |
|---|---|
| 0 | 目前使用者不是群組或角色的成員。 |
| 1 | 目前使用者是 group 或 role 的成員。 |
| NULL | 群組或角色無效。 由 SQL Server 登入或使用應用程式角色的登入進行查詢時，針對 Windows 群組傳回 NULL。 |
IS_MEMBER 會檢查 Windows 所建立的存取 Token 來判斷 Windows 群組成員資格。 存取令牌不會反映用戶在連線到 SQL Server 實例之後所做的群組成員資格變更。 SQL Server 登入或 SQL Server 應用程式角色無法查詢 Windows 群組成員資格。
若要從資料庫角色中新增及移除成員，請使用 ALTER ROLE (Transact-SQL) (部分機器翻譯)。 若要從伺服器角色中新增及移除成員，請使用 ALTER SERVER ROLE (Transact-SQL) (部分機器翻譯)。
這個函數會評估角色成員資格，而非基礎權限。 例如，db_owner 固定資料庫角色具有 CONTROL DATABASE 權限。 如果使用者具有 CONTROL DATABASE 許可權，但不是角色的成員，則此函式會正確地報告使用者不是db_owner角色的成員，即使使用者擁有相同的許可權也一樣。
sysadmin 固定伺服器角色的成員會作為 dbo 使用者輸入每個資料庫。 若要檢查 sysadmin 固定伺服器角色成員的權限，請檢查 dbo 的權限，而非原始登入。 因為 dbo 無法新增至資料庫角色，而且不存在於 Windows 群組中， dbo 一律會傳回 0 （如果角色不存在，則為 NULL）。
相關函數
若要判斷另一個 SQL Server 登入是否為資料庫角色的成員，請使用 IS_ROLEMEMBER (Transact-SQL) (部分機器翻譯)。 若要判斷某個 SQL Server 登入是否為伺服器角色的成員，請使用 IS_SRVROLEMEMBER (Transact-SQL) (部分機器翻譯)。
範例
下列範例會檢查目前使用者是資料庫角色或 Windows 網域群組的成員。
-- 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
另請參閱
IS_SRVROLEMEMBER (Transact-SQL)
主體 (資料庫引擎)
安全性目錄檢視 (Transact-SQL)
安全性函數 (Transact-SQL)