sp_spaceused (Transact-SQL)sp_spaceused (Transact-SQL)

Se aplica a:Applies to: sí SQL ServerSQL Server (todas las versiones compatibles)yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance ?Azure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics ?Almacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data WarehouseSe aplica a:Applies to: sí SQL ServerSQL Server (todas las versiones compatibles)yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance ?Azure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics ?Almacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data Warehouse

Muestra el número de filas, el espacio de disco reservado y el espacio de disco utilizado por una tabla, vista indizada o cola de Service BrokerService Broker de la base de datos actual, o bien muestra el espacio de disco reservado y el que utiliza la base de datos completa.Displays the number of rows, disk space reserved, and disk space used by a table, indexed view, or Service BrokerService Broker queue in the current database, or displays the disk space reserved and used by the whole database.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

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

ArgumentosArguments

Para SQL Data WarehouseSQL Data Warehouse y Almacenamiento de datos paralelosParallel Data Warehouse , 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.For SQL Data WarehouseSQL Data Warehouse and Almacenamiento de datos paralelosParallel Data Warehouse, sp_spaceused must specify named parameters (for example sp_spaceused (@objname= N'Table1'); rather than relying upon the ordinal position of parameters.

[ @objname = ] 'objname'

Se trata del nombre completo o incompleto de la tabla, vista indizada o cola para la que se solicita información de uso del espacio.Is the qualified or nonqualified name of the table, indexed view, or queue for which space usage information is requested. Las comillas solo son necesarias si se especifica un nombre de objeto completo.Quotation marks are required only if a qualified object name is specified. 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.If a fully qualified object name (including a database name) is provided, the database name must be the name of the current database.
Si no se especifica objName , se devuelven resultados para toda la base de datos.If objname is not specified, results are returned for the whole database.
objName es de tipo nvarchar (776) y su valor predeterminado es NULL.objname is nvarchar(776), with a default of NULL.

Nota

SQL Data WarehouseSQL Data Warehousey Almacenamiento de datos paralelosParallel Data Warehouse solo admiten objetos de base de datos y tabla.and Almacenamiento de datos paralelosParallel Data Warehouse only support database and table objects.

[ @updateusage = ] 'updateusage'Indica que se debe ejecutar DBCC UPDATEUSAGE para actualizar la información de uso del espacio.[ @updateusage = ] 'updateusage' Indicates DBCC UPDATEUSAGE should be run to update space usage information. 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.When objname is not specified, the statement is run on the whole database; otherwise, the statement is run on objname. Los valores pueden ser true o false.Values can be true or false. UPDATEUSAGE es de tipo VARCHAR (5) y su valor predeterminado es false.updateusage is varchar(5), with a default of false.

[ @mode = ] 'mode'Indica el ámbito de los resultados.[ @mode = ] 'mode' Indicates the scope of the results. En una tabla o base de datos extendida, el parámetro mode permite incluir o excluir la parte remota del objeto.For a stretched table or database, the mode parameter lets you include or exclude the remote portion of the object. Para obtener más información, vea Stretch Database.For more info, see Stretch Database.

El argumento mode puede tener los valores siguientes:The mode argument can have the following values:

ValueValue DescripciónDescription
ALLALL Devuelve las estadísticas de almacenamiento del objeto o la base de datos, incluida la parte local y la parte remota.Returns the storage statistics of the object or database including both the local portion and the remote portion.
LOCAL_ONLYLOCAL_ONLY Devuelve las estadísticas de almacenamiento de solo la parte local del objeto o la base de datos.Returns the storage statistics of only the local portion of the object or database. Si el objeto o la base de datos no están habilitados para Stretch, devuelve las mismas estadísticas que @mode = ALL.If the object or database is not Stretch-enabled, returns the same statistics as when @mode = ALL.
REMOTE_ONLYREMOTE_ONLY Devuelve las estadísticas de almacenamiento de solo la parte remota del objeto o la base de datos.Returns the storage statistics of only the remote portion of the object or database. Esta opción genera un error cuando se cumple una de las condiciones siguientes:This option raises an error when one of the following conditions is true:

La tabla no está habilitada para Stretch.The table is not enabled for Stretch.

La tabla está habilitada para Stretch, pero nunca ha habilitado la migración de datos.The table is enabled for Stretch, but you have never enabled data migration. En este caso, la tabla remota todavía no tiene un esquema.In this case, the remote table does not yet have a schema.

El usuario ha quitado manualmente la tabla remota.The user has manually dropped the remote table.

El aprovisionamiento del archivo de datos remotos devolvió el estado correcto, pero en realidad se produjo un error.The provisioning of the remote data archive returned a status of Success, but in fact it failed.

el modo es VARCHAR (11) y su valor predeterminado es N'ALL '.mode is varchar(11), with a default of N'ALL'.

[ @oneresultset = ] oneresultsetIndica si se va a devolver un único conjunto de resultados.[ @oneresultset = ] oneresultset Indicates whether to return a single result set. El argumento oneresultset puede tener los siguientes valores:The oneresultset argument can have the following values:

ValueValue DescripciónDescription
00 Cuando * @ objName* es null o no se especifica, se devuelven dos conjuntos de resultados.When @objname is null or is not specified, two result sets are returned. Dos conjuntos de resultados son el comportamiento predeterminado.Two result sets is the default behavior.
11 Cuando * @ objName* = null o no se especifica, se devuelve un conjunto de resultados único.When @objname = null or is not specified, a single result set is returned.

oneresultset es de bity su valor predeterminado es 0.oneresultset is bit, with a default of 0.

[ @include_total_xtp_storage] 'include_total_xtp_storage' Se aplica a: SQL Server 2017 (14.x)SQL Server 2017 (14.x) , SQL DatabaseSQL Database .[ @include_total_xtp_storage] 'include_total_xtp_storage' Applies to: SQL Server 2017 (14.x)SQL Server 2017 (14.x), SQL DatabaseSQL Database.

Cuando @oneresultset = 1, el parámetro @include_total_xtp_storage determina si el conjunto de resultados único incluye columnas para MEMORY_OPTIMIZED_DATA almacenamiento.When @oneresultset=1, the parameter @include_total_xtp_storage determines whether the single resultset includes columns for MEMORY_OPTIMIZED_DATA storage. El valor predeterminado es 0, es decir, de forma predeterminada (si se omite el parámetro), las columnas XTP no se incluyen en el conjunto de resultados.The default value is 0, that is, by default (if the parameter is omitted) the XTP columns are not included in the resultset.

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Si se omite objName y el valor de oneresultset es 0, se devuelven los conjuntos de resultados siguientes para proporcionar la información de tamaño de la base de datos actual.If objname is omitted and the value of oneresultset is 0, the following result sets are returned to provide current database size information.

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
database_namedatabase_name nvarchar(128)nvarchar(128) Nombre de la base de datos actual.Name of the current database.
database_sizedatabase_size VARCHAR (18)varchar(18) Tamaño de la base de datos actual en megabytes.Size of the current database in megabytes. database_size incluye archivos de datos y de registro.database_size includes both data and log files.
espacio sin asignarunallocated space VARCHAR (18)varchar(18) Espacio de la base de datos que no se ha reservado para objetos de base de datos.Space in the database that has not been reserved for database objects.
Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
sectorreserved VARCHAR (18)varchar(18) Espacio total asignado por los objetos de la base de datos.Total amount of space allocated by objects in the database.
datadata VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por los datos.Total amount of space used by data.
index_sizeindex_size VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por índices.Total amount of space used by indexes.
sin usarunused VARCHAR (18)varchar(18) Espacio total reservado para los objetos de la base de datos, pero no utilizado todavía.Total amount of space reserved for objects in the database, but not yet used.

Si se omite objName y el valor de oneresultset es 1, se devuelve el siguiente conjunto de resultados único para proporcionar la información de tamaño de la base de datos actual.If objname is omitted and the value of oneresultset is 1, the following single result set is returned to provide current database size information.

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
database_namedatabase_name nvarchar(128)nvarchar(128) Nombre de la base de datos actual.Name of the current database.
database_sizedatabase_size VARCHAR (18)varchar(18) Tamaño de la base de datos actual en megabytes.Size of the current database in megabytes. database_size incluye archivos de datos y de registro.database_size includes both data and log files.
espacio sin asignarunallocated space VARCHAR (18)varchar(18) Espacio de la base de datos que no se ha reservado para objetos de base de datos.Space in the database that has not been reserved for database objects.
sectorreserved VARCHAR (18)varchar(18) Espacio total asignado por los objetos de la base de datos.Total amount of space allocated by objects in the database.
datadata VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por los datos.Total amount of space used by data.
index_sizeindex_size VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por índices.Total amount of space used by indexes.
sin usarunused VARCHAR (18)varchar(18) Espacio total reservado para los objetos de la base de datos, pero no utilizado todavía.Total amount of space reserved for objects in the database, but not yet used.

Si se especifica objName , se devuelve el siguiente conjunto de resultados para el objeto especificado.If objname is specified, the following result set is returned for the specified object.

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
namename nvarchar(128)nvarchar(128) Nombre del objeto del que se solicitó la información de utilización de espacio.Name of the object for which space usage information was requested.

El nombre del esquema del objeto no se devuelve.The schema name of the object is not returned. Si se requiere el nombre de esquema, use las vistas de administración dinámica Sys. dm_db_partition_stats o Sys. dm_db_index_physical_stats para obtener información de tamaño equivalente.If the schema name is required, use the sys.dm_db_partition_stats or sys.dm_db_index_physical_stats dynamic management views to obtain equivalent size information.
lasrows Char (20)char(20) Número de filas de la tabla.Number of rows existing in the table. Si el objeto especificado es una cola de Service BrokerService Broker, esta columna indica el número de mensajes de la misma.If the object specified is a Service BrokerService Broker queue, this column indicates the number of messages in the queue.
sectorreserved VARCHAR (18)varchar(18) Cantidad total de espacio reservado para objName.Total amount of reserved space for objname.
datadata VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por los datos en objName.Total amount of space used by data in objname.
index_sizeindex_size VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por los índices en objName.Total amount of space used by indexes in objname.
sin usarunused VARCHAR (18)varchar(18) Cantidad total de espacio reservado para objName pero que todavía no se ha usado.Total amount of space reserved for objname but not yet used.

Este es el modo predeterminado cuando no se especifica ningún parámetro.This is the default mode, when no parameters are specified. Se devuelven los siguientes conjuntos de resultados que detallan la información de tamaño de base de datos en disco.The following result sets are returned detailing on-disk database size information.

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
database_namedatabase_name nvarchar(128)nvarchar(128) Nombre de la base de datos actual.Name of the current database.
database_sizedatabase_size VARCHAR (18)varchar(18) Tamaño de la base de datos actual en megabytes.Size of the current database in megabytes. database_size incluye archivos de datos y de registro.database_size includes both data and log files. Si la base de datos tiene un grupo de archivos MEMORY_OPTIMIZED_DATA, esto incluye el tamaño total en disco de todos los archivos de punto de comprobación del grupo de archivos.If the database has a MEMORY_OPTIMIZED_DATA filegroup, this includes the total on-disk size of all checkpoint files in the filegroup.
espacio sin asignarunallocated space VARCHAR (18)varchar(18) Espacio de la base de datos que no se ha reservado para objetos de base de datos.Space in the database that has not been reserved for database objects. Si la base de datos tiene un grupo de archivos MEMORY_OPTIMIZED_DATA, esto incluye el tamaño total en disco de los archivos de punto de comprobación con el estado creado en el grupo de archivos.If the database has a MEMORY_OPTIMIZED_DATA filegroup, this includes the total on-disk size of the checkpoint files with state PRECREATED in the filegroup.

Espacio usado por las tablas en 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 de disco)Space used by tables in the database: (this resultset does not reflect memory-optimized tables, as there is no per-table accounting of disk usage)

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
sectorreserved VARCHAR (18)varchar(18) Espacio total asignado por los objetos de la base de datos.Total amount of space allocated by objects in the database.
datadata VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por los datos.Total amount of space used by data.
index_sizeindex_size VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por índices.Total amount of space used by indexes.
sin usarunused VARCHAR (18)varchar(18) Espacio total reservado para los objetos de la base de datos, pero no utilizado todavía.Total amount of space reserved for objects in the database, but not yet used.

Solo se devuelve el siguiente conjunto de resultados si la base de datos tiene un grupo de archivos MEMORY_OPTIMIZED_DATA con al menos un contenedor:The following result set is returned ONLY IF the database has a MEMORY_OPTIMIZED_DATA filegroup with at least one container:

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
xtp_precreatedxtp_precreated VARCHAR (18)varchar(18) Tamaño total de los archivos de punto de comprobación con estado precreated, en KB.Total size of checkpoint files with state PRECREATED, in KB. Cuenta el espacio sin asignar en la base de datos en conjunto.Counts towards the unallocated space in the database as a whole. [Por ejemplo, si hay 600.000 KB de archivos de punto de comprobación creados de forma precreada, esta columna contiene ' 600000 KB '][For example, if there is 600,000 KB of precreated checkpoint files, this column contains '600000 KB']
xtp_usedxtp_used VARCHAR (18)varchar(18) Tamaño total de los archivos de punto de comprobación con Estados en construcción, activo y de combinación destino, en KB.Total size of checkpoint files with states UNDER CONSTRUCTION, ACTIVE, and MERGE TARGET, in KB. Este es el espacio en disco que se usa activamente para los datos de las tablas optimizadas para memoria.This is the disk space actively used for data in memory-optimized tables.
xtp_pending_truncationxtp_pending_truncation VARCHAR (18)varchar(18) Tamaño total de los archivos de punto de comprobación con WAITING_FOR_LOG_TRUNCATION de estado, en KB.Total size of checkpoint files with state WAITING_FOR_LOG_TRUNCATION, in KB. Es el espacio en disco usado para los archivos de punto de comprobación que esperan la limpieza, cuando se produce el truncamiento del registro.This is the disk space used for checkpoint files that are awaiting cleanup, once log truncation happens.

Si se omite objName , el valor de oneresultset es 1 y include_total_xtp_storage es 1, se devuelve el siguiente conjunto de resultados único para proporcionar la información de tamaño de la base de datos actual.If objname is omitted, the value of oneresultset is 1, and include_total_xtp_storage is 1, the following single result set is returned to provide current database size information. Si include_total_xtp_storage es 0 (valor predeterminado), se omiten las últimas tres columnas.If include_total_xtp_storage is 0 (the default), the last three columns are omitted.

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
database_namedatabase_name nvarchar(128)nvarchar(128) Nombre de la base de datos actual.Name of the current database.
database_sizedatabase_size VARCHAR (18)varchar(18) Tamaño de la base de datos actual en megabytes.Size of the current database in megabytes. database_size incluye archivos de datos y de registro.database_size includes both data and log files. Si la base de datos tiene un grupo de archivos MEMORY_OPTIMIZED_DATA, esto incluye el tamaño total en disco de todos los archivos de punto de comprobación del grupo de archivos.If the database has a MEMORY_OPTIMIZED_DATA filegroup, this includes the total on-disk size of all checkpoint files in the filegroup.
espacio sin asignarunallocated space VARCHAR (18)varchar(18) Espacio de la base de datos que no se ha reservado para objetos de base de datos.Space in the database that has not been reserved for database objects. Si la base de datos tiene un grupo de archivos MEMORY_OPTIMIZED_DATA, esto incluye el tamaño total en disco de los archivos de punto de comprobación con el estado creado en el grupo de archivos.If the database has a MEMORY_OPTIMIZED_DATA filegroup, this includes the total on-disk size of the checkpoint files with state PRECREATED in the filegroup.
sectorreserved VARCHAR (18)varchar(18) Espacio total asignado por los objetos de la base de datos.Total amount of space allocated by objects in the database.
datadata VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por los datos.Total amount of space used by data.
index_sizeindex_size VARCHAR (18)varchar(18) Cantidad total de espacio utilizado por índices.Total amount of space used by indexes.
sin usarunused VARCHAR (18)varchar(18) Espacio total reservado para los objetos de la base de datos, pero no utilizado todavía.Total amount of space reserved for objects in the database, but not yet used.
xtp_precreatedxtp_precreated VARCHAR (18)varchar(18) Tamaño total de los archivos de punto de comprobación con estado precreated, en KB.Total size of checkpoint files with state PRECREATED, in KB. Esto cuenta en el espacio sin asignar en la base de datos en conjunto.This counts towards the unallocated space in the database as a whole. Devuelve NULL si la base de datos no tiene un grupo de archivos de memory_optimized_data con al menos un contenedor.Returns NULL if the database does not have a memory_optimized_data filegroup with at least one container. Esta columna solo se incluye si @include_total_xtp_storage = 1.*This column is only included if @include_total_xtp_storage=1*.
xtp_usedxtp_used VARCHAR (18)varchar(18) Tamaño total de los archivos de punto de comprobación con Estados en construcción, activo y de combinación destino, en KB.Total size of checkpoint files with states UNDER CONSTRUCTION, ACTIVE, and MERGE TARGET, in KB. Este es el espacio en disco que se usa activamente para los datos de las tablas optimizadas para memoria.This is the disk space actively used for data in memory-optimized tables. Devuelve NULL si la base de datos no tiene un grupo de archivos de memory_optimized_data con al menos un contenedor.Returns NULL if the database does not have a memory_optimized_data filegroup with at least one container. Esta columna solo se incluye si @include_total_xtp_storage = 1.*This column is only included if @include_total_xtp_storage=1*.
xtp_pending_truncationxtp_pending_truncation VARCHAR (18)varchar(18) Tamaño total de los archivos de punto de comprobación con WAITING_FOR_LOG_TRUNCATION de estado, en KB.Total size of checkpoint files with state WAITING_FOR_LOG_TRUNCATION, in KB. Es el espacio en disco usado para los archivos de punto de comprobación que esperan la limpieza, cuando se produce el truncamiento del registro.This is the disk space used for checkpoint files that are awaiting cleanup, once log truncation happens. Devuelve NULL si la base de datos no tiene un grupo de archivos de memory_optimized_data con al menos un contenedor.Returns NULL if the database does not have a memory_optimized_data filegroup with at least one container. Esta columna solo se incluye si @include_total_xtp_storage=1 .This column is only included if @include_total_xtp_storage=1.

ObservacionesRemarks

database_size suele ser mayor que la suma del espacio reservadosin + asignar porque incluye el tamaño de los archivos de registro, pero reservado y unallocated_space considerar solo las páginas de datos.database_size is generally larger than the sum of reserved + unallocated space because it includes the size of log files, but reserved and unallocated_space consider only data pages. En algunos casos con Azure Synapse Analytics, es posible que esta instrucción no sea verdadera.In some cases with Azure Synapse Analytics, this statement may not be true.

Las páginas que se usan en los índices XML y los índices de texto completo se incluyen en index_size para ambos conjuntos de resultados.Pages that are used by XML indexes and full-text indexes are included in index_size for both result sets. 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 de resultados reservados y index_size .When objname is specified, the pages for the XML indexes and full-text indexes for the object are also counted in the total reserved and index_size results.

Si se calcula el uso de espacio para una base de datos o un objeto que tiene un índice espacial, las columnas de tamaño de espacio, como database_size, reservedy index_size, incluyen el tamaño del índice espacial.If space usage is calculated for a database or an object that has a spatial index, the space-size columns, such as database_size, reserved, and index_size, include the size of the spatial index.

Cuando se especifica UPDATEUSAGE , Motor de base de datos de SQL ServerSQL Server Database Engine examina las páginas de datos de la base de datos y realiza las correcciones necesarias en las vistas de catálogo Sys. allocation_units y Sys. partitions con respecto al espacio de almacenamiento utilizado por cada tabla.When updateusage is specified, the Motor de base de datos de SQL ServerSQL Server Database Engine scans the data pages in the database and makes any required corrections to the sys.allocation_units and sys.partitions catalog views regarding the storage space used by each table. Existen algunas situaciones, como por ejemplo después de quitar un índice, en las que la información de espacio para la tabla podría no estar actualizada.There are some situations, for example, after an index is dropped, when the space information for the table may not be current. UPDATEUSAGE puede tardar algún tiempo en ejecutarse en tablas o bases de datos de gran tamaño.updateusage can take some time to run on large tables or databases. Use UPDATEUSAGE solo cuando sospeche que se devuelven valores incorrectos y cuando el proceso no tendrá ningún efecto adverso en otros usuarios o procesos de la base de datos.Use updateusage only when you suspect incorrect values are being returned and when the process will not have an adverse effect on other users or processes in the database. Si se prefiere, DBCC UPDATEUSAGE puede ejecutarse por separado.If preferred, DBCC UPDATEUSAGE can be run separately.

Nota

Al quitar o volver a generar índices grandes, o al quitar o truncar tablas grandes, el Motor de base de datosDatabase Engine difiere las cancelaciones de asignación de páginas, así como sus bloqueos asociados, hasta que se confirma la transacción.When you drop or rebuild large indexes, or drop or truncate large tables, the Motor de base de datosDatabase Engine defers the actual page deallocations, and their associated locks, until after the transaction commits. Las operaciones de eliminación diferidas no liberan inmediatamente el espacio asignado.Deferred drop operations do not release allocated space immediately. Por lo tanto, es posible que los valores devueltos por sp_spaceused inmediatamente después de quitar o truncar un objeto grande no reflejen el espacio en disco real disponible.Therefore, the values returned by sp_spaceused immediately after dropping or truncating a large object may not reflect the actual disk space available.

PermisosPermissions

El permiso para ejecutar sp_spaceused se otorga al rol public .Permission to execute sp_spaceused is granted to the public role. Solo los miembros del rol fijo de base de datos db_owner pueden especificar el parámetro @updateusage.Only members of the db_owner fixed database role can specify the @updateusage parameter.

EjemplosExamples

A.A. Mostrar información de espacio en disco acerca de una tablaDisplaying disk space information about a table

El siguiente ejemplo muestra información de espacio en disco para la tabla Vendor y sus índices.The following example reports disk space information for the Vendor table and its indexes.

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

B.B. Mostrar información de espacio actualizada acerca de una base de datosDisplaying updated space information about a database

En este ejemplo se resume el espacio utilizado en la base de datos actual y se utiliza el parámetro opcional @updateusage para garantizar que se devuelvan los valores actuales.The following example summarizes space used in the current database and uses the optional parameter @updateusage to ensure current values are returned.

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

C.C. Mostrar información de uso de espacio sobre la tabla remota asociada a una tabla habilitada para StretchDisplaying space usage information about the remote table associated with a Stretch-enabled table

En el ejemplo siguiente se resume el espacio utilizado por la tabla remota asociada a una tabla habilitada para Stretch mediante el argumento ** @ mode** para especificar el destino remoto.The following example summarizes the space used by the remote table associated with a Stretch-enabled table by using the @mode argument to specify the remote target. Para obtener más información, vea Stretch Database.For more info, see Stretch Database.

USE StretchedAdventureWorks2016  
GO  
EXEC sp_spaceused N'Purchasing.Vendor', @mode = 'REMOTE_ONLY'  

D.D. Mostrar información de uso de espacio para una base de datos en un único conjunto de resultadosDisplaying space usage information for a database in a single result set

En el ejemplo siguiente se resume el uso de espacio para la base de datos actual en un conjunto de resultados único.The following example summarizes space usage for the current database in a single result set.

USE AdventureWorks2016  
GO  
EXEC sp_spaceused @oneresultset = 1  

E.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 resultadosDisplaying space usage information for a database with at least one MEMORY_OPTIMIZED file group in a single result set

En el ejemplo siguiente se resume el uso de espacio para la base de datos actual con al menos un grupo de archivos MEMORY_OPTIMIZED en un único conjunto de resultados.The following example summarizes space usage for the current database with at least one MEMORY_OPTIMIZED file group in a single result set.

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

F.F. Mostrar información de uso de espacio para un objeto de tabla de MEMORY_OPTIMIZED en una base de datos.Displaying space usage information for a MEMORY_OPTIMIZED table object in a database.

En el ejemplo siguiente se resume el uso de espacio para un objeto de tabla de MEMORY_OPTIMIZED en la base de datos actual con al menos un grupo de archivos MEMORY_OPTIMIZED.The following example summarizes space usage for a MEMORY_OPTIMIZED table object in the current database with at least one MEMORY_OPTIMIZED file group.

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

Consulte tambiénSee Also

CREATE INDEX (Transact-SQL) CREATE INDEX (Transact-SQL)
CREATE TABLE (Transact-SQL) CREATE TABLE (Transact-SQL)
DBCC UPDATEUSAGE (Transact-SQL) DBCC UPDATEUSAGE (Transact-SQL)
SQL Server Service Broker SQL Server Service Broker
sys.allocation_units (Transact-SQL) sys.allocation_units (Transact-SQL)
sys.indexes (Transact-SQL) sys.indexes (Transact-SQL)
sys.index_columns (Transact-SQL) sys.index_columns (Transact-SQL)
Sys. Objects (Transact-SQL) sys.objects (Transact-SQL)
Sys. partitions (Transact-SQL) sys.partitions (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)System Stored Procedures (Transact-SQL)