DBCC PDW_SHOWSPACEUSED (Transact-SQL)

Aplica-se a:Azure Synapse Analytics

Exibe o número de linhas, espaço em disco reservado e espaço em disco usado para uma tabela específica, ou para todas as tabelas em um banco de dados do Azure Synapse Analytics.

Convenções de sintaxe Transact-SQL

Sintaxe

-- Show the space used for all user tables and system tables in the current database
DBCC PDW_SHOWSPACEUSED [ WITH IGNORE_REPLICATED_TABLE_CACHE ]
[;]

-- Show the space used for a table
DBCC PDW_SHOWSPACEUSED ( "[ database_name . [ schema_name ] . ] | [ schema_name . ] table_name" ) [ WITH IGNORE_REPLICATED_TABLE_CACHE ]
[;]

Observação

Não há suporte a essa sintaxe para o pool de SQL sem servidor no Azure Synapse Analytics.

Argumentos

"[ database_name . [ schema_name ]. | schema_name . ] table_name"

O nome de uma, duas ou três partes da tabela a ser exibido. Os nomes de tabela com duas ou três partes precisam ser colocados entre aspas duplas (""). O uso de aspas para um nome de tabela de uma única parte é opcional. Quando nenhum nome de tabela for especificado, as informações serão exibidas para o banco de dados atual.

COM IGNORE_REPLICATED_TABLE_CACHE

Um parâmetro opcional para exibir o tamanho da tabela sem o tamanho do cache da tabela replicada incluído. O tamanho do cache da tabela replicada é variável, dependendo do objetivo do nível de serviço. Para obter mais informações, consulte O que é uma tabela replicada?

Permissões

Requer VIEW permissão de ESTADO DO SERVIDOR .

Comentários

Também há DMVs para fornecer consultas mais personalizáveis para o tamanho da tabela. Para obter mais informações, consulte Consultas de tamanho de tabela.

Conjuntos de resultados

Este é o conjunto de resultados de todas as tabelas. Antes da criação de um cache para uma tabela do Synapse replicada, o resultado do DBCC reflete o tamanho total da tabela round robin subjacente de cada distribuição. Depois que o cache é criado, o resultado reflete o tamanho total das tabelas round robin e do cache.

Coluna Tipo de dados Descrição
reserved_space bigint Espaço total usado para o banco de dados, em KB.
data_space bigint Espaço usado para dados, em KB.
index_space bigint Espaço usado para índices, em KB.
unused_space bigint O espaço que faz parte do espaço reservado e não é usado, em KB.
pdw_node_id INT O nó de computação que está sendo usado para os dados.

Este é o conjunto de resultados de uma tabela.

Coluna Tipo de dados Descrição Intervalo
rows bigint Número de linhas.
reserved_space bigint Espaço reservado total para o objeto, em KB.
data_space bigint Espaço usado para os dados, em KB.
index_space bigint Espaço usado para índices, em KB.
unused_space bigint O espaço que faz parte do espaço reservado e não é usado, em KB.
pdw_node_id INT O nó de computação que é usado para relatar o uso do espaço.
distribution_id INT A distribuição que é usada para relatar o uso do espaço. Para Parallel Data Warehouse, seu valor é -1 para tabelas replicadas.

Exemplos: Azure Synapse Analytics

a. Sintaxe básica de DBCC PDW_SHOWSPACEUSED

Os exemplos a seguir que usam o banco de dados de amostra AdventureWorks2025 oferecem várias maneiras de exibir o número de linhas, o espaço em disco reservado e o espaço em disco usado pela tabela FactInternetSales no banco de dados AdventureWorksPDW2022.

-- Uses AdventureWorks2022

DBCC PDW_SHOWSPACEUSED ( "AdventureWorksPDW2012.dbo.FactInternetSales" );
DBCC PDW_SHOWSPACEUSED ( "AdventureWorksPDW2012..FactInternetSales" );
DBCC PDW_SHOWSPACEUSED ( "dbo.FactInternetSales" );
DBCC PDW_SHOWSPACEUSED ( FactInternetSales );

B. Mostrar o espaço em disco usado por todas as tabelas no banco de dados atual

O exemplo a seguir que usa o banco de dados AdventureWorks2025 de amostra indica o espaço em disco reservado e usado por todas as tabelas de usuário e pelas tabelas do sistema no banco de dados AdventureWorksPDW2022.

-- Uses AdventureWorks2022  
DBCC PDW_SHOWSPACEUSED;

Conteúdo relacionado

  • Última atualização em