sp_spaceusage

语法

“help”操作语法：

sp_spaceusage 'help'[, 'all']

sp_spaceusage 'help'[, {'display' | 'display summary' | 'report' | 'report summary' | 'archive'}[, {'table' | 'index' | 'tranlog'}]]

“display”操作语法：

sp_spaceusage 'display summary [using unit= {KB | MB | GB | PAGES}]', 
	{'table' | 'index'},<name>
	[, <where_clause>[, order_by[,<command>]]]

sp_spaceusage 'display [using unit= {KB | MB | GB | PAGES} ]',
	{'table' | 'index'}, <name> 
	[, <select_list> 
	[, <where_clause>[, order_by[, <command>]]]]

sp_spaceusage 'display [using unit={KB | MB | GB | PAGES}]', 
     'tranlog'[, <name>[, <select_list>[, <where_clause> [, order_by]]]]

sp_spaceusage 'display [using unit=<unit>]', 
     'sysimrslogs' [,{'sysimrslogs'|NULL}
     [,<select_list> [,<where_clause> [,order_by]]]] 

display database 操作语法：

sp_spaceusage 'display [summary] [using unit={KB | MB | GB | PAGES}]', 'database' 
     [, <db_name>]

sp_spaceusage 'display [using unit={KB | MB | GB | PAGES}]', 'database' [, <db_name>]

“archive”操作语法：

sp_spaceusage 'archive [using {<using_item> [,<using_item>]
', {'table' | 'index'}, <name>[, <where_clause>[, <command>]]

sp_spaceusage 'archive [using {<using_item> [,<using_item>]...} ]
', 'sysimrslogs' [,{'sysimrslogs'|NULL}[, <where_clause>]]

sp_spaceusage 'archive [using {<using_item> [,<using_item>]...} ]
', 'syslogs' [,{'syslogs'|NULL} [, <where_clause>]]

<using_item> = { unit={ KB | MB | GB | PAGES } 
	| dbname=<database_name> | prefix=<string>}

“report”操作语法：

sp_spaceusage 'report summary [using {<using_item> [,<using_item>]...}', 
	{'table' | 'index'}, <name> 
	[, <where_clause> [, order_by[, <from_date> [, <to_date>]]]]

sp_spaceusage 'report [using {<using_item> [,<using_item>]...}', 
	{'table' | 'index'}, <name> 
	[,<select_list>[, <where_clause> [, order_by[,<from_date> [,<to_date>]]]]]

sp_spaceusage 'report [using {<using_item> [,<using_item>]...}', 
	'tranlog'[, <name> 
	[,<select_list>[, <where_clause>[, order_by 
	[,<from_date>[, <to_date>]]]]]]

<using_item> = { unit={ KB | MB | GB | PAGES } 
	| dbname=<database_name> | prefix=<string>}

参数

help

显示完整的 sp_spaceusage 语法。help <action> 显示受支持的各项操作的语法。

display

显示指定对象的当前空间使用信息。database 允许您在位于任何其它数据库中时显示任何数据库的信息。这表示，当前可以在 user_db 数据库中工作，并显示 sybsystemprocs 数据库的使用信息。

display summary

显示指定对象的当前空间使用信息摘要。

archive

将空间使用报告存档到表中。如果存档表尚不存在，sp_spaceusage 将创建一个。新数据将附加到现有数据中。使用 <using> 子句可为存档表名和存档表所在的数据库指定前缀。存档需要您启用 select into/bulkcopy/pllsort 数据库选项。

report

根据以前存档的数据，报告指定对象的空间使用信息。该输出与 display 操作相同。包括可选的 using 子句，用以指定存档表。

report summary

根据以前存档的数据，报告指定对象的空间使用信息摘要。该输出与 display summary 操作相同。包括可选的 using 子句，用以指定存档表。

<using_item>

为存档表指定单位、存档数据库名称和前缀字符串。可以使用千字节 (KB)、兆字节 (MB)、千兆字节 (GB) 和页表示 <unit> 大小。缺省情况下，<unit> 大小为 KB，当前数据库是存档数据库，并且不使用前缀字符串。

<name>

是实体的名称。根据实体类型，可以包括由多个部分组成的名称，如 <owner_name.table_name> 或 <owner_name.table_name.index_name>。对于实体类型 tranlog、syslogs 和 sysimrslogs，名称必须为 syslogs、sysimrslogs 或 NULL。在由多个部分组成的名称中，每个部分都允许使用模式指示符，以支持在一次传递中报告多个对象。

<select_list>

是以逗号分隔的一组列，要在输出列中选择这些列供 display 和 report 操作使用。使用 * 将包括输出中的所有列。可使用 alias=<name> 表示法对列进行重命名。

<where_clause>

是应用于结果集的过滤器。与 display、report 或 archive 操作一起使用可选择性地过滤掉不必要的数据。

order_by

按排序顺序返回指定列中的查询结果。

<command>

在收集空间使用信息之前为限定对象对所选实体（表、列等）运行的命令。支持以下命令：update statistics、update table statistics 和 update index statistics。

<from_date>

指定您感兴趣的时间范围的开始时间。

<to_date>

指定您感兴趣的时间范围的结束时间。

示例

示例 1

显示 display 操作的简要说明、语法和用法信息：

sp_spaceusage 'help', 'display'

Display the space usage information for an entity in the current database.

Usage:
sp_spaceusage 'display', 'database' [, '<dbname>' ]

sp_spaceusage 'display', {'table'|'index'}, <name>
                        [,<select_list> [,<where_clause> [, order_by [,<command>]]]]

sp_spaceusage 'display summary', {'table'|'index'}, <name>
                        [,<where_clause> [, order_by [, <command>]]]

sp_spaceusage 'display', 'syslogs' [,{'syslogs'|NULL}
                        [,<select_list> [, <where_clause> [, order_by]]]]

sp_spaceusage 'display', 'sysimrslogs' [,{'sysimrslogs'|NULL}
                        [,<select_list> [, <where_clause> [,order_by]]]]

For more information, use:
sp_spaceusage 'help', 'display', 'database'
sp_spaceusage 'help', 'display', 'table'
sp_spaceusage 'help', 'display', 'index'
sp_spaceusage 'help', 'display', 'syslogs'
sp_spaceusage 'help', 'display', 'sysimrslogs'

示例 2

显示 titles 表的空间使用摘要：

sp_spaceusage 'display summary', 'table', 'titles'

All the page counts in the result set are in the unit 'KB'.
OwnerName  TableName  Type   UsedPages  RsvdPages  ExpRsvdPages  PctBloatRsvdPages
---------  ---------  ----   ---------  --------   ------------  -----------------
dbo        titles     DATA   6.0        30.0       16.0          87.50
dbo        titles     INDEX  8.0        64.0       32.0          50.00

示例 3

显示 titles 表的空间使用信息：

sp_spaceusage 'display', 'table', 'titles'

All the page counts in the result set are in the unit 'KB'.
OwnerName    TableName    IndId    NumRows    UsedPages    RsvdPages
  ExtentUtil     ExpRsvdPages    PctBloatUsePages     PctBloatRsvdPages
-----------  -----------  ------  -----------  ----------   --------------
  ----------     ------------    ----------------     -----------------
dbo          titles       0       18.0         6.0          30.0
  20.00          16.0            0.0                  87.50 
dbo          titles       1       NULL         4.0          32.0
  12.50          16.0            0.00                 100.00
dbo          titles       2       NULL         4.0          32.0
  12.50          16.0            0.00                 100.00

示例 4

显示 titles 表中名称以 title 开始的索引条目：

sp_spaceusage 'display using unit=MB', 'index', 'titles.title%'

All the page counts in the result set are in the unit 'MB'.
OwnerName  TableName    IndId  IndexName   UsedPages       RsvdPages
  ExtentUtil   ExpRsvdPages     PctBloatUsedPages   PctBloatRsvdPages
--------   --------     -----  ----------  ----------      ---------
  ----------   ------------     -----------------   ----------------
dbo        titles        0     titles      .005859375     .029296875 
  20.00        .015625           0.00               87.50
dbo        titles       1      titleidind  .00390625      .03125                
  12.50        .015625           0.00               100.00
dbo        titles       2      titleind    .00390625      .03125
  12.50        .015625           0.00               100.00
(1 row affected)
(return status = 0)

示例 5

显示 titles 表中名称以