OBJECTPROPERTY （Transact-SQL）

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse Analytics分析平台系统(PDW)Microsoft Fabric 中的 SQL 分析终结点Microsoft Fabric 中的仓库Microsoft Fabric 预览版中的 SQL 数据库

返回当前数据库中架构范围内的对象的相关信息。 有关架构范围内的对象的列表，请参阅 sys.objects (Transact-SQL)。 不能将此函数用于不属于架构范围内的对象，如数据定义语言 (DDL) 触发器和事件通知。

Transact-SQL 语法约定

语法

OBJECTPROPERTY ( ID , property )

参数

ID

表示当前数据库中对象的 ID 的表达式。 ID 为 int ，假定为当前数据库上下文中的架构范围对象。

property

表示要为 ID 指定的对象返回的信息的表达式。 属性 可以是以下值之一。

返回类型

int

例外

返回 NULL 错误或调用方没有查看对象的权限。

权限

用户只能查看符合如下条件的安全对象的元数据：该安全对象为该用户所有，或已授予该用户对该安全对象的权限。 这意味着，如果用户对对象没有任何权限，则表示元数据发出的内置函数，例如 OBJECTPROPERTY 返回 NULL 。 有关详细信息，请参阅 元数据可见性配置。

注解

数据库引擎 假定 object_id 位于当前数据库上下文中。 引用另一个数据库中 object_id 的查询返回 NULL 或结果不正确。 例如，在以下查询中，当前数据库上下文是 master 数据库。 数据库引擎尝试返回该数据库中指定 object_id 的属性值，而不是查询中指定的数据库。 查询返回错误的结果，因为视图 vEmployee 不在 master 数据库中。

USE master;
GO
SELECT OBJECTPROPERTY(OBJECT_ID(N'AdventureWorks2022.HumanResources.vEmployee'), 'IsView');
GO

OBJECTPROPERTY(view_id, 'IsIndexable') 由于对 IsIndexable 属性的评估需要分析视图定义、规范化和部分优化，因此可能会消耗大量计算机资源。 尽管 IsIndexable 属性可以标识出能编制索引的表或视图，但在实际创建索引时，如果不能满足某些索引键要求，创建过程仍然可能会失败。 有关详细信息，请参阅 CREATE INDEX (Transact-SQL)。

OBJECTPROPERTY(table_id, 'TableHasActiveFulltextIndex') 为索引添加表的至少一列时，返回值 1 （true）。 只要添加了用于索引的第一列后，全文检索即可用于填充。

创建表时， QUOTED IDENTIFIER 该选项始终存储在 ON 表的元数据中，即使该选项设置为 OFF 创建表时也是如此。 因此， OBJECTPROPERTY(table_id, 'IsQuotedIdentOn') 始终返回值 1 （true）。

示例

A. 验证对象是否为表

以下示例将测试 UnitMeasure 是否为 AdventureWorks2022 数据库中的表。

USE AdventureWorks2022;
GO
IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') = 1
   PRINT 'UnitMeasure is a table.'
ELSE IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') = 0
   PRINT 'UnitMeasure is not a table.'
ELSE IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') IS NULL
   PRINT 'ERROR: UnitMeasure is not a valid object.';
GO

B. 验证标量值用户定义函数是否具有确定性

以下示例将测试用户定义的标量值函数 ufnGetProductDealerPrice（该函数返回 money 值）是不是一个确定性函数。

USE AdventureWorks2022;
GO
SELECT OBJECTPROPERTY(OBJECT_ID('dbo.ufnGetProductDealerPrice'), 'IsDeterministic');
GO

结果集显示 ufnGetProductDealerPrice 是一个确定性函数。

-----
0

C：查找属于特定架构的表

以下示例返回架构中的所有 dbo 表。

-- Uses AdventureWorks

SELECT schema_name(o.schema_id), o.name, o.object_id, o.type_desc
FROM sys.objects AS o
WHERE OBJECTPROPERTY(o.object_id, N'SchemaId') = SCHEMA_ID(N'dbo')
ORDER BY o.type_desc, o.name;
GO

示例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

D. 验证某个对象是否为表

以下示例将测试 dbo.DimReseller 是否为 AdventureWorksPDW2022 数据库中的表。

-- Uses AdventureWorks

IF OBJECTPROPERTY (OBJECT_ID(N'dbo.DimReseller'),'ISTABLE') = 1
   SELECT 'DimReseller is a table.'
ELSE
   SELECT 'DimReseller is not a table.';
GO

相关内容

• COLUMNPROPERTY （Transact-SQL）
• 元数据函数 (Transact-SQL)
• OBJECTPROPERTYEX （Transact-SQL）
• ALTER AUTHORIZATION （Transact-SQL）
• TYPEPROPERTY （Transact-SQL）
• sys.objects （Transact-SQL）