PERMISSIONS (Transact-SQL)

项目
07/05/2024

适用于： SQL Server Azure SQL 数据库 Azure SQL 托管实例

返回一个包含位图的值，该值指示当前用户的语句、对象或列权限。

重要

在 SQL Server的未来版本中将删除此功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。请改用 fn_my_permissions 和 Has_Perms_By_Name。继续使用 PERMISSIONS 函数可能导致性能降低。

Transact-SQL 语法约定

语法

PERMISSIONS ( [ objectid [ , 'column' ] ] )

参数

objectid
安全对象的 ID。如果未指定 objectid，则位图值包含当前用户的语句权限；否则，位图包含当前用户对该安全对象的权限。指定的安全对象必须在当前数据库中。使用 OBJECT_ID 函数确定 objectid 值。

' column '
返回其权限信息的列的可选名。该列必须是 objectid 指定的表中的有效列名。

返回类型

int

备注

可以使用 PERMISSIONS 确定当前用户是否具有执行某个语句或向另一用户授予权限所需的权限。

所返回的权限信息是 32 位位图。

低 16 位反映授予用户的权限，以及应用于 Windows 组或当前用户属于其成员的固定服务器角色的权限。例如，当没有指定 objectid 时，将返回值 66（十六进制值 0x42），指示当前用户具有执行 CREATE TABLE（十进制值 2）和 BACKUP DATABASE（十进制值 64）语句的权限。

高 16 位反映用户可以授予其他用户的权限。除左移 16 位（与 65536 相乘）之外，高 16 位的解释方式与下表中所介绍的低 16 位的解释方式完全相同。例如，位 0x8（十进制值 8）指示当指定 objectid 时的 INSERT 权限。而 0x80000（十进制值 524288）指示 GRANT INSERT 权限的能力，这是因为 524288 = 8 x 65536。

由于角色中的成员身份，没有执行语句权限的用户仍然可以将该权限授予其他用户。

下表显示语句权限所使用的位（未指定 objectid）。

位（十进制）	位（十六进制）	语句权限
1	0x1	CREATE DATABASE（仅限于 master 数据库）
2	0x2	CREATE TABLE
4	0x4	CREATE PROCEDURE
8	0x8	CREATE VIEW
16	0x10	CREATE RULE
32	0x20	CREATE DEFAULT
64	0x40	BACKUP DATABASE
128	0x80	BACKUP LOG
256	0x100	保留

下表显示当仅指定 objectid 时，返回的对象权限所使用的位。

位（十进制）	位（十六进制）	语句权限
1	0x1	SELECT ALL
2	0x2	UPDATE ALL
4	0x4	REFERENCES ALL
8	0x8	INSERT
16	0x10	DELETE
32	0x20	EXECUTE（仅限于过程）
4096	0x1000	SELECT ANY（至少一列）
8192	0x2000	UPDATE ANY
16384	0x4000	REFERENCES ANY

下表显示当同时指定 objectid 和列时，返回的列级对象权限所使用的位。

位（十进制）	位（十六进制）	语句权限
1	0x1	SELECT
2	0x2	UPDATE
4	0x4	REFERENCES

如果指定的参数为 NULL 或无效（例如，objectid 或列不存在），则返回 NULL。没有定义不适用的权限所使用的位值（例如，表的 EXECUTE 权限、位 0x20）。

使用位与 (&) 运算符确定 PERMISSIONS 函数返回的位图中的每个位集。

还可使用 sp_helprotect 系统存储过程返回某用户在当前数据库中的权限列表。

示例

A. 对语句权限使用 PERMISSIONS 函数

以下示例确定当前用户能否执行 CREATE TABLE 语句。

IF PERMISSIONS()&2=2  
   CREATE TABLE test_table (col1 INT)  
ELSE  
   PRINT 'ERROR: The current user cannot create a table.';

B. 对对象权限使用 PERMISSIONS 函数

以下示例确定当前用户能否在 Address 数据库的 AdventureWorks2022 表中插入数据行。

IF PERMISSIONS(OBJECT_ID('AdventureWorks2022.Person.Address','U'))&8=8   
   PRINT 'The current user can insert data into Person.Address.'  
ELSE  
   PRINT 'ERROR: The current user cannot insert data into Person.Address.';

C. 对可授予的权限使用 PERMISSIONS 函数

以下示例确定当前用户能否将 Address 数据库的 AdventureWorks2022 表的 INSERT 权限授予另一用户。

IF PERMISSIONS(OBJECT_ID('AdventureWorks2022.Person.Address','U'))&0x80000=0x80000  
   PRINT 'INSERT on Person.Address is grantable.'  
ELSE  
   PRINT 'You may not GRANT INSERT permissions on Person.Address.';

另请参阅

DENY (Transact-SQL)
GRANT (Transact-SQL)
OBJECT_ID (Transact-SQL)
REVOKE (Transact-SQL)
sp_helprotect (Transact-SQL)
系统函数 (Transact-SQL)

通过