DBCC PDW_SHOWSPACEUSED (Transact-SQL)

[アーティクル]
04/26/2023

適用対象: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;