授予搜索属性列表权限 (Transact-SQL)
适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric SQL 数据库
授予搜索属性列表的权限。
语法
GRANT permission [ ,...n ] ON
SEARCH PROPERTY LIST :: search_property_list_name
TO database_principal [ ,...n ]
[ WITH GRANT OPTION ]
[ AS granting_principal ]
参数
permission
权限的名称。 本主题后面的“备注”部分中介绍了不同权限与安全对象之间的有效映射。
ON SEARCH PROPERTY LIST ::search_property_list_name
指定要授予权限的搜索属性列表。 需要使用作用域限定符 ::。
查看现有搜索属性列表
database_principal
指定要向其授予权限的主体。 可以是下列主体之一：
数据库用户
数据库角色
应用程序角色
映射到 Windows 登录名的数据库用户
映射到 Windows 组的数据库用户
映射到证书的数据库用户
映射到非对称密钥的数据库用户
未映射到服务器主体的数据库用户。
GRANT OPTION
指示该主体还可以向其他主体授予所指定的权限。
AS granting_principal
指定一个主体，执行该查询的主体从该主体获得授予该权限的权利。 可以是下列主体之一：
数据库用户
数据库角色
应用程序角色
映射到 Windows 登录名的数据库用户
映射到 Windows 组的数据库用户
映射到证书的数据库用户
映射到非对称密钥的数据库用户
未映射到服务器主体的数据库用户。
备注
SEARCH PROPERTY LIST（搜索属性列表权限）
搜索属性列表是一个数据库级安全对象，包含在权限层次结构中作为其父级的数据库中。 下表列出了可授予的最具体的搜索属性列表限定权限，以及隐含这些权限的更一般的权限。
| 搜索属性列表权限 | 搜索属性列表权限隐含的权限 | 数据库权限隐含的权限 |
|---|---|---|
| ALTER | CONTROL | ALTER ANY FULLTEXT CATALOG |
| CONTROL | CONTROL | CONTROL |
| REFERENCES | CONTROL | REFERENCES |
| TAKE OWNERSHIP | CONTROL | CONTROL |
| VIEW DEFINITION | CONTROL | VIEW DEFINITION |
权限
授权者（或用 AS 选项指定的主体）必须具有带 GRANT OPTION 的相同权限，或具有隐含所授予权限的更高权限。
若要使用 AS 选项，还必须满足以下附加要求。
| AS granting_principal | 所需的其他权限 |
|---|---|
| 数据库用户 | 对用户的 IMPERSONATE 权限、db_securityadmin 固定数据库角色的成员身份、db_owner 固定数据库角色的成员身份或 sysadmin 固定服务器角色的成员身份。 |
| 映射到 Windows 登录名的数据库用户 | 对用户的 IMPERSONATE 权限、db_securityadmin 固定数据库角色的成员身份、db_owner 固定数据库角色的成员身份或 sysadmin 固定服务器角色的成员身份。 |
| 映射到 Windows 组的数据库用户 | Windows 组的成员身份、db_securityadmin 固定数据库角色的成员身份、db_owner 固定数据库角色的成员身份或 sysadmin 固定服务器角色的成员身份。 |
| 映射到证书的数据库用户 | db_securityadmin 固定数据库角色的成员身份、db_owner 固定数据库角色的成员身份或 sysadmin 固定服务器角色的成员身份。 |
| 映射到非对称密钥的数据库用户 | db_securityadmin 固定数据库角色的成员身份、db_owner 固定数据库角色的成员身份或 sysadmin 固定服务器角色的成员身份。 |
| 未映射到任何服务器主体的数据库用户 | 对用户的 IMPERSONATE 权限、db_securityadmin 固定数据库角色的成员身份、db_owner 固定数据库角色的成员身份或 sysadmin 固定服务器角色的成员身份。 |
| 数据库角色 | 对角色的 ALTER 权限、db_securityadmin 固定数据库角色的成员身份、db_owner 固定数据库角色的成员身份或 sysadmin 固定服务器角色的成员身份。 |
| 应用程序角色 | 对角色的 ALTER 权限、db_securityadmin 固定数据库角色的成员身份、db_owner 固定数据库角色的成员身份或 sysadmin 固定服务器角色的成员身份。 |
对象所有者可以授予对其所拥有的对象的权限。 对某安全对象具有 CONTROL 权限的主体可以授予对该安全对象的权限。
被授予 CONTROL SERVER 权限的用户（例如，sysadmin 固定服务器角色的成员）可以授予对相应服务器中任一个安全对象的任意权限。 将某一数据库的 CONTROL 权限授予用户（例如，db_owner 固定数据库角色的成员）后，该用户就可授予对该数据库中任何一个安全对象的任意权限。 被授权 CONTROL 权限的用户可以授予对相应架构中任一个对象的任意权限。
示例
授予搜索属性列表的权限
以下示例为 Mary 授予搜索属性列表 VIEW DEFINITION 的 DocumentTablePropertyList 权限。
GRANT VIEW DEFINITION
ON SEARCH PROPERTY LIST :: DocumentTablePropertyList
TO Mary ;
另请参阅
CREATE APPLICATION ROLE (Transact-SQL)
CREATE ASYMMETRIC KEY (Transact-SQL)
CREATE CERTIFICATE (Transact-SQL)
CREATE SEARCH PROPERTY LIST (Transact-SQL)
拒绝搜索属性列表权限 (Transact-SQL)
加密层次结构
sys.fn_my_permissions (Transact-SQL)
GRANT (Transact-SQL)
HAS_PERMS_BY_NAME (Transact-SQL)
主体（数据库引擎）
撤消搜索属性列表权限 (Transact-SQL)
sys.fn_builtin_permissions (Transact-SQL)
sys.registered_search_property_lists (Transact-SQL)
使用搜索属性列表搜索文档属性