oracle-ords-ptbr — v2.0.0
Oracle REST Data Services — padrões de desenvolvimento e dicionário completo de views de metadados.
Desenvolvido por: Maxwell da Silva Oliveira — M&S do Brasil LTDA
Áreas cobertas
| Área | Reference | Assets |
|---|---|---|
| REST services | references/ords-rest-services.md |
ords_module.sql, ords_handler.sql |
| ORDS Data Dictionary | references/ords-data-dictionary-ptbr.md |
(queries embutidas no reference) |
Quando ativar
ORDS.define_module,ORDS.define_template,ORDS.define_handlerORDS.enable_schema,ORDS.enable_object(AutoREST)ORDS_SECURITY.create_client,ORDS_SECURITY_ADMIN.*(24.4+)OAUTH.*ouOAUTH_ADMIN.*→ alertar depreciação (removidos em ORDS 25.3)ORDS_PAR— Pre-Authenticated Requests (24.4+)ORDS_EXPORT.export_schema— backup/deploy de configuraçãoUSER_ORDS_MODULES,USER_ORDS_HANDLERS,USER_ORDS_SCHEMASDBA_ORDS_*(requerORDS_ADMINISTRATOR) — ORDS 24.4+- Source types:
collection/query,collection/item,plsql/block,mle/javascript - CORS, códigos HTTP REST, versionamento de API, OAuth 2.0
- JWT Profiles,
USER_ORDS_JWT_PROFILE
Não usar para: APEX pages/regions, PL/SQL puro sem REST, DBA ops.
Princípios canônicos
- Hierarquia ORDS: Schema → Module → Template → Handler → Parameter.
- Bind variables sempre: path params (
:id), query string (:status) são bind automático. SQL dinâmico →DBMS_ASSERT. - Source type correto: lista paginada →
collection/query. Um item →collection/item. Lógica complexa →plsql/block. BLOB →media/blob. - Autenticação obrigatória em qualquer endpoint que acesse dado sensível —
ORDS.define_privilege+ role. - OAUTH depreciado em 24.4: migrar para
ORDS_SECURITY/ORDS_SECURITY_ADMIN. Removido em ORDS 25.3. - Versionamento no path:
/recurso/v1/e/recurso/v2/— não via query string. - DBA_ORDS_*: visão cross-schema (ORDS 24.4+). Requer role
ORDS_ADMINISTRATOR. - ORDS_EXPORT: use para CI/CD e backup de configuração.
Referências cruzadas
| Precisa de | Skill |
|---|---|
| PL/SQL dentro de handler (packages, lógica) | oracle-plsql-ptbr |
| Naming e prefixos Trivadis no código | oracle-trivadis-ptbr |
| APEX consumindo endpoints ORDS | oracle-apex-ptbr |
| V$SESSION, locks, DBA operacional | oracle-dba-ptbr |
| Query lenta no handler | oracle-tuning-ptbr |