Partilhar via

sys.dm_os_volume_stats (Transact-SQL)

  • Artigo

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 esta função de gerenciamento dinâmico para verificar os atributos da unidade de disco físico ou retornar informações de espaço livre disponíveis sobre o diretório.

Transact-SQL convenções de sintaxe

Sintaxe

sys.dm_os_volume_stats (database_id , file_id)

Argumentos

database_id

ID da base 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 da base de dados. Não anulável.
file_id int ID do ficheiro. Não anulável.
volume_mount_point nvarchar(512) Ponto de montagem no qual o volume está enraizado. Pode retornar uma cadeia de caracteres vazia. Retorna null no Linux.
volume_id nvarchar(512) ID do volume do sistema operacional. Pode retornar uma cadeia de caracteres vazia. Retorna null no Linux.
logical_volume_name nvarchar(512) Nome do volume lógico. Pode retornar uma cadeia de caracteres vazia. Retorna null no Linux.
file_system_type nvarchar(512) Tipo de volume do sistema de arquivos (por exemplo, NTFS, FAT, RAW). Pode retornar uma cadeia de caracteres vazia. Retorna null no Linux.
total_bytes bigint Tamanho total em bytes do volume. Não anulável.
available_bytes bigint Espaço livre disponível no volume. Não anulável.
supports_compression minúsculo Indica se o volume suporta a compactação do sistema operacional. Não anulável no Windows e retorna null no Linux.
supports_alternate_streams minúsculo Indica se o volume suporta fluxos alternativos. Não anulável no Windows e retorna null no Linux.
supports_sparse_files minúsculo Indica se o volume suporta arquivos esparsos. Não anulável no Windows e retorna null no Linux.
is_read_only minúsculo Indica se o volume está atualmente marcado como somente leitura. Não anulável.
is_compressed minúsculo Indica se esse volume está compactado no momento. Não anulável no Windows e retorna null no Linux.
incurs_seek_penalty minúsculo Indica o tipo de armazenamento que suporta este volume. Os valores possíveis são:

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

1: Procurar penalidade sobre este 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 compartilhamentos montados

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

Permissões

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

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

Exemplos

Um. Retornar espaço total e espaço disponível para todos os arquivos de 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. Retornar 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