SQL dinâmico seguro com sp_executesql

SQL dinâmico ajuda em filtros opcionais e formatos variáveis, mas concatenar texto introduz injeção, erros de aspas, pouco reuso de planos e diagnóstico difícil.

Por que este tema exige atenção deliberada

Um problema desse tipo raramente existe isolado. Uma mudança que melhora uma consulta pode aumentar escrita, log, bloqueio, recuperação ou complexidade em outro ponto. Trate o trabalho como decisão de engenharia com objetivo mensurável, restrições conhecidas e responsável claro.

SQL dinâmico é seguro e sustentável quando a estrutura é controlada e os dados continuam parametrizados.

O que medir

Analise como os valores entram, se identificadores são limitados, se parâmetros usam tipos exatos e quantos planos diferentes o texto gera.

Fluxo de diagnóstico

• Defina exatamente o sintoma, carga afetada, início, frequência e impacto visível.
• Capture evidências em períodos normais e degradados para a mesma operação de negócio.
• Separe correlação de causa analisando planos, esperas, recursos, bloqueios, configuração e mudanças recentes.
• Teste grupos representativos de bancos, consultas ou parâmetros, não apenas o exemplo mais simples.
• Preserve configuração, plano, definição e contadores atuais antes de qualquer alteração.
• Expresse numericamente o resultado esperado: latência, CPU, leituras, vazão, fila ou recuperação.

Como escolher a intervenção

Prefira a menor mudança que trate a causa comprovada. Configuração do servidor afeta muitas cargas, enquanto consulta, índice, estatística ou agenda pode ser mais específica. Considere licença, versão, alta disponibilidade, janelas e capacidade de monitoramento da equipe.

Abordagem prática

Passe valores como parâmetros do sp_executesql, limite identificadores e proteja-os com QUOTENAME, mantenha texto estável por formato e registre separadamente modelo e valores.

Sequência segura de implementação

• Reproduza o comportamento em ambiente seguro com dados em escala de produção.
• Altere uma variável importante por vez e preserve a definição original para reversão.
• Meça duração, CPU, leituras, escritas, esperas, memória, geração de log e efeitos posteriores.
• Teste entradas normais, picos e extremos, além de reinício ou failover quando relevante.
• Implante em janela adequada com operador, responsável da aplicação e decisor de reversão disponíveis.
• Revise imediatamente e novamente durante o próximo pico representativo.

Exemplo de SQL Server

O exemplo a seguir é um ponto de partida para investigação ou implementação controlada. Adapte nomes, limites, retenção e permissões antes da produção. Preserve a saída junto da linha do tempo do incidente e não trate uma única amostra como diagnóstico completo.

DECLARE @sql nvarchar(max) =
    N'SELECT OrderId, OrderDate, TotalAmount
      FROM dbo.Orders
      WHERE CustomerId = @CustomerId;';

EXEC sys.sp_executesql
    @sql,
    N'@CustomerId int',
    @CustomerId = 42;

O que evitar

Não concatene entrada do usuário, não use QUOTENAME para valores arbitrários e não declare toda string como nvarchar(max).

Monitoramento após a mudança

Acompanhe a métrica que deveria melhorar e pelo menos dois possíveis efeitos colaterais. Compare janelas e volumes equivalentes. Observe tempo suficiente para incluir manutenção, backups, relatórios, failover e atividades periódicas. Documente se a melhoria persistiu e se a mudança deve permanecer, ser ajustada ou removida.

Reversão e responsabilidade

A reversão deve informar valor ou definição anterior, quem decide e qual sinal dispara a volta. Preserve plano e script originais em mudanças de plano ou metadados. Para infraestrutura, confirme capacidade e tempo de manutenção antes de iniciar.

Resultado operacional

SQL dinâmico é seguro e sustentável quando a estrutura é controlada e os dados continuam parametrizados.

Checklist de produção

Registre uma linha de base e defina a melhoria esperada. Teste com dados e concorrência representativos. Preserve a configuração ou o plano original, prepare uma reversão, implante em uma janela adequada e acompanhe o próximo pico normal de carga.

Perguntas antes de encerrar

• O sintoma original melhorou sob a mesma carga?
• Surgiram custos de escrita, armazenamento, bloqueio, memória ou disponibilidade?
• O resultado sobreviverá a reinício, failover, estatísticas e crescimento?
• Os alertas detectarão regressão antes dos usuários?
• A decisão, o responsável e a data de revisão foram registrados?

Para aplicar esse método a um ambiente SQL Server específico, use o formulário abaixo e informe a versão, o tamanho do banco, o perfil da carga e as evidências já coletadas.