OBJECT_SCHEMA_NAME (Transact-SQL)
新建日期: 2006 年 12 月 12 日
返回架构范围内对象的数据库架构名称。有关架构范围内对象的列表,请参阅 sys.objects (Transact-SQL)。
语法
OBJECT_SCHEMA_NAME ( object_id [, database_id ] )
参数
- object_id
要使用的对象的 ID。object_id 的数据类型为 int,并假定为指定数据库或当前数据库上下文中的架构范围内的对象。
- database_id
要在其中查找对象的数据库的 ID。database_id 的数据类型为 int。
返回类型
sysname
异常
出现错误时或调用方没有查看对象的权限时,将返回 NULL。如果目标数据库的 AUTO_CLOSE 选项设置为 ON,则此函数将打开此数据库。
用户只能查看其拥有的安全对象的元数据,或者已对其授予权限的安全对象的元数据。也就是说,如果用户对该对象没有任何权限,则那些会生成元数据的内置函数(如 OBJECT_SCHEMA_NAME)则可能返回 NULL。有关详细信息,请参阅元数据可见性配置和元数据可见性故障排除。
备注
系统函数可以在选择列表、WHERE 子句和允许使用表达式的任何地方使用。有关详细信息,请参阅表达式和 WHERE。
由此系统函数返回的结果集将使用当前数据库的排序规则。
如果未指定 database_id,则 SQL Server 数据库引擎假定 object_id 在当前数据库上下文中。在其他数据库中引用 object_id 的查询将返回 NULL 或错误的结果。例如,以下查询中当前数据库上下文是 AdventureWorks
。数据库引擎将尝试返回在该数据库(而非查询的 FROM 子句中指定的数据库)中指定的对象 ID 的对象架构名称。因此,会返回不正确的信息。
USE AdventureWorks;
GO
SELECT DISTINCT OBJECT_SCHEMA_NAME(object_id)
FROM master.sys.objects;
GO
以下示例在 OBJECT_SCHEMA_NAME
函数中指定 master
数据库的数据库 ID,并返回正确的结果。
USE AdventureWorks;
GO
SELECT DISTINCT OBJECT_SCHEMA_NAME(object_id, 1) AS schema_name
FROM master.sys.objects;
GO
权限
需要对对象拥有 ANY 权限。若要指定数据库 ID,还需要对数据库拥有 CONNECT 权限,或者必须启用 guest 帐户。
示例
A. 返回对象架构名称和对象名称
以下示例返回所有缓存查询计划(为非临时语句或预定义语句)的对象架构名称、对象名称和 SQL 文本。
SELECT DB_NAME(st.dbid) AS database_name,
OBJECT_SCHEMA_NAME(st.objectid, st.dbid) AS schema_name,
OBJECT_NAME(st.objectid, st.dbid) AS object_name,
st.text AS query_statement
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_sql_text(qs.sql_handle) AS st
WHERE st.objectid IS NOT NULL;
GO
B. 返回由三部分组成的对象名
以下示例返回所有数据库中所有对象的数据库名称、架构名称和对象名称,同时返回 sys.dm_db_index_operational_stats
动态管理视图中的其他所有列。
SELECT QUOTENAME(DB_NAME(database_id))
+ N'.'
+ QUOTENAME(OBJECT_SCHEMA_NAME(object_id, database_id))
+ N'.'
+ QUOTENAME(OBJECT_NAME(object_id, database_id))
, *
FROM sys.dm_db_index_operational_stats(null, null, null, null);
GO
请参阅
参考
元数据函数 (Transact-SQL)
OBJECT_DEFINITION (Transact-SQL)
OBJECT_ID (Transact-SQL)
OBJECT_NAME (Transact-SQL)