DBCC PDW_SHOWSPACEUSED (Transact-SQL)
S’applique à: 
Azure Synapse Analytics Analytics 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;