SQL WHILE循环PRINT延迟输出问题及进度监控需求

我编写了一段简单的WHILE循环代码：

DECLARE @Counter INT 

SET @Counter = 1

WHILE (@Counter <= 10)

BEGIN

    PRINT 'The counter value is = ' + CONVERT(VARCHAR,@Counter) WAITFOR DELAY '00:00:01'
    SET @Counter  = @Counter  + 1
    
END

预期每秒打印一次@Counter的值，但实际要等10秒后才一次性输出所有结果：

The counter value is = 1
The counter value is = 2
The counter value is = 3
The counter value is = 4
The counter value is = 5
The counter value is = 6
The counter value is = 7
The counter value is = 8
The counter value is = 9
The counter value is = 10

请问如何实现每次间隔1秒打印下一个值以监控进度？

背景说明：我希望用类似脚本监控数据库备份和恢复进度，例如通过以下语句获取初始进度百分比：

SELECT @Counter = percent_complete
FROM sys.dm_exec_requests r 
   CROSS APPLY sys.dm_exec_sql_text(r.sql_handle) a 
WHERE r.command in ('BACKUP DATABASE','RESTORE DATABASE');

并通过WHILE循环每5秒监控一次，直到percent_complete达到100%。

原因分析 #

SQL Server的PRINT语句默认会缓存输出内容，直到脚本执行完毕或缓存阈值触发才一次性输出，这是导致延迟输出的核心原因。要实现实时打印，需要强制刷新输出缓存。

实时打印的实现方法 #

方法1：用RAISERROR替代PRINT（兼容全版本SQL Server） #

RAISERROR支持WITH NOWAIT参数，可强制立即输出内容，不会缓存。修改后的测试代码如下：

DECLARE @Counter INT 
SET @Counter = 1

WHILE (@Counter <= 10)
BEGIN
    RAISERROR('The counter value is = %d', 0, 1, @Counter) WITH NOWAIT
    WAITFOR DELAY '00:00:01'
    SET @Counter = @Counter + 1
END

参数说明：

• %d是整数占位符，用于替换@Counter变量
• 消息级别设为0表示非错误提示
• 状态值设为1即可满足需求
• WITH NOWAIT是实现实时输出的关键

方法2：PRINT配合sys.sp_executesql（适用于SQL Server 2016+） #

在SQL Server 2016及以上版本，可通过调用空的系统存储过程触发输出缓存刷新，代码如下：

DECLARE @Counter INT 
SET @Counter = 1

WHILE (@Counter <= 10)
BEGIN
    PRINT 'The counter value is = ' + CONVERT(VARCHAR, @Counter)
    EXEC sys.sp_executesql N'' -- 空执行触发输出刷新
    WAITFOR DELAY '00:00:01'
    SET @Counter = @Counter + 1
END

备份/恢复进度监控脚本 #

结合你的需求，以下是实时监控备份、恢复进度的脚本，每5秒刷新一次：

DECLARE @Progress DECIMAL(5,2)
DECLARE @Message VARCHAR(100)

-- 获取初始进度
SELECT @Progress = percent_complete
FROM sys.dm_exec_requests r 
CROSS APPLY sys.dm_exec_sql_text(r.sql_handle) a 
WHERE r.command IN ('BACKUP DATABASE', 'RESTORE DATABASE')

-- 循环监控直到完成
WHILE @Progress < 100
BEGIN
    SET @Message = '当前进度: ' + CONVERT(VARCHAR, ROUND(@Progress, 2)) + '%'
    RAISERROR(@Message, 0, 1) WITH NOWAIT
    
    WAITFOR DELAY '00:00:05'
    
    -- 更新进度值
    SELECT @Progress = percent_complete
    FROM sys.dm_exec_requests r 
    CROSS APPLY sys.dm_exec_sql_text(r.sql_handle) a 
    WHERE r.command IN ('BACKUP DATABASE', 'RESTORE DATABASE')
END

-- 完成提示
RAISERROR('备份/恢复已完成！进度: 100%', 0, 1) WITH NOWAIT

内容的提问来源于stack exchange，提问作者Tax Max