Oracle Plsql Ptbr

oracle-plsql-ptbr — v2.0.0

PL/SQL Oracle 19c seguindo Trivadis Guidelines 4.4. Foco em código correto, seguro e performático.

Desenvolvido por: Maxwell da Silva Oliveira — M&S do Brasil LTDA

Áreas cobertas

| Área | Reference | Assets | |---|---|---| | EBR (zero downtime) | references/ebr-editioning-views.md | (conceitual) | | PL/SQL | references/ → oracle-trivadis-ptbr | package_header.sql, package_body.sql, exception_template.sql, bulk_processing_template.sql, dml_alternatives_to_plsql.sql, nocopy_for_lobs.sql, clob_blob_operations.sql, logger_integration.sql, triggers_canonicos.sql |

> Referência cruzada de nomenclatura: padrão Trivadis 4.4 completo (prefixos, estrutura, naming PT-BR) está em oracle-trivadis-ptbr. Esta skill aplica as convenções automaticamente — carregue oracle-trivadis-ptbr quando o foco for revisão explícita de padrão.

Quando ativar

• Criação ou refatoração de packages, procedures, functions, types
• BULK COLLECT + FORALL (loop PL/SQL em volume)
• NOCOPY para BLOB/CLOB > 100KB ou collections grandes em IN OUT
• EXECUTE IMMEDIATE com bind variables (SQL dinâmico)
• MERGE INTO como substituto de loop SELECT/INSERT/UPDATE
• LOBs: leitura em chunks, Base64, SHA-256, DBMS_LOB
• Compound trigger (auditoria, surrogate keys, cross-edition)
• EBR: editioning views, cross-edition triggers, deploy zero downtime
• Logger (OraOpenSource): logerror, logwarn, loginfo, logpermanent
• Qualquer menção a AUTONOMOUSTRANSACTION, PRAGMA, DBMSERRLOG

Não usar para: APEX pages/regions/items, ORDS endpoints/modules, DBA ops (sessão/lock/tablespace), tuning de queries.

Princípios canônicos

1. SQL puro antes de PL/SQL. Se MERGE, INSERT SELECT ou UPDATE com CASE resolve — use. PL/SQL só quando há lógica de negócio por linha, chamadas externas ou coordenação complexa.
2. Bind variables sempre. Em EXECUTE IMMEDIATE use USING. Identificadores dinâmicos → DBMS_ASSERT.simple_sql_name.
3. Bulk em loops. BULK COLLECT + FORALL. Com LIMIT para volumes > 100k. DBMS_ERRLOG quando cabe DML único.
4. Exception com contexto. lc_nome_unidade CONSTANT VARCHAR2(60) em toda procedure pública. Re-raise via raise_application_error.
5. ROLLBACK explícito antes do re-raise em handlers com DML. Caller decide o commit.
6. Logger em vez de DBMS_OUTPUT em produção.
7. Privilégios mínimos. Schema owner faz DDL; app user faz DML.
8. Auditabilidade. criado_em, criado_por, atualizado_em, atualizado_por em tabelas de domínio.
9. NOCOPY para LOB/collection grande em IN OUT/OUT.
10. Triggers não contêm regra de negócio. Auditoria, surrogate key, cross-edition EBR.
11. Sempre compound trigger quando trigger é necessário.
12. EBR para zero downtime. Editioning views + editions + cross-edition triggers.

Fluxo de uso

Criar código: SQL puro resolve? → dml_alternatives_to_plsql.sql. Não → clone template da área → adapte naming Trivadis → use Logger.

Revisar código: Princípio #0 primeiro. Depois antipatterns: concatenação em SQL dinâmico, loop linha-a-linha, WHEN OTHERS THEN NULL, DBMS_OUTPUT em produção, falta NOCOPY em LOB IN OUT. Para naming explícito → oracle-trivadis-ptbr.

Referências cruzadas

| Precisa de | Skill | |---|---| | Naming, prefixos, checklist Trivadis | oracle-trivadis-ptbr | | APEX page process, dynamic action, IG | oracle-apex-ptbr | | ORDS handler, módulo REST | oracle-ords-ptbr | | Sessão, lock, flashback, tablespace | oracle-dba-ptbr | | Explain plan, AWR, index, tuning | oracle-tuning-ptbr |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Maxwbh
• Source: Maxwbh/oracle-skills-ptbr
• License: MIT
• Homepage: https://maxwbh.github.io/oracle-skills-ptbr/

Install and usage instructions live in the source repository linked above.