sp_spaceused (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

El sp_spaceused procedimiento almacenado del sistema muestra:

• el número de filas, espacio en disco reservado y espacio en disco usado por una tabla, vista indizada o cola de Service Broker en la base de datos actual

• espacio en disco reservado y utilizado por toda la base de datos

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_spaceused
    [ [ @objname = ] N'objname' ]
    [ , [ @updateusage = ] 'updateusage' ]
    [ , [ @mode = ] 'mode' ]
    [ , [ @oneresultset = ] oneresultset ]
    [ , [ @include_total_xtp_storage = ] include_total_xtp_storage ]
[ ; ]

Argumentos

En el caso del sistema de plataforma de Azure Synapse Analytics y Analytics (PDW), sp_spaceused debe especificar parámetros con nombre (por ejemplo sp_spaceused (@objname= N'Table1');), en lugar de confiar en la posición ordinal de los parámetros.

[ @objname = ] N'objname'

Nombre completo o no calificado de la tabla, vista indizada o cola para la que se solicita información de uso del espacio. @objname es nvarchar(776), con un valor predeterminado de NULL. Las comillas solo son necesarias si se especifica un nombre de objeto completo. Si se proporciona un nombre de objeto completo, incluido el nombre de una base de datos, el nombre de la base de datos debe ser el nombre de la base de datos actual.

Si no se especifica @objname , se devuelven los resultados de toda la base de datos.

[ @updateusage = ] 'updateusage'

Indica que DBCC UPDATEUSAGE se debe ejecutar para actualizar la información de uso del espacio. @updateusage es varchar(5), con un valor predeterminado de false. Cuando no se especifica @objname , la instrucción se ejecuta en toda la base de datos. De lo contrario, la instrucción se ejecuta en @objname. Los valores pueden ser true o false.

[ @mode = ] 'mode'

Indica el ámbito de los resultados. Para una tabla o base de datos estirada, el parámetro @mode permite incluir o excluir la parte remota del objeto. Para obtener más información, vea Stretch Database.

@mode es varchar(11) y puede ser uno de estos valores.

[ @oneresultset = ] oneresultset

Indica si se va a devolver un único conjunto de resultados. @oneresultset es bit y puede ser uno de estos valores:

[ @include_total_xtp_storage = ] include_total_xtp_storage

Se aplica a: SQL Server 2017 (14.x) y versiones posteriores, y SQL Database

Cuando @oneresultset se establece 1en , este parámetro determina si el único conjunto de resultados incluye columnas para MEMORY_OPTIMIZED_DATA el almacenamiento. @include_total_xtp_storage es bit, con un valor predeterminado de 0. Si 1es , las columnas XTP se incluyen en el conjunto de resultados.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Si se omite @objname y el valor de @oneresultset es 0, se devuelven los siguientes conjuntos de resultados para proporcionar información de tamaño de base de datos actual.

Si se omite @objname y el valor de @oneresultset es 1, se devuelve el siguiente conjunto de resultados único para proporcionar información de tamaño de base de datos actual.

Si se especifica @objname , se devuelve el siguiente conjunto de resultados para el objeto especificado.

Este modo es el valor predeterminado, cuando no se especifica ningún parámetro. Los siguientes conjuntos de resultados se devuelven detallando la información de tamaño de la base de datos en disco.

Espacio utilizado por las tablas de la base de datos. Este conjunto de resultados no refleja las tablas optimizadas para memoria, ya que no hay ninguna contabilidad por tabla del uso del disco:

El siguiente conjunto de resultados solo se devuelve si la base de datos tiene un MEMORY_OPTIMIZED_DATA grupo de archivos con al menos un contenedor:

Si se omite @objname , el valor de @oneresultset es 1y @include_total_xtp_storage es 1, se devuelve el siguiente conjunto de resultados único para proporcionar información de tamaño de base de datos actual. Si @include_total_xtp_storage es 0 (valor predeterminado), se omiten las tres últimas columnas.

¹ Solo se incluye si @include_total_xtp_storage está establecido en 1.

Comentarios

El database_size valor suele ser mayor que la suma de reservedunallocated space + porque incluye el tamaño de los archivos de registro, pero y unallocated_spacereserved solo tiene en cuenta las páginas de datos. En algunos casos con Azure Synapse Analytics, es posible que esta instrucción no sea cierta.

Las páginas que usan los índices XML y los índices de texto completo se incluyen en para index_size ambos conjuntos de resultados. Cuando se especifica @objname , las páginas de los índices XML y los índices de texto completo del objeto también se cuentan en el total reserved y index_size los resultados.

Si se calcula el uso del espacio para una base de datos o un objeto que es un índice espacial, las columnas de tamaño de espacio, como database_size, reservedy index_size, incluyen el tamaño del índice espacial.

Cuando se especifica @updateusage, SQL Server Motor de base de datos examina las páginas de datos de la base de datos y realiza las correcciones necesarias en las vistas de sys.allocation_units catálogo y sys.partitions relativas al espacio de almacenamiento utilizado por cada tabla. Hay algunas situaciones, por ejemplo, después de quitar un índice, cuando es posible que la información de espacio de la tabla no esté actualizada. @updateusage puede tardar algún tiempo en ejecutarse en tablas o bases de datos grandes. Use @updateusage solo cuando se sospecha que se devuelven valores incorrectos y cuando el proceso no tiene un efecto adverso en otros usuarios o procesos de la base de datos. Si se prefiere, DBCC UPDATEUSAGE se puede ejecutar por separado.

Permisos

Se concede permiso para ejecutar sp_spaceused al rol público . Solo los miembros del rol fijo de base de datos db_owner pueden especificar el parámetro @updateusage .

Ejemplos

A Mostrar información de espacio en disco sobre una tabla

El siguiente ejemplo muestra información de espacio en disco para la tabla Vendor y sus índices.

USE AdventureWorks2022;
GO
EXEC sp_spaceused N'Purchasing.Vendor';
GO

B. Mostrar información de espacio actualizada sobre una base de datos

En el ejemplo siguiente se resume el espacio usado en la base de datos actual y se usa el parámetro opcional @updateusage para asegurarse de que se devuelven los valores actuales.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @updateusage = N'TRUE';
GO

C. Mostrar información de uso del espacio sobre la tabla remota asociada a una tabla habilitada para Stretch

En el ejemplo siguiente se resume el espacio usado por la tabla remota asociada a una tabla habilitada para Stretch mediante el argumento @mode para especificar el destino remoto. Para obtener más información, vea Stretch Database.

USE StretchedAdventureWorks2022;
GO

EXEC sp_spaceused N'Purchasing.Vendor', @mode = 'REMOTE_ONLY';

D. Mostrar información de uso de espacio para una base de datos en un único conjunto de resultados

En el ejemplo siguiente se resume el uso del espacio de la base de datos actual en un único conjunto de resultados.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @oneresultset = 1;

E. Mostrar información de uso de espacio para una base de datos con al menos un grupo de archivos MEMORY_OPTIMIZED en un único conjunto de resultados

En el ejemplo siguiente se resume el uso del espacio de la base de datos actual con al menos un MEMORY_OPTIMIZED grupo de archivos en un único conjunto de resultados.

USE WideWorldImporters
GO

EXEC sp_spaceused @updateusage = 'FALSE',
    @mode = 'ALL',
    @oneresultset = '1',
    @include_total_xtp_storage = '1';
GO

F. Mostrar información de uso del espacio para un objeto de tabla de MEMORY_OPTIMIZED en una base de datos

En el ejemplo siguiente se resume el uso del espacio de un MEMORY_OPTIMIZED objeto de tabla de la base de datos actual con al menos un MEMORY_OPTIMIZED grupo de archivos.

USE WideWorldImporters
GO

EXEC sp_spaceused @objname = N'VehicleTemparatures',
    @updateusage = 'FALSE',
    @mode = 'ALL',
    @oneresultset = '0',
    @include_total_xtp_storage = '1';
GO

Contenido 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)
• Procedimientos almacenados del sistema (Transact-SQL)