DATABASEPROPERTYEX （Transact-SQL）

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse Analytics分析平台系统 （PDW）Microsoft Fabric 预览版中的 SQL 数据库

对于 SQL Server 中的指定数据库，该 DATABASEPROPERTYEX 函数返回指定数据库选项或属性的当前设置。

Transact-SQL 语法约定

语法

DATABASEPROPERTYEX ( database , property )

参数

数据库

一个表达式，指定返回命名属性信息的数据库 DATABASEPROPERTYEX 的名称。 database 的数据类型为 nvarchar(128)。

对于 SQL 数据库，DATABASEPROPERTYEX 需要当前数据库的名称。 如果给定不同的数据库名称，则返回 NULL 所有属性。

财产

一个表达式，用于指定要返回的数据库属性的名称。 property 的数据类型为 varchar(128)，并支持下表中的某个值：

返回类型

sql_variant

例外

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

在 SQL Server 中，用户只能查看其拥有的安全对象的元数据，或者已对其授予权限的安全对象的元数据。 此规则意味着，如果用户对对象没有权限，则发出元数据的内置函数（例如 OBJECT_ID 可以返回 NULL ）。 有关详细信息，请参阅 元数据可见性配置。

备注

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

示例

本文中的代码示例使用 AdventureWorks2022 或 AdventureWorksDW2022 示例数据库，可以从 Microsoft SQL Server 示例和社区项目 主页下载该数据库。

答： 检索AUTO_SHRINK数据库选项的状态

此示例返回数据库的数据库选项AUTO_SHRINK的状态AdventureWorks。

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

结果集如下。 这表示已 AUTO_SHRINK 关闭。

0

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

以下示例返回 AdventureWorks 数据库的多个属性。

SELECT DATABASEPROPERTYEX('AdventureWorks2022', 'Collation') AS Collation,
       DATABASEPROPERTYEX('AdventureWorks2022', 'Edition') AS Edition,
       DATABASEPROPERTYEX('AdventureWorks2022', 'ServiceObjective') AS ServiceObjective,
       DATABASEPROPERTYEX('AdventureWorks2022', 'MaxSizeInBytes') AS MaxSizeInBytes;

结果集如下。

Collation                     Edition        ServiceObjective  MaxSizeInBytes
----------------------------  -------------  ----------------  --------------
SQL_Latin1_General_CP1_CI_AS  DataWarehouse  DW1000            5368709120

°C 使用 DATABASEPROPERTYEX 验证与副本的连接

使用 Azure SQL 数据库横向扩展功能时，可以通过在数据库的上下文中运行以下查询来验证是否已连接到只读副本。 当连接到只读副本时， READ_ONLY 它将返回。 通过这种方式，还可确定查询何时在只读副本上运行。

SELECT DATABASEPROPERTYEX(DB_NAME(), 'Updateability');

相关内容

• ALTER DATABASE （Transact-SQL）
• 数据库状态
• sys.databases （Transact-SQL）
• sys.database_files（Transact-SQL）
• SERVERPROPERTY （Transact-SQL）