sp_spaceused (Transact-SQL)

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

В системной хранимой процедуре отображается следующее sp_spaceused :

• количество строк, зарезервированных дискового пространства и дискового пространства, используемого таблицей, индексированного представления или очереди Service Broker в текущей базе данных

• дисковое пространство зарезервировано и используется всей базой данных

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

Для Системы платформы Аналитики и аналитики Azure Synapse Analytics (PDW) sp_spaceused необходимо указать именованные параметры (например sp_spaceused (@objname= N'Table1');), а не полагаться на порядковое положение параметров.

[ @objname = ] N'objname'

Полное или неквалифицированное имя таблицы, индексированного представления или очереди, для которой запрашиваются сведения об использовании пространства. @objname — nvarchar(776) с значением по умолчаниюNULL. Кавычки необходимы только в том случае, если указано уточненное имя объекта. Если указано полностью уточненное имя, включающее имя базы данных, именем базы данных должно быть имя текущей базы данных.

Если @objname не задано, результаты возвращаются для всей базы данных.

[ @updateusage = ] 'updateusage'

DBCC UPDATEUSAGE Указывает, что следует запускать для обновления сведений об использовании пространства. @updateusage — varchar(5) с значением по умолчаниюfalse. Если @objname не указан, инструкция выполняется во всей базе данных. В противном случае инструкция выполняется в @objname. Возможные значения — true или false.

[ @mode = ] 'mode'

Указывает область результатов. Для растянутой таблицы или базы данных параметр @mode позволяет включить или исключить удаленную часть объекта. Дополнительные сведения см. в разделе Stretch Database.

@mode — varchar(11) и может быть одним из этих значений.

[ @oneresultset = ] oneresultset

Указывает, следует ли возвращать один результирующий набор. @oneresultset бит и может быть одним из следующих значений:

[ @include_total_xtp_storage = ] include_total_xtp_storage

Область применения: SQL Server 2017 (14.x) и более поздних версий и База данных SQL

Если задано 1значение @oneresultset, этот параметр определяет, содержит ли один набор результатов столбцы для MEMORY_OPTIMIZED_DATA хранилища. @include_total_xtp_storage бит с значением по умолчанию0. Если 1столбцы XTP включены в набор результатов.

Значения кода возврата

0 (успешно) или 1 (сбой).

Результирующий набор

Если @objname опущен и значение @oneresultset0, возвращаются следующие результирующие наборы, чтобы предоставить текущие сведения о размере базы данных.

Если @objname опущен и значение @oneresultset1, возвращается следующий результирующий набор для предоставления текущих сведений о размере базы данных.

Если указан @objname , для указанного объекта возвращается следующий результирующий набор.

Этот режим используется по умолчанию, если параметры не указаны. Следующие результирующие наборы возвращают сведения о размере базы данных на диске.

Пространство, используемое таблицами в базе данных. Этот результирующий набор не отражает оптимизированные для памяти таблицы таблицы, так как для каждой таблицы не выполняется учет использования дисков:

Следующий результирующий набор возвращается только в том случае, если база данных имеет файловую группу с хотя бы одним контейнером MEMORY_OPTIMIZED_DATA :

Если @objname опущен, значение @oneresultset равно 1и @include_total_xtp_storage1, возвращается следующий один результирующий набор для предоставления текущих сведений о размере базы данных. Если @include_total_xtp_storage ( 0 по умолчанию), последние три столбца опущены.

¹ Только если для @include_total_xtp_storage задано 1значение .

Замечания

Значениеdatabase_size, как правило, больше reservedunallocated space + суммы, так как оно включает размер файлов журнала, но reserved и unallocated_space рассмотрите только страницы данных. В некоторых случаях с Azure Synapse Analytics эта инструкция может не быть верной.

Страницы, используемые XML-индексами и полнотекстовых индексов, включаются index_size в оба результирующих набора. При указании @objname страницы xml-индексов и полнотекстовых индексов для объекта также учитываются в общей reserved сумме и index_size результатах.

Если использование пространства вычисляется для базы данных или объекта, являющегося пространственным индексом, столбцы размера пространства, например database_sizereserved, и index_sizeвключают размер пространственного индекса.

При указании @updateusage SQL Server ядро СУБД сканирует страницы данных в базе данных и sys.partitions вносит все необходимые исправления sys.allocation_units в представления каталога в отношении места хранения, используемого каждой таблицей. Существуют некоторые ситуации, например после удаления индекса, когда сведения о пространстве таблицы могут не быть текущими. @updateusage может занять некоторое время для выполнения в больших таблицах или базах данных. Используйте @updateusage только в том случае, если возвращаются неправильные значения, и если процесс не оказывает негативного влияния на других пользователей или процессы в базе данных. При желании DBCC UPDATEUSAGE можно выполнять отдельно.

Разрешения

Разрешение на выполнение sp_spaceused предоставляется общедоступной роли. Параметр @updateusage могут указывать только члены предопределенной роли базы данных db_owner.

Примеры

А. Отображение сведений о пространстве диска для таблицы

В следующем примере предоставляются сведения о месте на диске для таблицы Vendor и ее индексах.

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

B. Отображение обновленных сведений о пространстве базы данных

В следующем примере суммируется пространство, используемое в текущей базе данных, и используется необязательный параметр @updateusage для обеспечения возврата текущих значений.

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

C. Отображение сведений об использовании пространства для удаленной таблицы, связанной с таблицей с поддержкой Stretch

В следующем примере приводится сводка пространства, используемого удаленной таблицей, связанной с таблицей с поддержкой Stretch, с помощью аргумента @mode для указания удаленного целевого объекта. Дополнительные сведения см. в разделе Stretch Database.

USE StretchedAdventureWorks2022;
GO

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

D. Отображение сведений об использовании пространства для базы данных в одном результирующем наборе

В следующем примере приводится сводка использования пространства для текущей базы данных в одном результирующем наборе.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @oneresultset = 1;

Е. Отображение сведений об использовании пространства для базы данных с по крайней мере одной MEMORY_OPTIMIZED файловой группой в одном результирующем наборе

В следующем примере приводится сводка использования пространства для текущей базы данных с хотя бы одной MEMORY_OPTIMIZED группой файлов в одном результирующем наборе.

USE WideWorldImporters
GO

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

F. Отображение сведений об использовании пространства для объекта таблицы MEMORY_OPTIMIZED в базе данных

В следующем примере приводится сводка использования пространства для объекта таблицы в текущей MEMORY_OPTIMIZED базе данных по крайней мере с одной MEMORY_OPTIMIZED группой файлов.

USE WideWorldImporters
GO

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

Связанный контент

• Инструкция 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)
• Системные хранимые процедуры (Transact-SQL)