{"id":9335,"date":"2026-06-13T11:44:12","date_gmt":"2026-06-13T14:44:12","guid":{"rendered":"https:\/\/executestep.com\/?p=9335"},"modified":"2026-06-13T11:44:14","modified_gmt":"2026-06-13T14:44:14","slug":"sql-patch-injetar-hints-oracle","status":"publish","type":"post","link":"https:\/\/executestep.com\/pt-br\/performance\/sql-patch-injetar-hints-oracle\/","title":{"rendered":"SQL Patch: injetar hints no Oracle sem alterar o c\u00f3digo"},"content":{"rendered":"\n

Voc\u00ea herdou uma query com PARALLEL(16)<\/code> cravado no c\u00f3digo, ou o contr\u00e1rio: precisa for\u00e7ar paralelismo numa query que roda serial e n\u00e3o pode tocar na aplica\u00e7\u00e3o. C\u00f3digo de fornecedor, deploy que n\u00e3o preserva os coment\u00e1rios do SQL, ticket que leva meses para virar release. O SQL Patch<\/strong> existe exatamente para isso: injetar hints em um SQL espec\u00edfico sem alterar uma \u00fanica linha do c\u00f3digo.<\/p>\n\n\n\n

Neste post voc\u00ea vai entender quando o SQL Patch \u00e9 a ferramenta certa, como ele se compara a Baseline e Profile, e vai ter um lab completo no 19c for\u00e7ando paralelismo em uma query serial, com a sa\u00edda real de cada passo.<\/p>\n\n\n\n

O que \u00e9 (e o que n\u00e3o \u00e9) um SQL Patch<\/h2>\n\n\n\n

Um SQL Patch \u00e9 um conjunto de hints que o otimizador passa a aplicar a um SQL identificado pela assinatura do texto. Ele n\u00e3o congela um plano inteiro: apenas adiciona a restri\u00e7\u00e3o do hint e deixa o CBO escolher o melhor plano dentro dela.<\/p>\n\n\n\n

Tr\u00eas pontos que importam no dia a dia:<\/p>\n\n\n\n

    \n
  • N\u00e3o exige Tuning Pack (diferente do SQL Profile).<\/li>\n\n\n\n
  • Sobrevive a deploys da aplica\u00e7\u00e3o que n\u00e3o preservam coment\u00e1rios inline.<\/li>\n\n\n\n
  • \u00c9 leve: guarda hints, n\u00e3o o plano completo com outline.<\/li>\n<\/ul>\n\n\n\n

    Quando o SQL Patch \u00e9 a escolha certa<\/h2>\n\n\n\n
      \n
    • O c\u00f3digo da aplica\u00e7\u00e3o n\u00e3o pode ser alterado.<\/li>\n\n\n\n
    • Voc\u00ea j\u00e1 tentou SQL Plan Baseline e ela n\u00e3o reproduz (REPRODUCED = NO<\/code>).<\/li>\n\n\n\n
    • Voc\u00ea precisa de algo simples: for\u00e7ar um hint espec\u00edfico, sem amarrar o plano inteiro.<\/li>\n\n\n\n
    • Voc\u00ea quer flexibilidade: o CBO continua escolhendo o plano, mas dentro da restri\u00e7\u00e3o do hint.<\/li>\n<\/ul>\n\n\n\n

      SQL Patch vs Baseline vs Profile vs hint inline<\/h2>\n\n\n\n
      Abordagem<\/th>O que faz<\/th>Custo \/ risco<\/th><\/tr><\/thead>
      SQL Patch<\/strong><\/td>Injeta hints espec\u00edficos<\/td>Leve. Sempre aplica o hint. Sem Tuning Pack<\/td><\/tr>
      SQL Plan Baseline<\/strong><\/td>Tenta recriar um plano inteiro<\/td>Pesada. Pode falhar em reproduzir e cair fora<\/td><\/tr>
      SQL Profile<\/strong><\/td>Ajusta estimativas (cardinalidade, custo)<\/td>Precisa de Tuning Pack. N\u00e3o garante o plano<\/td><\/tr>
      Hint inline<\/strong><\/td>Hint no pr\u00f3prio c\u00f3digo<\/td>Some no primeiro deploy que reescreve o SQL<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Resumo pr\u00e1tico: Baseline \u00e9 pesada e pode n\u00e3o reproduzir; Profile mexe em estimativas e exige licen\u00e7a; hint inline morre no deploy. O Patch \u00e9 direto, expl\u00edcito e persistente.<\/p>\n\n\n\n

      Lab: for\u00e7ar PARALLEL sem alterar o c\u00f3digo<\/h2>\n\n\n\n
      \n

      \u26a0\ufe0f Pr\u00e9-requisitos:<\/strong> Enterprise Edition (Parallel Query \u00e9 recurso EE), parallel_max_servers > 0<\/code> (o padr\u00e3o j\u00e1 atende) e privil\u00e9gio para executar DBMS_SQLDIAG<\/code>. Cen\u00e1rio: Oracle 19c, Single Instance.<\/p>\n<\/blockquote>\n\n\n\n

      1. Massa de dados<\/h3>\n\n\n\n

      Uma tabela sem grau de paralelismo definido (DEGREE = 1<\/code>) e sem hint nenhum.<\/p>\n\n\n\n

      <\/circle><\/circle><\/circle><\/g><\/svg><\/span>