Skip to content

Drop stale describe_synonym comment#283

Merged
yahonda merged 1 commit intorsim:masterfrom
yahonda:fix-describe-synonym-comment
May 5, 2026
Merged

Drop stale describe_synonym comment#283
yahonda merged 1 commit intorsim:masterfrom
yahonda:fix-describe-synonym-comment

Conversation

@yahonda
Copy link
Copy Markdown
Collaborator

@yahonda yahonda commented May 5, 2026

Summary

Both lines of the comment above PLSQL::Connection#describe_synonym (lib/plsql/connection.rb:182-183) are no longer accurate:

  • "all_synonyms view is quite slow" — measured against Oracle 23ai with a 1500-synonym fixture (500 each of table-, function-, and package-targeting synonyms), this method is ~0.43 ms/call, dominated by the network round-trip rather than the dictionary-view query. A DBMS_UTILITY.NAME_RESOLVE-based replacement (mirroring Resolve describe() via DBMS_UTILITY.NAME_RESOLVE oracle-enhanced#2686) measured the same ~0.43 ms/call on the same fixture, confirming the catalog query isn't the bottleneck at ruby-plsql's typical scales. The slow case the original comment was written for (oracle-enhanced#2686 saw 29x on private synonyms in a 1000-object schema) doesn't show up here.
  • "overridden in OCI connection with faster native OCI method" — that override was removed in 4d1f656 (Feb 2018, "Remove OCI8#describe_synonym to follow up Avoid using OCI8#describe_synonym to use the same code #153"), and the preceding commit 1daa6ce had already emptied the body to just super. There is no driver-specific override today.

The method's name and SQL are self-explanatory; removing both lines without a replacement keeps the file accurate.

Test plan

  • CI green — pure comment removal, no behavior change.

🤖 Generated with Claude Code

Both lines of the comment above PLSQL::Connection#describe_synonym are
no longer true:

- "all_synonyms view is quite slow" — measured against Oracle 23ai with
  a 1500-synonym fixture this method is ~0.43 ms/call, dominated by
  network round-trip rather than the dictionary-view query. The slow
  case the comment was written for (oracle-enhanced #2686 saw 29x on
  private synonyms in a 1000-object schema) doesn't show up at the
  scales ruby-plsql actually exercises.
- "overridden in OCI connection with faster native OCI method" — that
  override was removed in 4d1f656 (2018, "Remove OCI8#describe_synonym
  to follow up rsim#153") because the predecessor commit 1daa6ce already
  deleted its body and made it call super. There is no longer any
  driver-specific override.

The method's name and SQL are self-explanatory; removing both lines
without a replacement keeps the file accurate.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@yahonda yahonda merged commit 29244f3 into rsim:master May 5, 2026
20 checks passed
@yahonda yahonda deleted the fix-describe-synonym-comment branch May 5, 2026 15:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant