Os trabalhos do agente do SQL Server falham quando os trabalhos contêm etapas de trabalho que usam tokens após a instalação do SQL Server 2005 Service Pack 1

Bug #: 426808 (SQLBUDT)

Sintomas

Após a instalação do Microsoft SQL Server 2005 Service Pack 1 (SP1), você enfrenta o seguinte comportamento:

  • Os trabalhos do agente do SQL Server falham quando os trabalhos contêm etapas de trabalho que usam tokens.

  • A seguinte mensagem de erro é exibida:

    A etapa Job contém um ou mais tokens. Para o SQL Server 2005 Service Pack 1 ou versões posteriores, todas as etapas do trabalho com tokens devem ser atualizadas com uma macro antes que o trabalho possa ser executado.

Observação Esse problema ocorre com o Build 2046 ou versões posteriores do SQL Server 2005.

Causa

No SQL Server 2005 SP1, a sintaxe do token de etapa do trabalho do agente do SQL Server foi alterada. Agora, você deve incluir uma macro de escape com todos os tokens usados nas etapas do trabalho. Se você não incluir uma macro de escape, essas etapas do trabalho falharão. A tabela a seguir lista as macros de escape.

Macro de escape

Descrição

$(ESCAPE_SQUOTE(TokenName))

Esta macro escapa apóstrofos (') na cadeia de caracteres de substituição de token. A macro substitui um apóstrofo por dois apóstrofos.

$(ESCAPE_DQUOTE(TokenName))

Esta macro escapa as aspas (") na cadeia de caracteres de substituição de token. A macro substitui uma aspa com duas aspas.

$(ESCAPE_RBRACKET(TokenName))

Esta macro escapa os colchetes retos (]) na cadeia de caracteres de substituição de token. A macro substitui um colchete direito por dois colchetes à direita.

$ (ESCAPE_NONE (tokenname))

A macro substitui um token sem escapar qualquer caractere na cadeia de caracteres. Essa macro é fornecida para dar suporte à compatibilidade com versões anteriores em ambientes nos quais cadeias de caracteres de substituição de token são esperadas apenas de usuários confiáveis.

Por exemplo, uma etapa de trabalho pode conter a seguinte instrução Transact-SQL que usa o token a-DBN :

CREATE DATABASE [$(A-DBN)]

Neste exemplo, você deve atualizar a sintaxe do token para a seguinte sintaxe:

CREATE DATABASE [$(ESCAPE_RBRACKET(A-DBN))]

Essa alteração é diferente do comportamento anterior do SQL Server 2005, em que as macros de escape não eram necessárias.

Resolução

Para solucionar esse problema, atualize todos ou apenas trabalhos específicos que usam tokens para a nova sintaxe de token. Para fazer isso, use o procedimento armazenado sp_AddEscapeNoneToJobStepTokens . Você pode criar esse procedimento armazenado usando o seguinte script Transact-SQL.Observação Certifique-se de que a compilação do SQL Server 2005 SP1 instalada seja a compilação 2046 ou posterior. Além disso, você deve ser membro da função de servidor fixa sysadmin para executar o script.

      -- This script is used to automatically edit SQL Agent job steps so that-- unescaped tokens are prefaced with the ESCAPE_NONE syntax that was added in-- SQL Server 2005 SP1.if (@@microsoftversion < 0x90007FE)BEGIN    RAISERROR('This script should only be run on at least SQL Server 2005 SP1.', 20, 127) WITH LOG    returnENDuse msdbgoif exists (select * from sys.objects where name = N'fn_PrefaceTokensWithEscapeNone' and type = 'FN')    drop function fn_PrefaceTokensWithEscapeNonego-- This function manipulates @commands so that all bare tokens-- are prefaced with ESCAPE_NONE.create function fn_PrefaceTokensWithEscapeNone(@commands nvarchar(max)) RETURNS nvarchar(max)ASBEGIN    if (@commands IS NULL)    BEGIN        return @commands    END    -- In order to let this script run under SQLCMD mode, we define    -- the special "$(" variable start string by concatenation so that    -- sqlcmd mode does not think that we are defining one of its variables.    declare @strVariableStart nchar(2)    select @strVariableStart = N'$' + N'('    declare @idxTokenStart int    select @idxTokenStart = CHARINDEX(@strVariableStart, @commands)    while (@idxTokenStart != 0 and @idxTokenStart is not null)    BEGIN        declare @idxCloseParen int        select @idxCloseParen = CHARINDEX(N')', SUBSTRING(@commands, @idxTokenStart, LEN(@commands)))        -- Error checking. If there is no close parenthesis, return.        if (0 = @idxCloseParen)        BEGIN            return @commands        END        -- Deduce the token variable.        declare @tokenLen int        select @tokenLen = @idxCloseParen - LEN(@strVariableStart) - 1        declare @token nvarchar(max)        select @token = SUBSTRING(@commands, @idxTokenStart + LEN(@strVariableStart), @tokenLen)        -- Verify if @token contains a mis-matched number of open and        -- close parens. This behavior could happen if invalid syntax is        -- in a comment block. If so, skip to the next token.        declare @idx int        declare @cOpenParens int        declare @cCloseParens int        select @cOpenParens = 0        select @idx = CHARINDEX(N'(', @token);        while (@idx != 0)        BEGIN            select @cOpenParens = @cOpenParens + 1            select @idx = CHARINDEX(N'(', @token, @idx + 1);        END        select @cCloseParens = 0        select @idx = CHARINDEX(N')', @token);        while (@idx != 0)        BEGIN            select @cCloseParens = @cCloseParens + 1            select @idx = CHARINDEX(N')', @token, @idx + 1);        END        -- Special case for the WMI token.        if (N'WMI(' = SUBSTRING(@token, 1, LEN(N'WMI(')))        BEGIN                select @cOpenParens = @cOpenParens - 1        END        if ((@cOpenParens = @cCloseParens) and            (N'ESCAPE_NONE(' != SUBSTRING(@token, 1, LEN(N'ESCAPE_NONE('))) and            (N'ESCAPE_SQUOTE(' != SUBSTRING(@token, 1, LEN(N'ESCAPE_SQUOTE('))) and            (N'ESCAPE_DQUOTE(' != SUBSTRING(@token, 1, LEN(N'ESCAPE_DQUOTE('))) and            (N'ESCAPE_RBRACKET(' != SUBSTRING(@token, 1, LEN(N'ESCAPE_RBRACKET('))))        BEGIN            select @commands = STUFF(@commands, @idxTokenStart + LEN(@strVariableStart), @tokenLen, N'ESCAPE_NONE(' + @token + N')')        END        select @idxTokenStart = CHARINDEX(@strVariableStart, @commands, @idxTokenStart + 1)    END    return @commandsENDgoif exists (select * from sys.objects where name = N'sp_AddEscapeNoneToJobStepTokens' and type = 'P')    drop procedure sp_AddEscapeNoneToJobStepTokensgo-- This procedure allows you to update jobs so that bare tokens-- are prefaced with ESCAPE_NONE. By default, all jobs are updated.-- You can optionally specify @job_name, @job_id, or @owner_name-- to limit the jobs that will be affected.CREATE PROCEDURE sp_AddEscapeNoneToJobStepTokens(    @job_name nvarchar(128) = null,    @job_id uniqueidentifier = null,    @owner_name nvarchar(256) = null)AS  -- Find the jobs to update. These jobs must match all of the input  -- criteria, unless all of the inputs are null. In this case,   -- examine all jobs.  The jobs must also be jobs created locally,  -- such as sysjobs.originating_server_id = 0. These jobs should not be a job that we run  -- because another server told us to.  Furthermore, if the job  -- is local but it is meant to be run on a target server, we send an  -- update for the job.  declare @jobsToUpdate TABLE (job_id uniqueidentifier not null)    insert into @jobsToUpdate      select job_id      from sysjobs      where originating_server_id = 0 -- local jobs      and ((COALESCE(@job_name, sysjobs.name) = sysjobs.name) and           (COALESCE(@job_id, sysjobs.job_id) = sysjobs.job_id) and           (COALESCE(@owner_name, suser_sname(sysjobs.owner_sid)) = suser_sname(sysjobs.owner_sid)))    -- Now find the job steps to update, creating the new command by using  -- fn_PrefaceTokensWithEscapeNone.  declare @jobStepsToUpdate TABLE (job_id uniqueidentifier not null,                                    step_id int not null,                                    command_old nvarchar(max) null,                                    command_new nvarchar(max) null,                                   output_file_old nvarchar(max) null,                                    output_file_new nvarchar(max) null)    insert into @jobStepsToUpdate  (job_id, step_id, command_old, command_new, output_file_old, output_file_new)      select job_id, step_id, command, dbo.fn_PrefaceTokensWithEscapeNone(command), output_file_name, dbo.fn_PrefaceTokensWithEscapeNone(output_file_name)      from sysjobsteps      where sysjobsteps.job_id =       (select job_id        from @jobsToUpdate        where job_id = sysjobsteps.job_id)    -- Now we update the actual job step commands. We do this first before  -- we push out the updated jobs to the target servers so the  -- target servers actually get the updated version.  declare @updated_job_id uniqueidentifier  declare @updated_job_step_id int  declare @updated_job_step_command nvarchar(max)  declare @updated_job_step_output_file nvarchar(max)    declare job_steps_cursor CURSOR FOR      select job_id, step_id, command_new, output_file_new      from @jobStepsToUpdate      order by job_id, step_id    OPEN job_steps_cursor  FETCH NEXT from job_steps_cursor into @updated_job_id, @updated_job_step_id, @updated_job_step_command, @updated_job_step_output_file  WHILE (@@FETCH_STATUS <> -1)  BEGIN      IF (@@FETCH_STATUS <> -2)      BEGIN          EXEC sp_update_jobstep @job_id = @updated_job_id, @step_id = @updated_job_step_id, @command = @updated_job_step_command, @output_file_name = @updated_job_step_output_file      END      FETCH NEXT from job_steps_cursor into @updated_job_id, @updated_job_step_id, @updated_job_step_command, @updated_job_step_output_file  END    CLOSE job_steps_cursor  DEALLOCATE job_steps_cursor      -- For multiserver jobs, call the sp_post_msx_operation stored procedure to update  -- all the target servers. Note that the sp_post_msx_operation stored procedure is safe  -- to call because it verifies whether the job is really a multiserver job.  declare jobs_cursor CURSOR FOR      select job_id      from @jobsToUpdate    OPEN jobs_cursor  FETCH NEXT from jobs_cursor into @updated_job_id  WHILE (@@FETCH_STATUS <> -1)  BEGIN      IF (@@FETCH_STATUS <> -2)      BEGIN          EXEC sp_post_msx_operation @operation = 'UPDATE', @job_id = @updated_job_id      END      FETCH NEXT from jobs_cursor into @updated_job_id  END    CLOSE jobs_cursor  DEALLOCATE jobs_cursor  -- List the jobs that we ran on, including the previous command  -- text. We list all of the job steps, even the ones that we did not  -- update. Otherwise, a jumble of job steps from  -- different jobs run together and the output is not  -- useful.  select N'Warning - Jobs Updated' = N'The following job steps and job output file names were analyzed and potentially updated to add the ESCAPE_NONE macro before any job tokens that were not already escaped. Please review the modified job steps and replace ESCAPE_NONE with the correct escape macro.'    select suser_sname(jobs.owner_sid) as N'Job owner',          jobs.name as N'Job name',          jobs.job_id,          jobStepsUpdated.step_id,          N'Modified' = CASE WHEN jobStepsUpdated.command_new != jobStepsUpdated.command_old or jobStepsUpdated.output_file_new != jobStepsUpdated.output_file_old THEN 1 ELSE 0 END,         N'Command' = jobStepsUpdated.command_new,          N'Previous Command' = jobStepsUpdated.command_old,          N'Output file' = jobStepsUpdated.output_file_new,          N'Previous Output file' = jobStepsUpdated.output_file_old      from sysjobs as jobs, @jobsToUpdate as jobsUpdated, @jobStepsToUpdate as jobStepsUpdated      where jobsUpdated.job_id = jobs.job_id and jobsUpdated.job_id = jobStepsUpdated.job_id      order by 'Job name', jobStepsUpdated.step_idgo

Depois que você executar o script, o sp_AddEscapeNoneToJobStepTokens procedimento armazenado será criado. Por padrão, você atualizará todos os trabalhos se executar esse procedimento armazenado sem parâmetros. Se quiser atualizar apenas trabalhos específicos, você deve especificar valores não nulos para pelo menos um dos três parâmetros a seguir:

  • @job_name

  • @job_id

  • @owner_name

Por exemplo, você pode usar a seguinte sintaxe:

  • Atualizar todos os trabalhos:

    EXEC sp_AddEscapeNoneToJobStepTokens
  • Atualize um trabalho especificando o nome do trabalho:

    EXEC sp_AddEscapeNoneToJobStepTokens 'MyJob'
  • Atualizar trabalhos pertencentes ao mesmo proprietário:

    EXEC sp_AddEscapeNoneToJobStepTokens null,null,'JobOwner'

Esse script adiciona a ESCAPE_NONE macro a todas as etapas do trabalho que contêm tokens. Depois de executar esse script, recomendamos que você revise suas etapas de trabalho que usam tokens o mais rápido possível. Em seguida, substitua a ESCAPE_NONE macro por uma das outras macros de escape que seja apropriada para o contexto da etapa do trabalho.Observação Se você estiver trabalhando em um ambiente do servidor mestre (MSX) e destino Server (TSX), você deve executar esse script no MSX e no TSX para garantir que os trabalhos mestres no TSX sejam atualizados corretamente. Para obter mais informações sobre como atualizar trabalhos para usar a nova sintaxe e como usar macros de escape para habilitar a substituição de token em etapas de trabalho do SQL Server Agent, consulte o tópico "usando tokens no trabalho" nos manuais online do SQL Server 2005 (abril de 2006) ou versões posteriores do SQL Server 2005 Books Online.

Status

A Microsoft confirmou que este é um problema nos produtos Microsoft que estão listados na seção "Aplicável a".

Referências

Para obter mais informações sobre como usar tokens nas etapas do trabalho, acesse o seguinte site da Microsoft Developer Network (MSDN):

http://msdn2.microsoft.com/en-us/library/ms175575.aspx

Precisa de mais ajuda?

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Microsoft Insider

Estas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×