大网数据广告活动
数据库与应用安全

SQL Server 数据库 — sp_spaceused (TRANSACT-SQL)

· 52CE 我爱测

显示行数、保留的磁盘空间以及当前数据库中的表、索引视图或 !INCLUDE[ssSB] 队列所使用的磁盘空间,或显示由整个数据库保留和使用的磁盘空间。

适用对象:yesSQL Server(从 2012 开始)yesAzure SQL 数据库yesAzure SQL 数据仓库yes并行数据仓库

显示行数、保留的磁盘空间以及当前数据库中的表、索引视图或 Service Broker 队列所使用的磁盘空间,或显示由整个数据库保留和使用的磁盘空间。

主题链接图标 TRANSACT-SQL 语法约定

语法

sp_spaceused [[ @objname = ] 'objname' ]   
[, [ @updateusage = ] 'updateusage' ]  
[, [ @mode = ] 'mode' ]  
[, [ @oneresultset = ] oneresultset ]  
[, [ @include_total_xtp_storage = ] include_total_xtp_storage ]

参数

有关SQL 数据仓库并并行数据仓库,sp_spaceused必须指定命名的参数 (例如sp_spaceused (@objname= N'Table1');而不是依赖时参数的序号位置。

[ @objname=] 'objname’

请求其空间使用信息的表、索引视图或队列的限定或非限定名称。 仅当指定限定对象名称时,才需要使用引号。 如果提供完全限定对象名称(包括数据库名称),则数据库名称必须是当前数据库的名称。
如果objname未指定,则返回整个数据库的结果。
objname是nvarchar(776),默认值为 NULL。

Note:
SQL 数据仓库 和并行数据仓库仅支持数据库和表对象。

[ @updateusage=] 'updateusage'
指示应运行 DBCC UPDATEUSAGE 以更新空间使用信息。 当objname是未指定,在整个数据库上运行该语句; 否则,运行该语句objname。 值可以是 ,则返回 true或false。 updateusage是varchar(5),默认值为false。

[ @mode=] '模式’
指示结果的范围。 为已延伸的表或数据库,模式下参数可以包括或排除的对象的远程部分。 有关详细信息,请参阅 Stretch Database。

模式下自变量可具有以下值:

ReplTest1 Description
ALL 返回对象或数据库中包括的本地部分以及远程部分的存储统计的信息。
LOCAL_ONLY 返回只有对象或数据库的本地部分的存储统计信息。 如果对象或数据库不是已启用延伸的将返回相同的统计信息与@mode= ALL。
REMOTE_ONLY 返回只有对象或数据库的远程部分的存储统计信息。 当以下条件之一为 true 时,此选项将导致错误: 表未启用延伸。 表启用延伸,但从未启用数据迁移。 在这种情况下,远程表还没有一个架构。 用户已手动删除远程表。 预配的远程数据存档返回的状态为成功,但实际上它失败。

模式是varchar(11),默认值为N'ALL'。

[ @oneresultset=] oneresultset
指示是否返回单个结果集。 Oneresultset自变量可具有以下值:

ReplTest1 Description
0 当*@objname*为 null 或为未指定,返回两个结果集。 两个结果集是默认行为。
1 当*@objname* = null 或为未指定,则返回单个结果集。

oneresultset是位,默认值为0。

[ @include_total_xtp_storage] 'include_total_xtp_storage’
适用于: SQL Server 2017 (14.x), SQL Database。

当@oneresultset= 1,该参数@include_total_xtp_storage确定单结果集是否包含 MEMORY_OPTIMIZED_DATA 存储的列。 默认值为 0,也就是说,默认情况下 (如果省略此参数) XTP 列不包含在结果集中。

返回代码值

0(成功)或 1(失败)

结果集

如果objname省略了和的值oneresultset为 0,则返回以下结果集以提供当前数据库大小信息。

列名 数据类型 Description
database_name nvarchar(128) 当前数据库的名称。
database_size varchar(18) 当前数据库的大小 (MB)。 database_size包括数据和日志文件。
未分配的空间 varchar(18) 未保留供数据库对象使用的数据库空间。
列名 数据类型 Description
保留 varchar(18) 由数据库中对象分配的空间总量。
data varchar(18) 数据使用的空间总量。
index_size varchar(18) 索引使用的空间总量。
未使用 varchar(18) 为数据库中的对象保留但尚未使用的空间总量。

如果objname省略了和的值oneresultset为 1,将返回以下的单个结果集以提供当前数据库大小信息。

列名 数据类型 Description
database_name nvarchar(128) 当前数据库的名称。
database_size varchar(18) 当前数据库的大小 (MB)。 database_size包括数据和日志文件。
未分配的空间 varchar(18) 未保留供数据库对象使用的数据库空间。
保留 varchar(18) 由数据库中对象分配的空间总量。
data varchar(18) 数据使用的空间总量。
index_size varchar(18) 索引使用的空间总量。
未使用 varchar(18) 为数据库中的对象保留但尚未使用的空间总量。

如果objname指定,则为指定的对象返回以下结果集。

列名 数据类型 Description
名称 nvarchar(128) 请求其空间使用信息的对象的名称。 不返回对象的架构名称。 如果架构名称是必需的使用sys.dm_db_partition_stats或sys.dm_db_index_physical_stats动态管理视图获取等价大小信息。
行 char(20) 表中现有的行数。 如果指定的对象是 Service Broker 队列,该列将指示队列中的消息数。
保留 varchar(18) 有关保留空间总量objname。
data varchar(18) 使用中的数据的空间总量objname。
index_size varchar(18) 索引中使用的空间总量objname。
未使用 varchar(18) 为保留的空间总量objname但尚未使用。

这是默认模式下,当未不指定任何参数。 以下结果集返回详细介绍了在磁盘上的数据库大小信息。

列名 数据类型 Description
database_name nvarchar(128) 当前数据库的名称。
database_size varchar(18) 当前数据库的大小 (MB)。 database_size包括数据和日志文件。 如果数据库具有 MEMORY_OPTIMIZED_DATA 文件组,这将包括文件组中的所有检查点文件的总磁盘上大小。
未分配的空间 varchar(18) 未保留供数据库对象使用的数据库空间。 如果数据库具有 MEMORY_OPTIMIZED_DATA 文件组,这将包括文件组中具有状态 PRECREATED 的检查点文件的总磁盘上大小。

在数据库中的表使用的空间: (此结果集不会反映内存优化表,因为没有任何每个表施加的磁盘使用情况)

列名 数据类型 Description
保留 varchar(18) 由数据库中对象分配的空间总量。
data varchar(18) 数据使用的空间总量。
index_size varchar(18) 索引使用的空间总量。
未使用 varchar(18) 为数据库中的对象保留但尚未使用的空间总量。

将返回以下结果集仅当数据库具有 MEMORY_OPTIMIZED_DATA 文件组具有至少一个容器:

列名 数据类型 Description
xtp_precreated varchar(18) 具有状态 PRECREATED,以 kb 为单位的检查点文件的总大小。 内容计为整个数据库中的未分配空间。 [例如,如果没有 600,000 KB 的预创建的检查点文件,此列将包含"600000 KB]
xtp_used varchar(18) 其中包含 UNDER CONSTRUCTION、 活动状态,并且合并的目标,以 kb 为单位的状态的检查点文件的总大小。 这是主要使用内存优化表中的数据的磁盘空间。
xtp_pending_truncation varchar(18) 具有状态 WAITING_FOR_LOG_TRUNCATION,以 kb 为单位的检查点文件的总大小。 这是用于等待清理后进行日志截断, 的检查点文件的磁盘空间。

如果objname是省略,oneresultset 的值为 1,并include_total_xtp_storage为 1,将返回以下的单个结果集以提供当前数据库大小信息。 如果include_total_xtp_storage为 0 (默认值),则省略了最后三列。

列名 数据类型 Description
database_name nvarchar(128) 当前数据库的名称。
database_size varchar(18) 当前数据库的大小 (MB)。 database_size包括数据和日志文件。 如果数据库具有 MEMORY_OPTIMIZED_DATA 文件组,这将包括文件组中的所有检查点文件的总磁盘上大小。
未分配的空间 varchar(18) 未保留供数据库对象使用的数据库空间。 如果数据库具有 MEMORY_OPTIMIZED_DATA 文件组,这将包括文件组中具有状态 PRECREATED 的检查点文件的总磁盘上大小。
保留 varchar(18) 由数据库中对象分配的空间总量。
data varchar(18) 数据使用的空间总量。
index_size varchar(18) 索引使用的空间总量。
未使用 varchar(18) 为数据库中的对象保留但尚未使用的空间总量。
xtp_precreated varchar(18) 具有状态 PRECREATED,以 kb 为单位的检查点文件的总大小。 这向数据库中未分配的空间计为一个整体。 如果数据库不具有 memory_optimized_data 文件组具有至少一个容器,则返回 NULL。 此列才包含的 if @include_total_xtp_storage= 1。
xtp_used varchar(18) 其中包含 UNDER CONSTRUCTION、 活动状态,并且合并的目标,以 kb 为单位的状态的检查点文件的总大小。 这是主要使用内存优化表中的数据的磁盘空间。 如果数据库不具有 memory_optimized_data 文件组具有至少一个容器,则返回 NULL。 此列才包含的 if @include_total_xtp_storage= 1。
xtp_pending_truncation varchar(18) 具有状态 WAITING_FOR_LOG_TRUNCATION,以 kb 为单位的检查点文件的总大小。 这是用于等待清理后进行日志截断, 的检查点文件的磁盘空间。 如果数据库不具有 memory_optimized_data 文件组具有至少一个容器,则返回 NULL。 此列才包含的如果@include_total_xtp_storage=1。

备注

database_size始终是大于的总和保留 + 未分配的空间因为它包括日志文件的大小,但保留并unallocated_space只考虑数据页。

使用 XML 索引和全文索引的页中包含index_size对这两个结果集。 当objname指定的 XML 索引和全文索引的对象的页总计中也被计入保留并index_size结果。

如果为数据库或具有空间索引的空间大小列,如对象计算空间使用情况database_size,保留,并index_size,包括空间索引的大小。

当updateusage指定,则SQL Server 数据库引擎扫描数据页的数据库中并使任何所需更正sys.allocation_units和sys.partitions目录视图使用的每个表的存储空间。 在某些情况下(例如删除索引后、表的空间信息不是当前信息时),需要执行该操作。 updateusage可能需要一些时间才能在大型表或数据库上运行。 使用updateusage仅当怀疑所返回的不正确的值和过程将不有不利影响其他用户或进程在数据库中。 如果首选该进程,则可以单独运行 DBCC UPDATEUSAGE。

Note:
在删除或重新生成大型索引时,或者在删除或截断大型表时,数据库引擎将延迟实际页释放及其关联锁,直至事务提交完毕为止。 延迟的删除操作不会立即释放已分配的空间。 因此,返回的值sp_spaceused后立即删除或截断大型对象可能不会反映实际的磁盘空间可用。

Permissions

执行 sp_spaceused 的权限授予 public 角色。 只有 db_owner 固定数据库角色的成员可以指定 @updateusage 参数。

示例

A. 显示表的磁盘空间信息

以下示例报告 Vendor 表及其索引的磁盘空间信息。

USE AdventureWorks2012;  
GO  
EXEC sp_spaceused N'Purchasing.Vendor';  
GO  

B. 显示数据库的已更新空间信息

下例对当前数据库中使用的空间进行了汇总,并使用可选参数 @updateusage 确保返回当前值。

USE AdventureWorks008R2;  
GO  
EXEC sp_spaceused @updateusage = N'TRUE';  
GO  

C. 显示远程表的空间使用情况信息与已启用延伸的表相关联

下面的示例汇总了通过使用与已启用延伸的表关联的远程表使用的空间**@mode**参数,以指定在远程目标。 有关详细信息,请参阅 Stretch Database。

USE StretchedAdventureWorks2016  
GO  
EXEC sp_spaceused N'Purchasing.Vendor', @mode = 'REMOTE_ONLY'  

D. 在单个结果中显示数据库的空间使用情况信息设置

下面的示例汇总了当前数据库中单个结果集的空间使用情况。

USE AdventureWorks2016  
GO  
EXEC sp_spaceused @oneresultset = 1  

E. 在单个结果集显示与至少一个 MEMORY_OPTIMIZED 文件组数据库的空间使用情况信息

下面的示例汇总了当前数据库内具有至少一个 MEMORY_OPTIMIZED 文件组中单个结果集的空间使用情况。

USE WideWorldImporters
GO
EXEC sp_spaceused @updateusage = 'FALSE', @mode = 'ALL', @oneresultset = '1', @include_total_xtp_storage = '1';
GO

F. 在数据库中显示的 MEMORY_OPTIMIZED 表对象的空间使用情况信息。

下面的示例汇总了在当前数据库内具有至少一个 MEMORY_OPTIMIZED 文件组中为 MEMORY_OPTIMIZED 表对象的空间使用情况。

USE WideWorldImporters
GO
EXEC sp_spaceused
@objname = N'VehicleTemparatures',
@updateusage = 'FALSE',
@mode = 'ALL',
@oneresultset = '0',
@include_total_xtp_storage = '1';
GO

请参阅

CREATE INDEX (Transact-SQL)
CREATE TABLE (Transact-SQL)
DBCC UPDATEUSAGE (Transact SQL)
SQL Server Service Broker
sys.allocation_units (TRANSACT-SQL)
sys.indexes (Transact-SQL)
sys.index_columns (Transact-SQL)
sys.objects (Transact-SQL)
sys.partitions (Transact-SQL)
系统存储过程 (Transact-SQL)

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 stevestein)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 08/14/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。