sys.resource_usage (Azure SQL Database and Azure SQL Managed Instance)

Applies to: Azure SQL Database Azure SQL Managed Instance

Important

This feature is in a preview state. Do not take a dependency on the specific implementation of this feature because the feature might be changed or removed in a future release.

While in a preview state, the Azure SQL Database operations team might turn data collection off and on for this DMV:

  • When turned on, the DMV returns current data as it is aggregated.
  • When turned off, the DMV returns historical data, which might be stale.

Provides hourly summary of resource usage data for user databases in the current server. Historical data is retained for 90 days.

For each user database, there is one row for every hour in continuous fashion. Even if the database was idle during that hour, there is one row, and the usage_in_seconds value for that database will be 0. Storage usage and SKU information are rolled up for the hour appropriately.

Columns Data Type Description
end_time datetime Time (UTC) in hour increments.
database_name nvarchar Name of user database.
sku nvarchar Name of the service tier. Possible values include: Basic, Standard, Premium, GeneralPurpose, BusinessCritical, Hyperscale.
storage_in_megabytes decimal Maximum used storage size for the hour, including database data, indexes, stored procedures and metadata.

Permissions

Requires permission to access the master database on the logical server in Azure SQL Database.

Examples

The following query returns data from the past two days:

SELECT end_time, database_name, sku, storage_in_megabytes 
FROM sys.resource_usage
WHERE end_time > DATEADD(dd,-2,SYSDATETIME());
GO

Next steps

Learn more about Azure SQL Database in the following articles: