Oracle SQL Developer Command Line (SQLcl) 22.4 Release Notes

December 2022

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

New Features

    This release has focused on stability closing over 150 issues in the last quarter, with other new features in development for future releases.

  • ARGUMENT command
    • The Argument command in SQLcl allows for default values, prompts, and descriptions of positional parameters to sql scripts. These arguments can be managed using the define command as usual.
    • 
      Example(s):
      Example: Set argument default.
      
      @test
      sql>REM test.sql
      sql>argument 1 default arg1
      sql>argument 2 default arg2
      sql>>select '&1' , '&2' from dual;
      
      'ARG1'  'ARG2'
      ______  ______
      arg1    arg2
      
      1 row selected. 
      
      
      sql> define
      ...
      DEFINE 1 = "arg1" (CHAR)
      DEFINE 2 = "arg2" (CHAR)  
      
      
  • LIQUIBASE Schema for DATABASECHANGELOG
    • ENH 34385737 introduced support for specifying a schema for Liquibase DATABASECHANGELOG TABLE with liquibase-schema-name parameter

Bugs Fixed

Here is a limited list of some high priority bugs fixed for 22.4

34150911 LARGER SET LONG VALUES AND QUERYING CLOBS RESULTS IN MEMORY JAVA STACK JUMP
34280334 SQLCL DO NOT DISPLAY THE FULL POSITION FOR ORA ERRORS
34718099 1 USER-DEFINED EXCEPTION ERROR IN SQLCL FOR ANONYMOUS BLOCKS
34037876 SQL.EXE GIVES UNFRIENDLY ERROR WHEN USING JAVA 8
34796602 IMPROVE HELP EXAMPLES FOR CS, OCI & DATAPUMP COMMANDS
34690300 APEX EXPORT - INSTANCE FAILS WITH SQL STATEMENT TO EXECUTE CANNOT BE EMPTY OR NULL
34741854 DATABASE CHANGELOG_ACTIONS CAN BE INCOMPLETE DUE TO ORA-06502
34801181 LIQUIBASE CHANGELOG FOR QUEUE TABLE WITH PLSQL ARRAY PAYLOAD RESULTS IN SORT ORDER WRONG FOR TYPE AND ARRAY OF TYPE
34696971 LIQUIBASE GENERATE-SCHEMA FAILS WITH UNEXPECTED INTERNAL ERROR NEAR INDEX 1
34742696 LIQUIBASE COMMANDS -DIFF-TYPES NOT BEING HONOR#END REGION
34714807 LIQUIBASE GENERATE-SCHEMA ILLEGAL CHAR  <:> AT INDEX 
34714868 LIQUIBASE USE -SEARCH-PATH PARAMETER TOGETHER WITH LB UPDATE/UPDATE-SQL FAILS ON WINDOWS
34680167 LIQUIBASE FAILS TO PARSE VALID PL/SQL OBJECT
34689522 LIQUIBASE GENERATE-APEX-OBJECT -DIR OPTION IGNORES CAPITALS

 

Before You Start

JRE Support

  • SQLcl release 22.4 requires Oracle Java version 11 or 17.
  • If SQLcl cannot find a local JRE, you will be prompted to enter the location path for the JRE. Note that the prompt wants only the folder, not the java.exe.  For example C:\Program Files\Java\jdk-11.0.11

Known Issues

  • Invoking SQL Recall for a previous statement which has a line exceeding the width of your display, the in-line editor will be unable to access or edit the line with the overflow. Workaround this issue by resizing your terminal display wide enough to prevent line-wrapping.
 


Platform Support

  • SQLcl release 22.4 is available for Windows 10 and Windows Server 2008/2012, Linux or Mac OS X. (See full Certification)
  • If using a OCI “Thick” connection type, a 21c Oracle Client will be required


 
Installing or Upgrading

All new releases of SQLcl and SQL Developer require a full installation. Download and unzip the file into an empty folder. Ensure the "Use folder names" checkbox is checked when unzipping the file.
 

Support

Production Releases - you are supported by Oracle Support under your current database Support license for SQL Developer production releases. Log SQL Developer bugs and issues using My Oracle Support for the product.

Feedback

There are a number of different forums supporting the features in SQLcl. When using the forums, be sure to use clear subject lines to initiate a thread and try to avoid using old, unrelated threads for a new issue.

SQL*Plus List of Unsupported Commands and Features

Commands

  • REPHEADER
  •  REPFOOTER

  • System Variables and Environment Settings via the SET Command

    • autoprint
    • autorecovery
    • cmdsep
    • copytypecheck
    • describe
    • eschar
    • flagger
    • flush
    • fullcolname
    • logsource
    • loboffset
    • markup
    • recsep
    • recsepchar
    • shiftinout
    • sqlcase
    • sqlprefix
    • sqlterminator
    • tab
    • underline
    • xmloptimizationcheck