sys-dm-db-log-space-usage-transact-sql.md

description	sys.dm_db_log_space_usage (Transact-SQL)
title	sys.dm_db_log_space_usage (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	06/29/2017
ms.prod	sql
ms.prod_service	database-engine, sql-database
ms.reviewer
ms.technology	system-objects
ms.topic	conceptual
f1_keywords	sys.dm_db_log_space_usage sys.dm_db_log_space_usage_TSQL dm_db_log_space_usage dm_db_log_space_usage_TSQL
dev_langs	TSQL
helpviewer_keywords	sys.dm_db_log_space_usage dynamic management view
ms.assetid	f6b40060-c17d-472f-b0a3-3b350275d487
author	WilliamDAssafMSFT
ms.author	wiassaf
monikerRange	=azuresqldb-current||>=sql-server-2016||>=sql-server-linux-2017||=azuresqldb-mi-current

sys.dm_db_log_space_usage (Transact-SQL)

[!INCLUDE SQL Server Azure SQL Database ]

Returns space usage information for the transaction log.

Note

All transaction log files are combined.

Column name	Data type	Description
database_id	smallint	Database ID.
total_log_size_in_bytes	bigint	The size of the log
used_log_space_in_bytes	bigint	The occupied size of the log
used_log_space_in_percent	real	The occupied size of the log as a percent of the total log size
log_space_in_bytes_since_last_backup	bigint	The amount of space used since the last log backup Applies to: [!INCLUDEsssql14-md] through [!INCLUDEsscurrent-md], [!INCLUDEssSDS].

Permissions

On [!INCLUDEssNoVersion_md], requires VIEW SERVER STATE permission.
On SQL Database Basic, S0, and S1 service objectives, and for databases in elastic pools, the server admin account or the Azure Active Directory admin account is required. On all other SQL Database service objectives, the VIEW DATABASE STATE permission is required in the database.

Examples

A. Determine the Amount of Free Log Space in tempdb

The following query returns the total free log space in megabytes (MB) available in tempdb.

USE tempdb;  
GO  

SELECT (total_log_size_in_bytes - used_log_space_in_bytes)*1.0/1024/1024 AS [free log space in MB]  
FROM sys.dm_db_log_space_usage;  

See Also

Dynamic Management Views and Functions (Transact-SQL)
Database Related Dynamic Management Views (Transact-SQL)
sys.dm_db_file_space_usage
sys.dm_db_task_space_usage (Transact-SQL)
sys.dm_db_session_space_usage (Transact-SQL)
sys.dm_db_log_info (Transact-SQL)
sys.dm_db_log_stats (Transact-SQL)