DBCC PDW_SHOWSPACEUSED (Transact-SQL)

**APPLIES TO:** ![no](media/no.png)SQL Server ![no](media/no.png)Azure SQL Database ![yes](media/yes.png)Azure SQL Data Warehouse ![yes](media/yes.png)Parallel Data Warehouse

Displays the number of rows, disk space reserved, and disk space used for a specific table, or for all tables in a SQL Data Warehouse or SQL Data Warehouse Parallel Data Warehouse database.

Topic link icon Transact-SQL Syntax Conventions (Transact-SQL)

Syntax

-- Show the space used for all user tables and system tables in the current database  
DBCC PDW_SHOWSPACEUSED  
[;]  
  
-- Show the space used for a table  
DBCC PDW_SHOWSPACEUSED ( " [ database_name . [ schema_name ] . ] | [ schema_name .] table_name  " )  
[;]

Arguments

[ database_name . [ schema_name ] . | schema_name . ] table_name
The one, two, or three-part name of the table to be displayed. For two or three-part table names, the name must be enclosed with double quotes (""). Using quotes around a one-part table name is optional. When no table name is specified, the information is displayed for the current database.

Permissions

Requires VIEW SERVER STATE permission.

Result Sets

This is the result set for all tables.

Column	Data Type	Description
reserved_space	bigint	Total space used for the database, in KB.
data_space	bigint	Space used for data, in KB.
index_space	bigint	Space used for indexes, in KB.
unused_space	bigint	Space that is part of the reserved space and not used, in KB.
pdw_node_id	int	Compute node that is being used for the data.

This is the result set for one table.

Column	Data Type	Description	Range
rows	bigint	Number of rows.
reserved_space	bigint	Total space reserved for the object, in KB.
data_space	bigint	Space used for the data, in KB.
index_space	bigint	Space used for indexes, in KB.
unused_space	bigint	Space that is part of the reserved space and not used, in KB.
pdw_node_id	int	Compute node that is used for reporting the space usage.
distribution_id	int	Distribution that is used for reporting the space usage.	Value is -1 for replicated tables.

Examples: [!INCLUDEssSDW] and [!INCLUDEssPDW]

A. DBCC PDW_SHOWSPACEUSED Basic Syntax

The following examples show multiple ways to display the number of rows, disk space reserved, and disk space used by the FactInternetSales table in the **AdventureWorksPDW2012** database.

-- Uses AdventureWorks  
  
DBCC PDW_SHOWSPACEUSED ( "AdventureWorksPDW2012.dbo.FactInternetSales" );  
DBCC PDW_SHOWSPACEUSED ( "AdventureWorksPDW2012..FactInternetSales" );  
DBCC PDW_SHOWSPACEUSED ( "dbo.FactInternetSales" );  
DBCC PDW_SHOWSPACEUSED ( FactInternetSales );

B. Show the disk space used by all tables in the current database

The following example shows the disk space reserved and used by all user tables and system tables in the **AdventureWorksPDW2012** database.

-- Uses AdventureWorks  
  
DBCC PDW_SHOWSPACEUSED;