sys.dm_os_volume_stats (Transact-SQL)

Aplica-se a:SQL Server

Retorna informações sobre o volume do sistema operacional (diretório) no qual os bancos de dados e arquivos especificados são armazenados no SQL Server. Use essa função de gerenciamento dinâmico para verificar os atributos do disco físico ou devolver informações disponíveis no espaço livre sobre o diretório.

Convenções de sintaxe de Transact-SQL

Syntax

sys.dm_os_volume_stats (database_id , file_id)

Argumentos

database_id

ID do banco de dados. database_id é int, sem padrão. Não pode ser NULL.

file_id

ID do ficheiro. file_id é int, sem padrão. Não pode ser NULL.

Tabela retornada

Coluna Tipo de dados Descrição
database_id int ID do banco de dados. Não é anulável.
file_id int ID do ficheiro. Não é anulável.
volume_mount_point nvarchar(512) Ponto de montagem onde o volume está enraizado. Pode devolver uma corda vazia. Retorna null no Linux.
volume_id nvarchar(512) ID de volume do sistema operacional. Pode devolver uma corda vazia. Retorna null no Linux.
logical_volume_name nvarchar(512) Nome lógico do volume. Pode devolver uma corda vazia. Retorna null no Linux.
file_system_type nvarchar(512) Tipo de volume do sistema de arquivos (por exemplo, NTFS, FAT, RAW). Pode devolver uma corda vazia. Retorna null no Linux.
total_bytes bigint Tamanho total em bytes do volume. Não é anulável.
available_bytes bigint Espaço disponível disponível no volume. Não é anulável.
supports_compression tinyint Indica se o volume suporta compressão do sistema operacional. Não é nullável no Windows, e retorna null no Linux.
supports_alternate_streams tinyint Indica se o volume suporta fluxos alternativos. Não é nullável no Windows, e retorna null no Linux.
supports_sparse_files tinyint Indica se o volume suporta arquivos esparsos. Não é nullável no Windows, e retorna null no Linux.
is_read_only tinyint Indica se o volume está atualmente marcado como somente leitura. Não é anulável.
is_compressed tinyint Indica se esse volume está atualmente comprimido. Não é nullável no Windows, e retorna null no Linux.
incurs_seek_penalty tinyint Indica o tipo de armazenamento que suporta esse volume. Os valores possíveis são:

0: Sem penalidade de busca neste volume, normalmente quando o dispositivo de armazenamento é PMM ou SSD

1: Penalidade de busca nesse volume, normalmente quando o dispositivo de armazenamento é HDD

2: O tipo de armazenamento não pode ser determinado quando o volume está em um caminho UNC ou em ações montadas

NULL: O tipo de armazenamento não pode ser determinado no sistema operacional Linux

Aplica-se a: SQL Server 2019 (15.x) e versões posteriores

Permissions

O SQL Server 2019 (15.x) e versões anteriores exigem VIEW SERVER STATE permissão no servidor.

O SQL Server 2022 (16.x) e versões posteriores exigem VIEW SERVER PERFORMANCE STATE permissão no servidor.

Examples

A. Devolver espaço total e espaço disponível para todos os arquivos do banco de dados

O exemplo a seguir retorna o espaço total e o espaço disponível (em bytes) para todos os arquivos de banco de dados na instância do SQL 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. Devolver espaço total e espaço disponível para o banco de dados atual

O exemplo a seguir retorna o espaço total e o espaço disponível (em bytes) para os arquivos de banco de dados no banco de dados atual.

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.file_id);

Conteúdo relacionado

  • Last updated on