DBCC PDW_SHOWSPACEUSED (Transact-SQL)

  • Article

S’applique à : Azure Synapse AnalyticsAnalytics Platform System (PDW)

Affiche le nombre de lignes, l’espace disque réservé et l’espace disque utilisé pour une table spécifique ou pour toutes les tables dans une base de données Azure Synapse Analytics ou Analytics Platform System (PDW).

Conventions de la syntaxe Transact-SQL

Syntaxe

-- 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 ]
[;]

Notes

Cette syntaxe n’est pas prise en charge par le pool SQL serverless dans Azure Synapse Analytics.

Arguments

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

Nom en une, deux ou trois parties de la table à afficher. Les noms de table en deux ou trois parties doivent être placés entre guillemets doubles (""). L’utilisation de guillemets autour d’un nom de table en une partie est facultative. Quand aucun nom de table n’est spécifié, les informations s’affichent pour la base de données actuelle.

WITH IGNORE_REPLICATED_TABLE_CACHE

Paramètre facultatif permettant d’afficher la taille de la table sans inclure la taille du cache de la table répliquée. La taille du cache de la table répliquée varie en fonction de l’objectif de niveau de service. Pour plus d’informations, consultez Qu’est-ce qu’une table répliquée?

Autorisations

Nécessite l’autorisation VIEW SERVER STATE.

Notes

Il existe également des vues de gestion dynamique (DMV) pour fournir des requêtes plus personnalisables pour la taille de table. Pour plus d’informations, consultez requêtes de taille de table.

Jeux de résultats

Voici l'ensemble des résultats pour toutes les tables Avant de créer un cache pour une table Synapse répliquée, le résultat DBCC reflète la taille totale de la table de tourniquet (round robin) sous-jacente à partir de chaque distribution. Une fois le cache créé, le résultat reflète la taille totale des tables de tourniquet (round robin) et du cache.

Colonne Type de données Description
reserved_space bigint Espace total utilisé pour la base de données, en Ko.
data_space bigint Espace utilisé pour les données, en Ko.
index_space bigint Espace utilisé pour les index, en Ko.
unused_space bigint Espace qui fait partie de l’espace réservé et non utilisé, en Ko.
pdw_node_id int Nœud de calcul qui est utilisé pour les données.

Voici le jeu de résultats pour une table.

Colonne Type de données Description Plage
rows bigint Nombre de lignes.
reserved_space bigint Espace total réservé pour l’objet, en Ko.
data_space bigint Espace utilisé pour les données, en Ko.
index_space bigint Espace utilisé pour les index, en Ko.
unused_space bigint Espace qui fait partie de l’espace réservé et non utilisé, en Ko.
pdw_node_id int Nœud de calcul qui est utilisé pour signaler l’utilisation de l’espace.
distribution_id int Distribution qui est utilisée pour signaler l’utilisation de l’espace. Pour Parallel Data Warehouse, sa valeur est -1 pour les tables répliquées.

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

R. Syntaxe de base de DBCC PDW_SHOWSPACEUSED

Les exemples suivants utilisant l’exemple de base de données AdventureWorks2022 montrent plusieurs façons d’afficher le nombre de lignes, l’espace disque réservé et l’espace disque utilisé par la table FactInternetSales dans la base de données AdventureWorksPDW2022.

-- Uses AdventureWorks2022

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

B. Afficher l’espace disque utilisé par toutes les tables dans la base de données actuelle

L’exemple suivant utilisant l’exemple de base de données AdventureWorks2022 montre l’espace disque réservé et utilisé par toutes les tables utilisateur et les tables système de la base de données AdventureWorksPDW2022.

-- Uses AdventureWorks2022  
DBCC PDW_SHOWSPACEUSED;

Étapes suivantes