sys.dm_os_volume_stats (Transact-SQL)sys.dm_os_volume_stats (Transact-SQL)

S’APPLIQUE À : ouiSQL Server (à partir de 2008) nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retourne les informations relatives au volume du système d'exploitation (répertoire) sur lequel les bases de données et fichiers spécifiés sont stockés dans SQL ServerSQL Server.Returns information about the operating system volume (directory) on which the specified databases and files are stored in SQL ServerSQL Server. Utilisez cette fonction de gestion dynamique pour vérifier les attributs du lecteur de disque physique ou retourner les informations relatives à l'espace disque disponible pour le répertoire.Use this dynamic management function to check the attributes of the physical disk drive or return available free space information about the directory.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

sys.dm_os_volume_stats (database_id, file_id)  

ArgumentsArguments

database_iddatabase_id
ID de la base de données.ID of the database. database_id est de type int, sans valeur par défaut.database_id is int, with no default. Ne peut pas avoir la valeur NULL.Cannot be NULL.

file_idfile_id
ID du fichier.ID of the file. FILE_ID est int, sans valeur par défaut.file_id is int, with no default. Ne peut pas avoir la valeur NULL.Cannot be NULL.

Table retournéeTable Returned

ColonneColumn Data typeData type DescriptionDescription
database_iddatabase_id Intint ID de la base de données.ID of the database. Ne peut pas avoir la valeur null.Cannot be null.
file_idfile_id Intint ID du fichier.ID of the file. Ne peut pas avoir la valeur null.Cannot be null.
volume_mount_pointvolume_mount_point nvarchar(512)nvarchar(512) Point de montage à la racine duquel le volume est attaché.Mount point at which the volume is rooted. Peut retourner une chaîne vide.Can return an empty string.
volume_idvolume_id nvarchar(512)nvarchar(512) Identificateur du volume du système d'exploitation.Operating system volume ID. Peut retourner une chaîne videCan return an empty string
logical_volume_namelogical_volume_name nvarchar(512)nvarchar(512) Nom du volume logique.Logical volume name. Peut retourner une chaîne videCan return an empty string
file_system_typefile_system_type nvarchar(512)nvarchar(512) Type du volume du système de fichiers (par exemple, NTFS, FAT, RAW).Type of file system volume (for example, NTFS, FAT, RAW). Peut retourner une chaîne videCan return an empty string
total_bytestotal_bytes bigintbigint Taille totale (en octets) du volume.Total size in bytes of the volume. Ne peut pas avoir la valeur null.Cannot be null.
available_bytesavailable_bytes bigintbigint Espace disponible sur le volume.Available free space on the volume. Ne peut pas avoir la valeur null.Cannot be null.
supports_compressionsupports_compression bitbit Indique si le volume prend en charge la compression du système d'exploitation.Indicates if the volume supports operating system compression. Ne peut pas avoir la valeur null.Cannot be null.
supports_alternate_streamssupports_alternate_streams bitbit Indique si le volume prend en charge les flux de remplacement.Indicates if the volume supports alternate streams. Ne peut pas avoir la valeur null.Cannot be null.
supports_sparse_filessupports_sparse_files bitbit Indique si le volume prend en charge les fichiers partiellement alloués.Indicates if the volume supports sparse files. Ne peut pas avoir la valeur null.Cannot be null.
is_read_onlyis_read_only bitbit Indique si le volume est actuellement marqué comme étant en lecture seule.Indicates if the volume is currently marked as read only. Ne peut pas avoir la valeur null.Cannot be null.
is_compressedis_compressed bitbit Indique si ce volume est actuellement compressé.Indicates if this volume is currently compressed. Ne peut pas avoir la valeur null.Cannot be null.

SécuritéSecurity

AutorisationsPermissions

Requiert l'autorisation VIEW SERVER STATE.Requires VIEW SERVER STATE permission.

ExemplesExamples

A.A. Retour de l'espace total et de l'espace disponible pour tous les fichiers de base de donnéesReturn total space and available space for all database files

L'exemple suivant retourne l'espace total et l'espace disponible (en octets) pour tous les fichiers de base de données dans l'instance de SQL ServerSQL Server.The following example returns the total space and available space (in bytes) for all database files in the instance of SQL ServerSQL Server.

SELECT f.database_id, f.file_id, volume_mount_point, total_bytes, available_bytes  
FROM sys.master_files AS f  
CROSS APPLY sys.dm_os_volume_stats(f.database_id, f.file_id);  

B.B. Retour de l'espace total et de l'espace disponible pour la base de donnée actuelleReturn total space and available space for the current database

L'exemple suivant retourne l'espace total et l'espace disponible (en octets) pour les fichiers de base de données dans la base de données actuelle.The following example returns the total space and available space (in bytes) for the database files in the current database.

SELECT database_id, f.file_id, volume_mount_point, total_bytes, available_bytes  
FROM sys.database_files AS f  
CROSS APPLY sys.dm_os_volume_stats(DB_ID(f.name), f.file_id);  

Voir aussiSee Also

sys.master_files (Transact-SQL) sys.master_files (Transact-SQL)
sys.database_files (Transact-SQL)sys.database_files (Transact-SQL)