DBCC PDW_SHOWSPACEUSED (Transact-SQL)
適用於：
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;