The twenty-fifth installation of T-SQL Tuesday is brought to us by Allen White (twitter | blog). The topic is “T-SQL Tricks”.

As a database administrator, one of the most common calls I receive from developers is, “I’m getting an error saying the log is full.” This could happen for a variety of reasons:

• Data was being loaded into the database.
• An index was being built, rebuilt, or reorganized.
• A DBCC CHECKDB was running.
• There is an open transaction.

I could have simply expanded the transaction log file without any questions, but, if you know me, you know I like to question things.

What I frequently wanted to know was how large the log was, how much space was being used, and what recovery model the database was in. I put together a simple script to check this information, and used it frequently.

I’m able to pull information using a DBCC command, SQLPERF, and the system catalog view, sys.databases. Having this information exposed is very helpful to us.

T-SQL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
-- Set database name 
DECLARE @DatabaseName VARCHAR(50);
SET @DatabaseName = 'AdventureWorks2008R2'; 
 
-- Get database ID. This is helpful to know in the next step, especially if you have an instance with hundreds of databases. 
SELECT db_id(@DatabaseName);
 
-- Check log size and space used. 
DBCC SQLPERF(logspace);
 
-- Check recovery mode and why log space can't be reused. 
SELECT name, recovery_model_desc, log_reuse_wait_desc
FROM sys.databases
WHERE name = @DatabaseName;
-- Set database name 
DECLARE @DatabaseName VARCHAR(50);
SET @DatabaseName = 'AdventureWorks2008R2'; 

-- Get database ID. This is helpful to know in the next step, especially if you have an instance with hundreds of databases. 
SELECT db_id(@DatabaseName);

-- Check log size and space used. 
DBCC SQLPERF(logspace);

-- Check recovery mode and why log space can't be reused. 
SELECT name, recovery_model_desc, log_reuse_wait_desc
FROM sys.databases
WHERE name = @DatabaseName;

DBCC SQLPERF is used to get transaction log usage information. It returns Database Name, Log Size (MB), Log Space Used (%), and Status. It requires VIEW SERVER STATE permissions. In addition, you can reset DMV information for latch statistics or wait statistics by passing in parameters. This can help with additional troubleshooting. Here’s the full syntax:

T-SQL
1
2
3
4
5
6
7
8
9
DBCC SQLPERF 
(
     [ LOGSPACE ]
     |
     [ "sys.dm_os_latch_stats" , CLEAR ]
     |
     [ "sys.dm_os_wait_stats" , CLEAR ]
) 
     [WITH NO_INFOMSGS ]
DBCC SQLPERF 
(
     [ LOGSPACE ]
     |
     [ "sys.dm_os_latch_stats" , CLEAR ]
     |
     [ "sys.dm_os_wait_stats" , CLEAR ]
) 
     [WITH NO_INFOMSGS ]

sys.databases will provide information about each database on a SQL Server instance. Just a few of the things you can view are the compatibility level, collation, recovery model, and state. Here, I’m returning the database name, the recovery model, and what the log is waiting on. If a user can connect to a database, they can view the sys.databases information for that database.

A great reference (and one of my inspirations for this script) was Gail Shaw’s blog, “Why is my transaction log full?” With this information, I could choose to change the recovery model, expand the log, or wait for the next transaction log backup.

If the database was in full recovery mode, and the users did not need point-in-time recovery (perhaps it’s a development environment), I could choose to set it to simple recovery. If there would be valid reasons for the expansion – frequent data loads, or long-running queries – I could expand the log to a reasonable size. If the database was in full recovery, and this was a one-time operation, I could issue a transaction log backup to clear space. Knowing why a transaction log is expanding, and if it will happen again, is an important part of your job as a DBA.

Advice I would give to anyone new to SQL Server, and even those who have worked with it for some time, is to become familiar with the system catalog views. Catalog views expose the catalog metadata that the SQL Server Engine uses. They are well documented in BOL and efficient for retrieving valuable information to make logical decisions. Catalog views are a powerful way to troubleshoot SQL Server.