DATABASEPROPERTYEX (Transact-SQL)

更新日期： 2006 年 7 月 17 日

返回指定数据库的指定数据库选项或属性的当前设置。

Transact-SQL 语法约定

语法

DATABASEPROPERTYEX ( database , property )

参数

• database
  表示要为其返回命名属性信息的数据库的名称。 database 的数据类型为 nvarchar(128)。

• property
  表示要返回的数据库属性的名称的表达式。property 的数据类型为 varchar(128)，可以是下列值之一：返回类型为 sql_variant。下表显示了各属性值的基本数据类型。

  注意：
  如果数据库未启动，则 Microsoft SQL Server 2005 数据库引擎通过直接访问数据库而不是从元数据检索值而检索到的属性将返回 NULL。即，数据库的 AUTO_CLOSE 设置为 ON，或者数据库已脱机。

  属性

返回类型

sql_variant

异常

出现错误时或调用方没有查看对象的权限时，将返回 NULL。

在 SQL Server 2005 中，用户只能查看用户拥有的安全对象的元数据，或者用户被授予其权限的安全对象的元数据。也就是说，如果用户对该对象没有任何权限，则那些会生成元数据的内置函数（如 OBJECT_ID）可能返回 NULL。有关详细信息，请参阅元数据可见性配置和元数据可见性故障排除。

备注

DATABASEPROPERTYEX 一次只返回一个属性设置。若要显示多个属性设置，请使用 sys.databases 目录视图。

示例

A. 检索 AUTO_SHRINK 数据库选项的状态

以下示例将返回 AdventureWorks 数据库的 AUTO_SHRINK 数据库选项的状态。

SELECT DATABASEPROPERTYEX('AdventureWorks', 'IsAutoShrink');

下面是结果集：该结果集指示 AUTO_SHRINK 已关闭。

------------------
0

B. 检索数据库的默认排序规则

以下示例将返回 AdventureWorks 数据库的默认排序规则的名称。

SELECT DATABASEPROPERTYEX('AdventureWorks', 'Collation');

下面是结果集：

------------------------------
SQL_Latin1_General_CP1_CI_AI

请参阅

参考

ALTER DATABASE (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)

其他资源

数据库状态
设置数据库选项
使用 sql_variant 数据

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录