DBCC PDW_SHOWSPACEUSED (Transact-SQL)
適用対象: 
Azure Synapse Analytics Analytics Platform System (PDW)
Azure Synapse Analytics または Analytics Platform System (PDW) データベースの特定のテーブルまたはすべてのテーブルの行数、予約済みのディスク領域、使用済みのディスク領域を表示します。
構文
-- 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 ]
[;]
Note
この構文は、Azure Synapse Analytics のサーバーレス SQL プールでサポートされていません。
引数
"[ database_name . [ schema_name ] . | schema_name . ] table_name"
表示される 1 部、2 部、または 3 部構成のテーブル名。 2 部または 3 部構成のテーブル名は、二重引用符 ("") で囲む必要があります。 1 部構成のテーブル名を囲む引用符を使用することは省略できます。 テーブル名が指定されていない場合は、現在のデータベースの情報が表示されます。
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 | データに使用されているコンピューティング ノード。 |
以下は、1 つのテーブルの結果セットです。
| 列 | データ型 | 説明 | Range |
|---|---|---|---|
| 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 | 領域の使用状況の報告に使用されるディストリビューション。 | Parallel Data Warehouse の場合、レプリケートされたテーブルのその値は -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;