sp_spaceused
Displays the number of rows, disk space reserved, and disk space used by a table in the current database, or displays the disk space reserved and used by the entire database.
Syntax
sp_spaceused [[@objname =] 'objname']
[,[@updateusage =] 'updateusage']
Arguments
[@objname =] 'objname'
Is the name of the table for which space usage information (reserved and allocated space) is requested. objname is nvarchar(776), with a default of NULL.
[@updateusage =] 'updateusage'
Indicates whether or not DBCC UPDATEUSAGE should be run within the database (when no objname is specified) or on a specific object (when objname is specified). Values can be true or false. updateusage is varchar(5), with a default of FALSE.
Return Code Values
0 (success) or 1 (failure)
Result Sets
If objname is omitted, two result sets are returned.
| Column name | Data type | Description |
|---|---|---|
| database_name | varchar(18) | Name of the current database. |
| database_size | varchar(18) | Size of the current database. |
| unallocated space | varchar(18) | Unallocated space for the database. |
| Column name | Data type | Description |
|---|---|---|
| reserved | varchar(18) | Total amount of reserved space. |
| Data | varchar(18) | Total amount of space used by data. |
| index_size | varchar(18) | Space used by indexes. |
| Unused | varchar(18) | Amount of unused space. |
If parameters are specified, this is the result set.
| Column name | Data type | Description |
|---|---|---|
| Name | nvarchar(20) | Name of the table for which space usage information was requested. |
| Rows | char(11) | Number of rows existing in the objname table. |
| reserved | varchar(18) | Amount of total reserved space for objname. |
| Data | varchar(18) | Amount of space used by data in objname. |
| index_size | varchar(18) | Amount of space used by the index in objname. |
| Unused | varchar(18) | Amount of unused space in objname. |
Remarks
sp_spaceused computes the amount of disk space used for data and indexes, and the disk space used by a table in the current database. If objname is not given, sp_spaceused reports on the space used by the entire current database.
When updateusage is specified, Microsoft® SQL Server™ scans the data pages in the database and makes any necessary corrections to the sysindexes table regarding the storage space used by each table. There are some situations, for example, after an index is dropped, when the sysindexes information for the table may not be current. This process can take some time to run on large tables or databases. Use it only when you suspect incorrect values are being returned and when the process will not have an adverse effect on other users or processes in the database. If preferred, DBCC UPDATEUSAGE can be run separately.
Permissions
Execute permissions default to the public role.
Examples
A. Space information about a table
This example reports the amount of space allocated (reserved) for the titles table, the amount used for data, the amount used for index(es), and the unused space reserved by database objects.
USE pubs
EXEC sp_spaceused 'titles'
B. Updated space information about a complete database
This example summarizes space used in the current database and uses the optional parameter @updateusage.
USE pubs
sp_spaceused @updateusage = 'TRUE'
Permissions
Execute permissions default to the public role.