DBCC PDW_SHOWSPACEUSED (Transact-SQL)

  • Artigo

Aplica-se a:Azure Synapse AnalyticsAnalytics Platform System (PDW)

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

Convenções de sintaxe Transact-SQL

Syntax

-- 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.

WITH 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 a permissão VIEW SERVER STATE.

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 e PDW (Analytics Platform System)

a. Sintaxe básica de DBCC PDW_SHOWSPACEUSED

Os exemplos a seguir que usam o banco de dados de amostra AdventureWorks2022 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 AdventureWorks2022 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;

Próximas etapas