sp_spaceused (Transact-SQL)
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)
O sp_spaceused procedimento armazenado do sistema exibe:
o número de linhas, espaço em disco reservado e espaço em disco usado por uma tabela, modo de exibição indexado ou fila do Service Broker no banco de dados atual
o espaço em disco reservado e usado por todo o banco de dados
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_spaceused
[ [ @objname = ] N'objname' ]
[ , [ @updateusage = ] 'updateusage' ]
[ , [ @mode = ] 'mode' ]
[ , [ @oneresultset = ] oneresultset ]
[ , [ @include_total_xtp_storage = ] include_total_xtp_storage ]
[ ; ]
Observação
Não há suporte a essa sintaxe para o pool de SQL sem servidor no Azure Synapse Analytics.
Argumentos
Para o Azure Synapse Analytics and Analytics Platform System (PDW), sp_spaceused deve especificar parâmetros nomeados (por exemplo sp_spaceused (@objname= N'Table1');), em vez de depender da posição ordinal dos parâmetros.
@objname [ = ] N'objname'
O nome qualificado ou não qualificado da tabela, do modo de exibição indexado ou da fila para a qual as informações de uso de espaço são solicitadas. @objname é nvarchar(776), com um padrão de NULL. As aspas são obrigatórias apenas se um nome de objeto qualificado for especificado. Se um nome de objeto totalmente qualificado (incluindo um nome de banco de dados) for fornecido, o nome de banco de dados deve ser o nome do banco de dados atual.
Se @objname não for especificado, os resultados serão retornados para todo o banco de dados.
Observação
O Azure Synapse Analytics and Analytics Platform System (PDW) oferece suporte apenas a objetos de banco de dados e tabela.
@updateusage [ = ] 'updateusage'
Indica DBCC UPDATEUSAGE que deve ser executado para atualizar as informações de uso do espaço. @updateusage é varchar(5), com um padrão de false. Quando @objname não é especificado, a instrução é executada em todo o banco de dados. Caso contrário, a instrução será executada em @objname. Os valores podem ser true ou false.
@mode [ = ] 'modo'
Indica o escopo dos resultados. Para uma tabela ou banco de dados estendido, o parâmetro @mode permite incluir ou excluir a parte remota do objeto. Para obter mais informações, consulte Stretch Database.
Importante
O banco de dados de ampliação foi preterido no SQL Server 2022 (16.x) e no Banco de Dados SQL do Azure. Esse recurso será removido em uma versão futura do mecanismo de banco de dados. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.
@mode é varchar(11) e pode ser um desses valores.
| Valor | Descrição |
|---|---|
ALL (padrão) |
Retorna as estatísticas de armazenamento do objeto ou banco de dados, incluindo a parte local e a parte remota. |
LOCAL_ONLY |
Retorna as estatísticas de armazenamento somente da parte local do objeto ou banco de dados. Se o objeto ou banco de dados não estiver habilitado para Stretch, retornará as mesmas estatísticas de quando @mode é ALL. |
REMOTE_ONLY |
Retorna as estatísticas de armazenamento somente da parte remota do objeto ou banco de dados. Essa opção gera um erro quando uma das seguintes condições for verdadeira: A tabela não está habilitada para o Stretch. A tabela está habilitada para Stretch, mas você nunca habilitou a migração de dados. Nesse caso, a tabela remota ainda não tem um esquema. O usuário descartou manualmente a tabela remota. O provisionamento do arquivamento de dados remoto retornou um status de Êxito, mas na verdade falhou. |
@oneresultset [ = ] umResultSet
Indica se um único conjunto de resultados deve ser retornado. @oneresultset é bit e pode ser um destes valores:
| Valor | Descrição |
|---|---|
0 (padrão) |
Quando @objname é nulo ou não é especificado, dois conjuntos de resultados são retornados. |
1 |
Quando @objname é NULL ou não especificado, um único conjunto de resultados é retornado. |
@include_total_xtp_storage [ = ] include_total_xtp_storage
Aplica-se a: SQL Server 2017 (14.x) e versões posteriores e Banco de dados SQL
Quando @oneresultset é definido como 1, esse parâmetro determina se o conjunto de resultados único inclui colunas para MEMORY_OPTIMIZED_DATA armazenamento. @include_total_xtp_storage é bit, com um padrão de 0. Se 1, as colunas XTP forem incluídas no conjunto de resultados.
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Conjunto de resultados
Se @objname for omitido e o valor de @oneresultset for 0, os seguintes conjuntos de resultados serão retornados para fornecer informações sobre o tamanho atual do banco de dados.
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
database_name |
nvarchar(128) | Nome do banco de dados atual. |
database_size |
varcar(18) | Tamanho do banco de dados atual em megabytes. database_size Inclui arquivos de dados e de log. |
unallocated space |
varcar(18) | Espaço no banco de dados que não está reservado para objetos de banco de dados. |
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
reserved |
varcar(18) | Total de espaço alocado por objetos no banco de dados. |
data |
varcar(18) | Total de espaço usado por dados. |
index_size |
varcar(18) | Total de espaço usado por índices. |
unused |
varcar(18) | Total de espaço reservado para objetos no banco de dados, mas ainda não usado. |
Se @objname for omitido e o valor de @oneresultset for 1, o conjunto de resultados único a seguir será retornado para fornecer informações sobre o tamanho atual do banco de dados.
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
database_name |
nvarchar(128) | Nome do banco de dados atual. |
database_size |
varcar(18) | Tamanho do banco de dados atual em megabytes. database_size Inclui arquivos de dados e de log. |
unallocated space |
varcar(18) | Espaço no banco de dados que não está reservado para objetos de banco de dados. |
reserved |
varcar(18) | Total de espaço alocado por objetos no banco de dados. |
data |
varcar(18) | Total de espaço usado por dados. |
index_size |
varcar(18) | Total de espaço usado por índices. |
unused |
varcar(18) | Total de espaço reservado para objetos no banco de dados, mas ainda não usado. |
Se @objname for especificado, o seguinte conjunto de resultados será retornado para o objeto especificado.
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
name |
nvarchar(128) | Nome do objeto para o qual foram solicitadas informações de uso do espaço. O nome do esquema do objeto não é retornado. Se o nome do esquema for necessário, use as exibições de gerenciamento dinâmico sys.dm_db_partition_stats ou sys.dm_db_index_physical_stats para obter informações de tamanho equivalente. |
rows |
Char(20) | Número de linhas existentes na tabela. Se o objeto especificado for uma fila do Service Broker, essa coluna indicará o número de mensagens na fila. |
reserved |
varcar(18) | Quantidade total de espaço reservado para @objname. |
data |
varcar(18) | Quantidade total de espaço usado pelos dados em @objname. |
index_size |
varcar(18) | Quantidade total de espaço usado pelos índices em @objname. |
unused |
varcar(18) | Quantidade total de espaço reservado para @objname mas ainda não utilizado. |
Esse modo é o padrão, quando nenhum parâmetro é especificado. Os conjuntos de resultados a seguir são retornados detalhando informações de tamanho do banco de dados em disco.
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
database_name |
nvarchar(128) | Nome do banco de dados atual. |
database_size |
varcar(18) | Tamanho do banco de dados atual em megabytes. database_size Inclui arquivos de dados e de log. Se o banco de dados tiver um MEMORY_OPTIMIZED_DATA grupo de arquivos, esse valor incluirá o tamanho total no disco de todos os arquivos de ponto de verificação no grupo de arquivos. |
unallocated space |
varcar(18) | Espaço no banco de dados que não está reservado para objetos de banco de dados. Se o banco de dados tiver um MEMORY_OPTIMIZED_DATA grupo de arquivos, esse valor incluirá o tamanho total no disco dos arquivos de ponto de verificação com estado PRECREATED no grupo de arquivos. |
Espaço usado por tabelas no banco de dados. Esse conjunto de resultados não reflete tabelas otimizadas para memória, pois não há contabilização por tabela do uso do disco:
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
reserved |
varcar(18) | Total de espaço alocado por objetos no banco de dados. |
data |
varcar(18) | Total de espaço usado por dados. |
index_size |
varcar(18) | Total de espaço usado por índices. |
unused |
varcar(18) | Total de espaço reservado para objetos no banco de dados, mas ainda não usado. |
O conjunto de resultados a seguir será retornado somente se o banco de dados tiver um grupo de MEMORY_OPTIMIZED_DATA arquivos com pelo menos um contêiner:
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
xtp_precreated |
varcar(18) | Tamanho total dos arquivos de ponto de verificação com estado PRECREATED, em KB. Conta para o espaço não alocado no banco de dados como um todo. Por exemplo, se houver 600.000 KB de arquivos de ponto de verificação pré-criados, essa coluna conterá 600000 KB. |
xtp_used |
varcar(18) | Tamanho total dos arquivos de ponto de verificação com estados UNDER CONSTRUCTION, ACTIVEe MERGE TARGET, em KB. Esse valor é o espaço em disco usado ativamente para dados em tabelas otimizadas para memória. |
xtp_pending_truncation |
varcar(18) | Tamanho total dos arquivos de ponto de verificação com estado WAITING_FOR_LOG_TRUNCATION, em KB. Esse valor é o espaço em disco usado para arquivos de ponto de verificação que estão aguardando limpeza, uma vez que o truncamento de log acontece. |
Se @objname for omitido, o valor de @oneresultset será 1, e @include_total_xtp_storage for 1, o conjunto de resultados único a seguir será retornado para fornecer informações sobre o tamanho atual do banco de dados. Se @include_total_xtp_storage for 0 (o padrão), as três últimas colunas serão omitidas.
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
database_name |
nvarchar(128) | Nome do banco de dados atual. |
database_size |
varcar(18) | Tamanho do banco de dados atual em megabytes. database_size Inclui arquivos de dados e de log. Se o banco de dados tiver um MEMORY_OPTIMIZED_DATA grupo de arquivos, esse valor incluirá o tamanho total no disco de todos os arquivos de ponto de verificação no grupo de arquivos. |
unallocated space |
varcar(18) | Espaço no banco de dados que não está reservado para objetos de banco de dados. Se o banco de dados tiver um MEMORY_OPTIMIZED_DATA grupo de arquivos, esse valor incluirá o tamanho total no disco dos arquivos de ponto de verificação com estado PRECREATED no grupo de arquivos. |
reserved |
varcar(18) | Total de espaço alocado por objetos no banco de dados. |
data |
varcar(18) | Total de espaço usado por dados. |
index_size |
varcar(18) | Total de espaço usado por índices. |
unused |
varcar(18) | Total de espaço reservado para objetos no banco de dados, mas ainda não usado. |
xtp_precreated1 |
varcar(18) | Tamanho total dos arquivos de ponto de verificação com estado PRECREATED, em KB. Esse valor conta para o espaço não alocado no banco de dados como um todo. Retorna NULL se o banco de dados não tiver um MEMORY_OPTIMIZED_DATA grupo de arquivos com pelo menos um contêiner. |
xtp_used1 |
varcar(18) | Tamanho total dos arquivos de ponto de verificação com estados UNDER CONSTRUCTION, ACTIVEe MERGE TARGET, em KB. Esse valor é o espaço em disco usado ativamente para dados em tabelas otimizadas para memória. Retorna NULL se o banco de dados não tiver um MEMORY_OPTIMIZED_DATA grupo de arquivos com pelo menos um contêiner. |
xtp_pending_truncation1 |
varcar(18) | Tamanho total dos arquivos de ponto de verificação com estado WAITING_FOR_LOG_TRUNCATION, em KB. Esse valor é o espaço em disco usado para arquivos de ponto de verificação que estão aguardando limpeza, uma vez que o truncamento de log acontece. Retorna NULL se o banco de dados não tiver um MEMORY_OPTIMIZED_DATA grupo de arquivos com pelo menos um contêiner. |
1 Incluído somente se @include_total_xtp_storage estiver definido como 1.
Comentários
O database_size valor geralmente é maior do que a soma de porque inclui o tamanho dos arquivos de log, mas reserved considera unallocated_space apenas páginas de reserved + unallocated space dados. Em alguns casos com o Azure Synapse Analytics, essa declaração pode não ser verdadeira.
As páginas usadas por índices XML e índices de texto completo são incluídas em index_size ambos os conjuntos de resultados. Quando @objname é especificado, as páginas para os índices XML e índices de texto completo para o objeto também são contadas no total reserved e index_size nos resultados.
Se o uso de espaço for calculado para um banco de dados ou um objeto que seja um índice espacial, as colunas de tamanho de espaço, como database_size, reservede index_size, incluirão o tamanho do índice espacial.
Quando @updateusage é especificado, o Mecanismo de Banco de Dados do SQL Server verifica as páginas de dados no banco de dados e faz as correções necessárias nas sys.allocation_units exibições de catálogo e sys.partitions no espaço de armazenamento usado por cada tabela. Há algumas situações, por exemplo, depois que um índice é descartado, quando as informações de espaço para a tabela podem não ser atuais. @updateusage pode levar algum tempo para ser executado em grandes tabelas ou bancos de dados. Use @updateusage somente quando suspeitar que valores incorretos estão sendo retornados e quando o processo não tiver um efeito adverso em outros usuários ou processos no banco de dados. Se preferir, DBCC UPDATEUSAGE pode ser executado separadamente.
Observação
Quando você descarta ou reconstrói índices grandes, ou descarta ou trunca tabelas grandes, o Mecanismo de Banco de Dados adia as desalocações de página atuais e seus bloqueios associados, até depois que a transação confirme. As operações de queda adiada não liberam o espaço alocado imediatamente. Portanto, os valores retornados imediatamente sp_spaceused após soltar ou truncar um objeto grande podem não refletir o espaço em disco real disponível.
Permissões
A permissão para executar sp_spaceused é concedida à função pública . Somente os membros da função de banco de dados fixa db_owner podem especificar o parâmetro @updateusage.
Exemplos
R. Exibir informações de espaço em disco sobre uma tabela
O exemplo a seguir relata informações de espaço em disco para a tabela Vendor e seus índices.
USE AdventureWorks2022;
GO
EXEC sp_spaceused N'Purchasing.Vendor';
GO
B. Exibir informações de espaço atualizadas sobre um banco de dados
O exemplo a seguir resume o espaço usado no banco de dados atual e usa o parâmetro opcional @updateusage para garantir que os valores atuais sejam retornados.
USE AdventureWorks2022;
GO
EXEC sp_spaceused @updateusage = N'TRUE';
GO
C. Exibir informações de uso de espaço sobre a tabela remota associada a uma tabela habilitada para Stretch
O exemplo a seguir resume o espaço usado pela tabela remota associada a uma tabela habilitada para Stretch usando o argumento @mode para especificar o destino remoto. Saiba mais em Stretch Database.
USE StretchedAdventureWorks2022;
GO
EXEC sp_spaceused N'Purchasing.Vendor', @mode = 'REMOTE_ONLY';
D. Exibir informações de uso de espaço para um banco de dados em um único conjunto de resultados
O exemplo a seguir resume o uso de espaço para o banco de dados atual em um único conjunto de resultados.
USE AdventureWorks2022;
GO
EXEC sp_spaceused @oneresultset = 1;
E. Exibir informações de uso de espaço para um banco de dados com pelo menos um grupo de arquivos MEMORY_OPTIMIZED em um único conjunto de resultados
O exemplo a seguir resume o uso de espaço para o banco de dados atual com pelo menos um MEMORY_OPTIMIZED grupo de arquivos em um único conjunto de resultados.
USE WideWorldImporters
GO
EXEC sp_spaceused @updateusage = 'FALSE',
@mode = 'ALL',
@oneresultset = '1',
@include_total_xtp_storage = '1';
GO
F. Exibir informações de uso de espaço para um objeto de tabela MEMORY_OPTIMIZED em um banco de dados
O exemplo a seguir resume o uso de espaço para um MEMORY_OPTIMIZED objeto de tabela no banco de dados atual com pelo menos um MEMORY_OPTIMIZED grupo de arquivos.
USE WideWorldImporters
GO
EXEC sp_spaceused @objname = N'VehicleTemparatures',
@updateusage = 'FALSE',
@mode = 'ALL',
@oneresultset = '0',
@include_total_xtp_storage = '1';
GO
Conteúdo relacionado
- 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)
- Procedimentos armazenados do sistema (Transact-SQL)
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de