sp_column_privileges_ex (Transact-SQL)

适用于：SQL Server

返回指定链接服务器上的指定表的列特权。

Transact-SQL 语法约定

语法

  
sp_column_privileges_ex [ @table_server = ] 'table_server'   
     [ , [ @table_name = ] 'table_name' ]   
     [ , [ @table_schema = ] 'table_schema' ]   
     [ , [ @table_catalog = ] 'table_catalog' ]   
     [ , [ @column_name = ] 'column_name' ]  

参数

[ @table_server = ] 'table_server' 要为其返回信息的链接服务器的名称。 table_server 为 sysname，无默认值。

[ @table_name = ] 'table_name' 包含指定列的表的名称。 table_name 为 sysname，默认值为 NULL。

[ @table_schema = ] 'table_schema' 表架构。 table_schema为 sysname，默认值为 NULL。

[ @table_catalog = ] 'table_catalog' 指定 table_name 所在的数据库的名称。 table_catalog 为 sysname，默认值为 NULL。

[ @column_name = ] 'column_name' 要为其提供特权信息的列的名称。 column_name为 sysname，默认值为 NULL（所有常见）。

结果集

下表显示结果集列。 返回的结果按TABLE_QUALIFIER、TABLE_OWNER、TABLE_NAME、COLUMN_NAME和 PRIVILEGE 排序。

列名称	数据类型	描述
TABLE_CAT	sysname	表限定符名称。 多种 DBMS 产品支持表的三部分命名方式 (qualifier.owner.name)。 在 SQL Server 中，此列表示数据库名称。 在某些产品中，该列表示表所在的数据库环境的服务器名。 此字段可以为 NULL。
TABLE_SCHEM	sysname	表所有者名称。 在 SQL Server 中，此列表示创建该表的数据库用户的名称。 此字段始终返回值。
TABLE_NAME	sysname	表名。 此字段始终返回值。
COLUMN_NAME	sysname	所返回的 TABLE_NAME 中每列的列名。 此字段始终返回值。
GRANTOR	sysname	已对此 COLUMN_NAME 授予对列出的 GRANTEE 的权限的数据库用户名。 在 SQL Server 中，此列始终与 TABLE_OWNER相同。 此字段始终返回值。 GRANTOR 列可以是数据库所有者（TABLE_OWNER），也可以是数据库所有者在 GRANT 语句中使用 WITH GRANT OPTION 子句授予权限的人员。
GRANTEE	sysname	已由列出的 GRANTOR 对此COLUMN_NAME授予权限的数据库用户名。 此字段始终返回值。
特权	varchar(32)	可用列权限中的一个。 列权限可以是下列值中的一个（或定义实现时数据源支持的其他值）： SELECT = GRANTEE 可以检索列的数据。 INSERT = GRANTEE 在表中插入新行（由 GRANTEE）时，可以为此列提供数据。 UPDATE = GRANTEE 可以修改列中的现有数据。 REFERENCES = GRANTEE 可以在主键/外键关系中引用外表中的列。 主键/外键关系是使用表约束定义的。
IS_GRANTABLE	varchar(3)	指示 是否允许 GRANTEE 向其他用户授予权限（通常称为“授予授予”权限）。 可以是 YES、NO 或 NULL。 未知值或 NULL 值表示不能使用“授予再授予”(grant with grant) 的数据源。

权限

需要对架构的 SELECT 权限。

示例

以下示例返回 HumanResources.Department 链接服务器上 AdventureWorks2022 数据库中 Seattle1 表的列特权信息。

EXEC sp_column_privileges_ex @table_server = 'Seattle1',   
   @table_name = 'Department',   
   @table_schema = 'HumanResources',  
   @table_catalog ='AdventureWorks2022';  

另请参阅

sp_table_privileges_ex （Transact-SQL）
系统存储过程 (Transact-SQL)