HAS_PERMS_BY_NAME (Transact-SQL)

發行項
06/18/2013

評估安全性實體上目前使用者的有效權限。相關的函數是 fn_my_permissions。

語法

HAS_PERMS_BY_NAME ( securable , securable_class , permission  
    [ , sub-securable ] [ , sub-securable_class ] )

引數

securable
這是安全性實體的名稱。如果安全性實體是伺服器本身，這個值應該設為 NULL。 securable 是 sysname 類型的純量運算式。沒有預設值。
securable_class
這是用來測試權限之安全性實體的類別名稱。 securable_class 是 nvarchar(60) 類型的純量運算式。
permission
sysname 類型的非 Null 純量運算式，代表要檢查的權限名稱。沒有預設值。權限名稱 ANY 是萬用字元。
sub-securable
sysname 類型的選擇性純量運算式，代表用來測試權限之安全性實體的子實體名稱。預設值是 NULL。

[!附註]

從 SQL Server 到 SQL Server 2012 的版本中，子安全性實體不能使用 '[sub name]' 格式的括號。請改用 'sub name'。
sub-securable_class
nvarchar(60) 類型的選擇性純量運算式，代表用來測試權限的安全性實體之子實體的類別。預設值是 NULL。

傳回類型

int

如果查詢失敗，則傳回 NULL。

備註

這個內建函數會測試目前主體對於指定的安全性實體是否有特定有效權限。當使用者對於安全性實體具有有效權限時，HAS_PERMS_BY_NAME 會傳回 1；當使用者對於安全性實體沒有任何有效權限，則傳回 0；當安全性實體類別或權限無效時，則傳回 NULL。有效權限為下列任何一項：

直接授與主體的權限，且不被拒絕。
由主體保留的較高層級權限所隱含的權限，且不被拒絕。
授與角色或群組的權限，主體為其成員之一，且不被拒絕。
角色或群組所保留的權限，主體為其成員之一，且不被拒絕。

權限評估一律在呼叫者的安全性內容中執行。若要決定另一位使用者是否具有有效權限，呼叫者對該使用者必須具有 IMPERSONATE 權限。

如果是結構描述層級實體，則接受一、二或三部分非 Null 名稱。如果是資料庫層級實體，則接受一部分名稱，Null 值則表示目前資料庫。如果是伺服器本身，則 Null 值 (表示「目前伺服器」) 是必要的。這個函數無法檢查連結伺服器的權限或尚未建立伺服器層級主體之 Windows 使用者的權限。

下列查詢將傳回內建安全性實體類別的清單：

   SELECT class_desc FROM sys.fn_builtin_permissions(default)

使用的定序如下：

目前資料庫定序：包含結構描述未包含之安全性實體的資料庫層級安全性實體；一或兩部分結構描述範圍的安全性實體；使用三部分名稱時的目標資料庫。
master 資料庫定序：伺服器層級安全性實體。
資料行層級檢查不支援 'ANY'。您必須指定適當的權限。

範例

A.我有伺服器層級 VIEW SERVER STATE 權限嗎？

SELECT HAS_PERMS_BY_NAME(null, null, 'VIEW SERVER STATE');

B.我可以模擬 (IMPERSONATE) 伺服器主體 Ps 嗎？

SELECT HAS_PERMS_BY_NAME('Ps', 'LOGIN', 'IMPERSONATE');

C.我在目前資料庫中有任何權限嗎？

SELECT HAS_PERMS_BY_NAME(db_name(), 'DATABASE', 'ANY');

D.資料庫主體 Pd 在目前資料庫中有任何權限嗎？

假設呼叫者有主體 Pd 的 IMPERSONATE 權限。

EXECUTE AS user = 'Pd'
GO
SELECT HAS_PERMS_BY_NAME(db_name(), 'DATABASE', 'ANY');
GO
REVERT;
GO

E.我可以在結構描述 S 中建立程序和資料表嗎？

下列範例需要 S 的 ALTER 權限，以及資料庫的 CREATE PROCEDURE 權限，對資料表也是一樣。

SELECT HAS_PERMS_BY_NAME(db_name(), 'DATABASE', 'CREATE PROCEDURE')
    & HAS_PERMS_BY_NAME('S', 'SCHEMA', 'ALTER') AS _can_create_procs,
    HAS_PERMS_BY_NAME(db_name(), 'DATABASE', 'CREATE TABLE') &
    HAS_PERMS_BY_NAME('S', 'SCHEMA', 'ALTER') AS _can_create_tables;

F.我有 SELECT 權限的資料表有哪些？

SELECT HAS_PERMS_BY_NAME
(QUOTENAME(SCHEMA_NAME(schema_id)) + '.' + QUOTENAME(name), 
    'OBJECT', 'SELECT') AS have_select, * FROM sys.tables

G.我對 AdventureWorks2012 的 SalesPerson 資料表有 INSERT 權限嗎？

下列範例會假設 AdventureWorks2012 是我的目前資料庫內容，並且使用兩部分名稱。

SELECT HAS_PERMS_BY_NAME('Sales.SalesPerson', 'OBJECT', 'INSERT');

下列範例不假設我的目前資料庫內容，並且使用三部分名稱。

SELECT HAS_PERMS_BY_NAME('AdventureWorks2012.Sales.SalesPerson', 
    'OBJECT', 'INSERT');

H.我對資料表 T 的哪些資料行有 SELECT 權限？

SELECT name AS column_name, 
    HAS_PERMS_BY_NAME('T', 'OBJECT', 'SELECT', name, 'COLUMN') 
    AS can_select 
    FROM sys.columns AS c 
    WHERE c.object_id=object_id('T');