Oracle SQL Developerコマンド・ライン(SQLcl)は、SQL*Plus と SQL Developerの機能を組み合わせたOracle Database用のコマンドライン・インタフェースです。SQLclを使用して、ウォレットなしで TLS認証を使用して Autonomous Databaseに接続できます。SQLclは、インライン編集、ステートメントのコンプリート、コマンド呼び出しなど豊富な機能を提供します。
ということで、Macbooke へ SQLclを使用して、WalletなしでTLS認証を使用してAutonomous Databaseに接続してみてみます。

■ 環境イメージ

今回、FastConnect でオンプレミスと Oracle Cloud Infrastructure(OCI)を接続し、Macbook から Autonomous Database へ SQLcl 接続します。

■ macOSでのJDKのインストール

SQLclを実行するには、Oracle Java 11以降のバージョンをインストールする必要があります。Javaバージョンが11未満の場合、SQLcl実行は失敗し、次のエラー・メッセージが表示されます。

・sqlcl 実行

oracle@macbook ~ % sql /nolg

	Warning: Found incompatible $ORACLE_HOME for database version 19
	         Thick driver unavailable for use.
	
	
	Error: SQLcl requires Java 11 and above to run.
	       Found Java version .
	       Please set JAVA_HOME to appropriate version.

・ macOSのデフォルトのJDKバージョンの確認

oracle@macbook ~ % java -version
    The operation couldn’t be completed. Unable to locate a Java Runtime.
    Please visit http://www.java.com for information on installing Java.

● JDK Development Kit 22 downloads

macOSにJDKをインストールするには、必要な ARM64 DMG Installer ファイルを、Java Downloadsからダウンロードします

● JDK Development Kit 22 Install

1) Installer 実行
ダウンロードした dmgファイルをクリック

2) JDK インストーラー画面
[続ける]をクリック

3) インストール先画面
[続ける]をクリック

4) インストールの種類画面
[インストール]をクリック

5) インストール中画面

6) インストール完了画面
[閉じる]をクリック

● JDK Install 確認

次のコマンドでインストールしたJAVA Versionを確認

oracle@macbook ~ % java -version
	java version "22" 2024-03-19
	Java(TM) SE Runtime Environment (build 22+36-2370)
	Java HotSpot(TM) 64-Bit Server VM (build 22+36-2370, mixed mode, sharing)

■ SQLcl インストール

● SQLcl ダウンロード

SQLcl Downloadsから SQLclをダウンロード

● SQLcl インストール

1) Install Directory 作成

oracle@macbook ~ % mkdir ~/oracle

2) SQLcl Zipファイル配置

oracle@macbook ~ % ls -l ~/oracle
	-rw-r--r--@  1 oracle  staff  70205047 Apr 13 07:05 sqlcl-23.4.0.023.2321.zip

3) SQLcl Zipファイル解凍

oracle@macbook ~ % cd ~/oracle
oracle@macbook oracle % unzip sqlcl-23.4.0.023.2321.zip
oracle@macbook oracle % ls -l
	drwxr-xr-x@ 10 oracle  staff       320 Apr 13 07:19 sqlcl
	-rw-r--r--@  1 oracle  staff  70205047 Apr 13 07:05 sqlcl-23.4.0.023.2321.zip
oracle@oracle-mac ~ % ls -l ~/oracle/sqlcl
  -rw-r--r--@  1 oracle  staff    44 Jan 23 23:23 23.4.0.023.2321
  -rw-rw-rw-@  1 oracle  staff   216 Jan 23 23:25 LICENSE.txt
  -rw-rw-rw-@  1 oracle  staff   192 Jan 23 23:25 NOTICES.txt
  -rw-rw-rw-@  1 oracle  staff   348 Jan 23 23:25 THIRD-PARTY-LICENSES.txt
  drwxr-xr-x@  7 oracle  staff   224 Apr 13 07:18 bin
  drwxr-xr-x@ 90 oracle  staff  2880 Jan 23 23:25 lib
  drwxr-xr-x@  4 oracle  staff   128 Apr 13 07:19 network

■ SQLcl動作確認

● 環境変数設定

1) .bash_profile設定

oracle@macbook oracle % cat ~/.bash_profile

	export PATH=/Users/oracle/bin:$PATH

	export ORACLE_HOME=/Users/oracle/oracle/sqlcl
	export TNS_ADMIN=$ORACLE_HOME/network/admin
	export PATH=$ORACLE_HOME/bin:$PATH
	export LD_LIBRARY_PATH=$ORACLE_HOME
	export ORACLE_SID=ADB

2) .bash_profile 実行

oracle@macbook ~ % source ~/.bash_profile
oracle@macbook ~ % env | grep ORA
    ORACLE_HOME=/Users/oracle/oracle/sqlcl
    ORACLE_SID=ADB

● tnsnames.ora設定

1) Autonomous Database画面
OCIコンソールから対象の Autonomous Database画面の[データベース接続]をクリック

2) データベース接続画面
接続文字列をコピーします

3) tnsnames.ora設定
今回の Oracle Clientは、FastConnect接続されたオンプレミス環境なので、Autonomous Database のプライベート・エンドポイントIP を設定します。
DNS, /etc/hosts等でホスト名解決できる場合は、プライベート・エンドポイントURLを設定します。

oracle@macbook oracle % cat $ORACLE_HOME/network/admin/tnsnames.ora

ADB =
	(description= (retry_count=20)(retry_delay=3)
		(address=(protocol=tcps)(port=1521)
		(host=10.0.0.2))
		(connect_data=(service_name=adb_tp.adb.oraclecloud.com))
		(security=(ssl_server_dn_match=no)))

oracle@macbook oracle % sql admin/<Password>@ADB

	Warning: Found incompatible $ORACLE_HOME for database version 19
			Thick driver unavailable for use.



	SQLcl: 日 4月 14 21:23:02 2024のリリース23.4 Production

	Copyright (c) 1982, 2024, Oracle.  All rights reserved.

	Last Successful login time: 日 4月  14 2024 21:23:03 +09:00

	接続先:
	Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
	Version 19.23.0.1.0

SQL> select * from v$instance;

   INSTANCE_NUMBER INSTANCE_NAME    HOST_NAME    VERSION       VERSION_LEGACY    VERSION_FULL    STARTUP_TIME    STATUS    PARALLEL       THREAD# ARCHIVER    LOG_SWITCH_WAIT    LOGINS     SHUTDOWN_PENDING    DATABASE_STATUS    INSTANCE_ROLE       ACTIVE_STATE    BLOCKED       CON_ID INSTANCE_MODE    EDITION    FAMILY    DATABASE_TYPE
__________________ ________________ ____________ _____________ _________________ _______________ _______________ _________ ___________ __________ ___________ __________________ __________ ___________________ __________________ ___________________ _______________ __________ _________ ________________ __________ _________ ________________
                 2 adb2                          19.0.0.0.0    19.0.0.0.0        19.23.0.1.0     24-04-06        OPEN      YES                  2 STARTED                        ALLOWED    NO                  ACTIVE             PRIMARY_INSTANCE    NORMAL          NO                 0 REGULAR          EE                   RAC

■ 参考

　・ Installation of the JDK on macOS
　・ Java Downloads
　・ SQLcl Downloads
　・ Oracle SQLclを使用した接続
　・ WalletなしでOracle SQLcl Cloudを接続
　・ SQLclのFAQ
　・ Oracle SQLclの使用
　・ Oracle JDK 22 Certified System Configurations