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