Oracle SQLcl 25.4 Release Notes

Oracle SQLcl 25.4.1 Release Notes

January 2026

SQLcl on OTN | Getting Started Video | Downloads | FAQ | Forum

 

New Features

  • MCP Tool, run-sql-aynch
    • This feature was previously released as part of the run-sql tool, but was causing issues for certain Agent frameworks. We have added explicit support for this feature to run queries on a background thread via a named tool.

 

25.4.1 Bugs Fixed

  • 38808025 Forums - Backspace character not being recognized on Windows GIT Bash terminals

If your bug fix isn’t listed above, please refer to My Oracle Support to check its status.

 

Support

You are supported by Oracle Support under your current Oracle Database Support license.

Log Oracle SQLcl bugs and issues using My Oracle Support. To determine the version of SQLcl run this command: sql -version

 

Documentation

Documentation on using SQLcl is provided on the oracle.com website here.

 

Requirements

  • Supported Java Version
    • Oracle SQLcl requires Java 17 or 21. The supported Java Runtime Environments are:
      • Oracle Java 17
      • Oracle Java 21
      • Oracle GraalVM Enterprise Edition for Java 17
      • Oracle GraalVM Enterprise Edition for Java 21
  • JavaScript support requires GraalVM for Java 17 with the JavaScript Runtime Plugin

 

Restrictions

This section describes the restrictions on use.

ORACLE_HOME usage

When using an ORACLE_HOME or instant client with SQLcl, the client version must be 23ai.

Liquibase usage with APEX

Liquibase support for APEX requires APEX version 18 and above.

 

Feedback

In the forum, you can discuss topics with the SQLcl community around the world and leave feedback for the development team.

Be sure to use clear subject lines to initiate a thread. Provide a complete and clear description of the issue, including steps to reproduce the issue.

Try to avoid using old, unrelated threads for a new issue.