DBCC PDW_SHOWSPACEUSED (Transact-SQL)

Artículo
04/26/2023

Se aplica a:Azure Synapse Analytics Analytics Platform System (PDW)

Muestra el número de filas, el espacio en disco reservado y el espacio en disco usado para una tabla específica o para todas las tablas de una base de datos de Azure Synapse Analytics o Analytics Platform System.

Convenciones de sintaxis de Transact-SQL

Sintaxis

-- 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 ]
[;]

Nota:

El grupo de SQL sin servidor no admite esta sintaxis en Azure Synapse Analytics.

Argumentos

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

Nombre de una, dos o tres partes de la tabla que se va a mostrar. En el caso de los nombres de tabla de dos o tres partes, el nombre debe incluirse entre comillas dobles (""). El uso de comillas en un nombre de tabla de una parte es opcional. Cuando no se especifica ningún nombre de tabla, se muestra la información de la base de datos actual.

WITH IGNORE_REPLICATED_TABLE_CACHE

Parámetro opcional para ver el tamaño de la tabla sin el tamaño de la caché de la tabla replicada incluido. El tamaño de la caché de la tabla replicada varía en función del objetivo de nivel de servicio. Para más información, consulte ¿Qué es una tabla replicada?

Permisos

Requiere el permiso VIEW SERVER STATE.

Observaciones

También hay DMV para proporcionar consultas más personalizables para el tamaño de tabla. Para más información, consulte Consultas de tamaño de tabla.

Conjuntos de resultados

Este es el conjunto de resultados de todas las tablas. Antes de crear una memoria caché para una tabla replicada de Synapse, el resultado de DBCC refleja el tamaño total de la tabla de round robin subyacente de cada distribución. Una vez creada la memoria caché, el resultado refleja el tamaño total de las tablas de round robin y la memoria caché.

Columna	Tipo de datos	Descripción
reserved_space	bigint	Espacio total usado para la base de datos, en KB.
data_space	bigint	Espacio usado para los datos, en KB.
index_space	bigint	Espacio usado para los índices, en KB.
unused_space	bigint	Espacio que forma parte del espacio reservado y que no se usa, en KB.
pdw_node_id	int	Nodo de ejecución que se usa para los datos.

Este es el conjunto de resultados de una tabla.

Columna	Tipo de datos	Descripción	Intervalo
rows	bigint	Número de filas.
reserved_space	bigint	Espacio total reservado para el objeto, en KB.
data_space	bigint	Espacio usado para los datos, en KB.
index_space	bigint	Espacio usado para los índices, en KB.
unused_space	bigint	Espacio que forma parte del espacio reservado y que no se usa, en KB.
pdw_node_id	int	Nodo de ejecución que se usa para notificar el uso de espacio.
distribution_id	int	Distribución que se usa para notificar el uso de espacio.	En cuanto al almacenamiento de datos paralelos, su valor es -1 para las tablas replicadas.

Ejemplos: Azure Synapse Analytics y Sistema de la plataforma de análisis (PDW)

A. Sintaxis básica de DBCC PDW_SHOWSPACEUSED

En los ejemplos siguientes, donde se usa la base de datos de ejemplo AdventureWorks2022, se muestran varias formas de mostrar el número de filas, el espacio en disco reservado y el espacio en disco usado por la tabla FactInternetSales en la base de datos 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 el espacio en disco usado por todas las tablas de la base de datos actual

En el ejemplo siguiente, donde se usa la base de datos de ejemplo AdventureWorks2022, se muestra el espacio en disco reservado y usado por todas las tablas de usuario y las tablas del sistema en la base de datos AdventureWorksPDW2022.

-- Uses AdventureWorks2022  
DBCC PDW_SHOWSPACEUSED;

Compartir vía