DBCC PDW_SHOWSPACEUSED (Transact-SQL)

發行項
05/04/2023

適用於：Azure Synapse Analytics Analytics Platform System (PDW)

顯示 Azure Synapse Analytics 或 Analytics Platform System (PDW) 資料庫中的資料列數目、保留的磁碟空間和特定資料表或所有資料表使用的磁碟空間。

Syntax

-- Show the space used for all user tables and system tables in the current database
DBCC PDW_SHOWSPACEUSED [ WITH IGNORE_REPLICATED_TABLE_CACHE ]
[;]

-- Show the space used for a table
DBCC PDW_SHOWSPACEUSED ( "[ database_name . [ schema_name ] . ] | [ schema_name . ] table_name" ) [ WITH IGNORE_REPLICATED_TABLE_CACHE ]
[;]

注意

Azure Synapse Analytics 的無伺服器 SQL 集區不支援此語法。

引數

"[ database_name . [ schema_name ] . | schema_name . ] table_name"

要顯示的資料表的一段式、兩段式或三段式名稱。兩段式或三段式的資料表名稱，此名稱必須以雙引號 ("") 括住。您可以選擇是否使用引號括住一段式資料表名稱。未指定資料表名稱時，會顯示目前資料庫的資訊。

WITH IGNORE_REPLICATED_TABLE_CACHE

選擇性參數，可檢視不包含複寫資料表快取大小的資料表大小。複寫資料表快取的大小會隨服務等級目標而變動。如需詳細資訊，請參閱什麼是複寫資料表？

權限

需要 VIEW SERVER STATE 權限。

備註

另外還有 DMV，可為資料表大小提供更多可自訂的查詢。如需詳細資訊，請參閱資料表大小查詢。

結果集

以下是所有資料表的結果集。針對複寫的 Synapse 資料表建立快取之前，DBCC 結果會反映每個分佈中底層循環配置資源資料表的總大小。建立快取之後，結果會反映循環配置資源資料表與快取的總大小。

資料行	資料類型	描述
reserved_space	BIGINT	資料庫使用的總空間 (KB)。
data_space	BIGINT	資料使用的空間 (KB)。
index_space	BIGINT	索引使用的空間 (KB)。
unused_space	BIGINT	保留未使用的空間 (KB)。
pdw_node_id	int	資料使用的計算節點。

以下是某份資料表的結果集。

資料行	資料類型	描述	範圍
rows	BIGINT	資料列數目。
reserved_space	BIGINT	為物件保留的總空間 (KB)。
data_space	BIGINT	資料使用的空間 (KB)。
index_space	BIGINT	索引使用的空間 (KB)。
unused_space	BIGINT	保留未使用的空間 (KB)。
pdw_node_id	int	用於報告空間使用量的計算節點。
distribution_id	int	用於報告空間使用量的分佈。	針對平行處理資料倉儲，其適用於已複寫資料表的值為 -1。

範例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

A. DBCC PDW_SHOWSPACEUSED 基本語法

下列範例使用 AdventureWorks2022 範例資料庫示範多種方法，以顯示 AdventureWorksPDW2022 資料庫中的資料列數目、保留的磁碟空間和 FactInternetSales 資料表使用的磁碟空間。

-- Uses AdventureWorks2022

DBCC PDW_SHOWSPACEUSED ( "AdventureWorksPDW2012.dbo.FactInternetSales" );
DBCC PDW_SHOWSPACEUSED ( "AdventureWorksPDW2012..FactInternetSales" );
DBCC PDW_SHOWSPACEUSED ( "dbo.FactInternetSales" );
DBCC PDW_SHOWSPACEUSED ( FactInternetSales );

B. 顯示目前資料庫中的所有資料表使用的磁碟空間

以下範例使用 AdventureWorks2022 範例資料庫顯示 AdventureWorksPDW2022 資料庫中所有使用者資料表和系統資料表保留和使用的磁碟空間。

-- Uses AdventureWorks2022  
DBCC PDW_SHOWSPACEUSED;