Oracle SQL Developer を導入する【Oracle Instant Client 編】

2021年9月8日

Oracle Database の管理ツールとして無償配布でありデバッグもできる、といえば「Oracle SQL Developer」です。（詳細は「SQL Developer とは何ですか？」参照）
SQL Developer そのものは zip 解凍するだけで利用できますが、データベースに接続するためには通常、Oracleクライアントを別途インストールする必要があります。借用PCやセキュリティの関連でインストールはしたくない、という人のために、今回はインストールを含めてWindowsの環境周りの設定を一切行わずに Oracle SQL Developer を利用するための手順をご紹介したいと思います。
尚、データベースは既に導入済であることが前提で、SQL Developer を利用するOSは Windows10 で行っています。

1. 関連ソフトウェアの入手
- 1.1. Oracle SQL Developer
- 1.2. Oracle Instant Client
2. インストール手順
3. アンインストール手順
- 3.1. 関連

関連ソフトウェアの入手

必要なソフトウェアは「Oracle SQL Developer」と「Oracle Instant Client」のふたつです。
それぞれ ORACLE社のダウンロードサイトからダウンロードを行います。尚、ダウンロードには Oracle プロファイルが必要です。無料で作成できますので、お持ちでない場合は以下の「プロファイルの作成」から作成しておいてください。詳細は割愛します。

Oracle SQL Developer

「Oracle SQL Developerのダウンロード」からダウンロードします。「Windows 64ビット、JDK 8が付属」を利用します。この時点で最新版がダウンロードできます。2021/9/8 時点では"20.4.1″でした。

先に結論を書きますが、最新版（20.4.1）では、この時点でリリースされている Oracle Instant Client の最新版（19.12）を利用するように設定したときの「テスト（後述します）」では以下のようなエラーが発生します。ただし無視して進めてもなぜか接続できてしまいます。上位互換があるからだと思いますが、気持ち悪い人はバージョンを合わせると良いでしょう。

クライアント・ディレクトリをテストしています...OK
Oracle JDBCドライバのロード中をテストしています...OK
Oracle JDBCドライバのバージョンを確認していますをテストしています...失敗: 
  必要な最小ドライバ・バージョンは21.0ですが、指定されたドライバ・バージョンは19.12.0.0.0です

過去のバージョンをダウンロードしたい場合は前述のダウンロードページに「以前のバージョン」というリンクがあるので、そちらを辿るとひとつ前のバージョンのページに遷移します。
以下のスクリーンショットの中央部付近です。私は遡って"19.1.0″をダウンロードしました。

Oracle Instant Client

「Instant Clientのダウンロード – Oracle」からダウンロードします。「Instant Client for Microsoft Windows (x64)」を利用しますので、そちらをクリックします。

インストール手順が表示された画面に遷移します。

なんだか「たらいまわし感」がありますが、実際のダウンロードは「こちら（USサイト）」をクリックして進めます。パッケージには「Basic Package」と「Basic Light Package」があります。後者でも動作すると思いますが、私は「Basic Package」をダウンロードしました。

インストール手順

ダウンロードファイルの展開

以下が今回ダウンロードしたファイルです。これらを任意のフォルダに展開します。
例とするフォルダ名も記載しておきます。

sqldeveloper-19.1.0.094.2042-x64.zip　→　C:\tools\sqldeveloper
instantclient-basic-windows.x64-19.12.0.0.0dbru.zip　→　C:\tools\sqldeveloper\instantclient_19_12

実行するための準備作業

Oracle Instant Client は展開のみでインストーラー等はありません。このOracle Client を利用するためには本来以下のような設定が必要になります。

使用している環境のライブラリ・ローディング・パスを、手順2のディレクトリ（"instantclient"）に設定します。UNIXプラットフォームでは、LD_LIBRARY_PATHがこれに対応する環境変数です。Windowsプラットフォームでは、 PATH環境変数を使用します。
https://www.oracle.com/jp/topics/technologies/winx64soft.html

しかしながら、今回は環境周りの設定を行わずに SQL Developer を実行したいのでシステム詳細設定からのPATHの設定は行わず、PATH設定を行って起動するためのスクリプト（.bat）を作成することにします。
以下の通りのBATファイルを SQL Developer を展開したフォルダに配置します。
（C:\tools\sqldeveloper\sqldeveloper.bat）

@echo off
set top=%~dp0
set path=%top%\instantclient_19_12;%path%
set tns_admin=%top%
start %top%\sqldeveloper.exe

少し解説しておきますと、TNS_ADMIN という環境変数ですが、Oracle のネットワーク関連のパラメータファイル（tnsnames.ora、sqlnet.ora）を参照するためのディレクトリを指しています。今回はいずれのファイルも利用しませんので、TNS_ADMIN は定義するだけになります。
（参考：「TNS_ADMINパラメータについて」）