sp_spaceused (Transact-SQL)

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

La sp_spaceused procédure stockée système affiche les éléments suivants :

• nombre de lignes, d’espace disque réservé et d’espace disque utilisé par une table, une vue indexée ou une file d’attente Service Broker dans la base de données active

• l’espace disque réservé et utilisé par l’ensemble de la base de données

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_spaceused
    [ [ @objname = ] N'objname' ]
    [ , [ @updateusage = ] 'updateusage' ]
    [ , [ @mode = ] 'mode' ]
    [ , [ @oneresultset = ] oneresultset ]
    [ , [ @include_total_xtp_storage = ] include_total_xtp_storage ]
[ ; ]

Arguments

Pour Azure Synapse Analytics and Analytics Platform System (PDW), doit spécifier des paramètres nommés (par exemplesp_spaceused (@objname= N'Table1');), sp_spaceused plutôt que de compter sur la position ordinale des paramètres.

[ @objname = ] N’objname'

Nom qualifié ou non qualifié de la table, de la vue indexée ou de la file d’attente pour laquelle les informations d’utilisation de l’espace sont demandées. @objname est nvarchar(776), avec la valeur par défaut NULL. Les guillemets ne sont nécessaires que si un nom d'objet qualifié est spécifié. Si un nom d'objet complet (incluant un nom de base de données) est fourni, le nom de la base de données doit être celui de la base de données actuelle.

Si @objname n’est pas spécifié, les résultats sont retournés pour l’ensemble de la base de données.

[ @updateusage = ] 'updateusage'

Indique qu’il DBCC UPDATEUSAGE doit être exécuté pour mettre à jour les informations d’utilisation de l’espace. @updateusage est varchar(5), avec la valeur par défaut false. Quand @objname n’est pas spécifié, l’instruction est exécutée sur l’ensemble de la base de données. Sinon, l’instruction est exécutée sur @objname. Les valeurs peuvent être true ou false.

[ @mode = ] 'mode'

Indique l’étendue des résultats. Pour une table ou une base de données étirée, le paramètre @mode vous permet d’inclure ou d’exclure la partie distante de l’objet. Pour plus d'informations, consultez Stretch Database.

@mode est varchar(11) et peut être l’une de ces valeurs.

[ @oneresultset = ] oneresultset

Indique s’il faut retourner un jeu de résultats unique. @oneresultset est bit et peut être l’une des valeurs suivantes :

[ @include_total_xtp_storage = ] include_total_xtp_storage

S’applique à : SQL Server 2017 (14.x) et versions ultérieures, et SQL Database

Lorsque @oneresultset est défini 1sur , ce paramètre détermine si le jeu de résultats unique inclut des colonnes pour MEMORY_OPTIMIZED_DATA le stockage. @include_total_xtp_storage est bit, avec la valeur par défaut 0. Si 1, les colonnes XTP sont incluses dans le jeu de résultats.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu de résultats

Si @objname est omis et que la valeur de @oneresultset est 0, les jeux de résultats suivants sont retournés pour fournir des informations de taille de base de données actuelles.

Si @objname est omise et que la valeur de @oneresultset est 1, le jeu de résultats unique suivant est retourné pour fournir des informations de taille de base de données actuelles.

Si @objname est spécifié, le jeu de résultats suivant est retourné pour l’objet spécifié.

Ce mode est la valeur par défaut, lorsqu’aucun paramètre n’est spécifié. Les jeux de résultats suivants sont retournés en détail des informations de taille de base de données sur disque.

Espace utilisé par les tables de la base de données. Ce jeu de résultats ne reflète pas les tables optimisées en mémoire, car il n’existe aucune comptabilité par table de l’utilisation du disque :

Le jeu de résultats suivant est retourné uniquement si la base de données a un MEMORY_OPTIMIZED_DATA groupe de fichiers avec au moins un conteneur :

Si @objname est omis, la valeur de @oneresultset est 1, et @include_total_xtp_storage est 1, le jeu de résultats unique suivant est retourné pour fournir les informations de taille de base de données actuelles. Si @include_total_xtp_storage est 0 (valeur par défaut), les trois dernières colonnes sont omises.

¹ Inclus uniquement si @include_total_xtp_storage est défini sur 1.

Notes

La database_size valeur est généralement supérieure à la somme du reserved + unallocated space fait qu’elle inclut la taille des fichiers journaux, mais reserved elle unallocated_space ne prend en compte que les pages de données. Dans certains cas avec Azure Synapse Analytics, cette instruction peut ne pas être vraie.

Les pages utilisées par les index XML et les index de recherche en texte intégral sont incluses dans index_size les deux jeux de résultats. Lorsque @objname est spécifié, les pages des index XML et des index de recherche en texte intégral pour l’objet sont également comptabilisées dans le total reserved et index_size les résultats.

Si l’utilisation de l’espace est calculée pour une base de données ou un objet qui est un index spatial, les colonnes de taille d’espace, telles que database_size, reservedet index_size, incluent la taille de l’index spatial.

Lorsque @updateusage est spécifié, sql Server Moteur de base de données analyse les pages de données de la base de données et apporte toutes les corrections requises aux vues du catalogue et sys.partitions de l’espace sys.allocation_units de stockage utilisé par chaque table. Il existe certaines situations, par exemple, une fois qu’un index est supprimé, lorsque les informations d’espace de la table peuvent ne pas être actuelles. @updateusage peut prendre un certain temps pour s’exécuter sur des tables ou des bases de données volumineuses. Utilisez @updateusage uniquement lorsque vous soupçonnez que des valeurs incorrectes sont retournées et lorsque le processus n’a pas d’effet négatif sur d’autres utilisateurs ou processus de la base de données. Si vous le préférez, DBCC UPDATEUSAGE vous pouvez l’exécuter séparément.

autorisations

L’autorisation d’exécution sp_spaceused est accordée au rôle public . Seuls les membres du rôle de base de données fixe db_owner peuvent spécifier la paramètre @updateusage .

Exemples

R. Afficher des informations sur l’espace disque sur une table

L'exemple qui suit donne des informations sur l'espace disque pour la table Vendor et ses index.

USE AdventureWorks2022;
GO
EXEC sp_spaceused N'Purchasing.Vendor';
GO

B. Afficher les informations d’espace mises à jour sur une base de données

L’exemple suivant récapitule l’espace utilisé dans la base de données active et utilise le paramètre facultatif @updateusage pour vous assurer que les valeurs actuelles sont retournées.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @updateusage = N'TRUE';
GO

C. Afficher les informations d’utilisation de l’espace sur la table distante associée à une table stretch

L’exemple suivant récapitule l’espace utilisé par la table distante associée à une table Stretch à l’aide de l’argument @mode pour spécifier la cible distante. Pour plus d'informations, consultez Stretch Database.

USE StretchedAdventureWorks2022;
GO

EXEC sp_spaceused N'Purchasing.Vendor', @mode = 'REMOTE_ONLY';

D. Afficher les informations d’utilisation de l’espace pour une base de données dans un jeu de résultats unique

L’exemple suivant récapitule l’utilisation de l’espace pour la base de données active dans un jeu de résultats unique.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @oneresultset = 1;

E. Afficher les informations d’utilisation de l’espace pour une base de données avec au moins un groupe de fichiers MEMORY_OPTIMIZED dans un jeu de résultats unique

L’exemple suivant récapitule l’utilisation de l’espace pour la base de données active avec au moins un MEMORY_OPTIMIZED groupe de fichiers dans un jeu de résultats unique.

USE WideWorldImporters
GO

EXEC sp_spaceused @updateusage = 'FALSE',
    @mode = 'ALL',
    @oneresultset = '1',
    @include_total_xtp_storage = '1';
GO

F. Afficher les informations d’utilisation de l’espace pour un objet table MEMORY_OPTIMIZED dans une base de données

L’exemple suivant récapitule l’utilisation de l’espace pour un MEMORY_OPTIMIZED objet table dans la base de données active avec au moins un MEMORY_OPTIMIZED groupe de fichiers.

USE WideWorldImporters
GO

EXEC sp_spaceused @objname = N'VehicleTemperatures',
    @updateusage = 'FALSE',
    @mode = 'ALL',
    @oneresultset = '0',
    @include_total_xtp_storage = '1';
GO

Contenu connexe

• CREATE INDEX (Transact-SQL)
• CREATE TABLE (Transact-SQL)
• DBCC UPDATEUSAGE (Transact-SQL)
• Service Broker
• sys.allocation_units (Transact-SQL)
• sys.indexes (Transact-SQL)
• sys.index_columns (Transact-SQL)
• sys.objects (Transact-SQL)
• sys.partitions (Transact-SQL)
• Procédures stockées système (Transact-SQL)