Variable SQLLOGDIR not found

昨天在一数据库（SQL Server 2008 R2 SP3）上部署了一个作业，今天早上收到告警邮件，作业执行报错“Unable to start execution of step 1 (reason: Variable SQLLOGDIR not found).  The step failed”，刚开始有点莫名其妙，后面检查发现出错的原因是因为在高级选项（Advanced）里面的output file使用了标记（tokens），而SQL Server 2008R2不支持这个。

 

 

 

作业是在SQL Server 2017下创建、测试的，然后生成作业的相关脚本，部署到SQL Server 2008 R2上，部分具体的代码如下所示：

 

EXEC @ReturnCode = msdb.dbo.sp_add_jobstep @job_id=@jobId, @step_name=N'YourSQLDba_Index_Statistics_Maintenance_Step_One',

        @step_id=1,

        @cmdexec_success_code=0,

        @on_success_action=1,

        @on_success_step_id=0,

        @on_fail_action=2,

        @on_fail_step_id=0,

        @retry_attempts=0,

        @retry_interval=0,

        @os_run_priority=0, @subsystem=N'TSQL',

        @command=N'EXECUTE [dbo].[IndexOptimize]

@Databases = ''USER_DATABASES'',

@LogToTable = ''Y''

 

EXECUTE dbo.IndexOptimize @Databases = ''USER_DATABASES'',

@FragmentationLow = NULL,

@FragmentationMedium = ''INDEX_REORGANIZE,INDEX_REBUILD_ONLINE,INDEX_REBUILD_OFFLINE'',

@FragmentationHigh = ''INDEX_REBUILD_ONLINE,INDEX_REBUILD_OFFLINE'',

@FragmentationLevel1 = 5,

@FragmentationLevel2 = 30,

@SortInTempdb = ''Y'',

@MaxDOP = 0,

@UpdateStatistics=''ALL'',

@StatisticsSample=80,

@LogToTable = ''Y''',

        @database_name=N'TMISDB',

    @output_file_name=N'$(ESCAPE_SQUOTE(SQLLOGDIR))\IndexOptimize_$(ESCAPE_SQUOTE(JOBID))_$(ESCAPE_SQUOTE(STEPID))_$(ESCAPE_SQUOTE(STRTDT))_$(ESCAPE_SQUOTE(STRTTM)).txt',

        @flags=0

 

 

关于标记（tokens) SQLLOGDIR的介绍如下;

 

 

(SQLLOGDIR) SQL Server 错误日志文件夹路径的替换标记 – 例如 $(ESCAPE_SQUOTE(SQLLOGDIR))。

 

其实SQL Server Agent的标记（token） SQLLOGDIR是从SQL Server 2014之后才开始支持的。所以需要修改output file设置，取消标记SQLLOGDIR.

 

如需测试当前数据库版本是否支持这个比较，可以创建一个简单作业执行下面命令，个人测试发现，SQL Server 2014以及后续版本才支持这个标记。SQL Server 2008R2、2012等版本皆不支持。

 

PRINT '$(ESCAPE_SQUOTE(SQLLOGDIR))'

 

 

参考资料：

 

    https://docs.microsoft.com/zh-cn/sql/ssms/agent/use-tokens-in-job-steps?view=sql-server-2017