ADBへクレデンシャル・ウォレットを利用して接続 [SQL*Plus][SQL Developer]

Last updated at 2025-11-10Posted at 2025-11-10

この記事について

Autonomous Database にクレデンシャル・ウォレットを使用して接続する

クレデンシャル・ウォレットのダウンロード

↓ OCIのコンソールにアクセスし、左上のメニューから Oracle AI Database を選択
Oracle AI Databaseのメニュー一覧が表示されたら、 Autonomous AI Database をクリック

↓ 作成したATPインスタンスをクリックし、ATPインスタンスの詳細画面を表示。

↓ 詳細画面のデータベース接続をクリック

↓ ダウンロードウィザードが起動するので、ウォレットのダウンロードをクリック

↓ ウォレットファイルに付与するパスワードを入力し、ダウンロードをクリックして、手元のPCの任意の場所に保存

↓ 接続文字列は以下の通り

設定ファイルの編集

作成したADBインスタンスに接続するためには、
接続に使用するクライアントの設定ファイルの編集を行う必要がある
この設定を OCI Cloud Shell で行う

Cloud Shellは、
Oracle CloudコンソールからアクセスできるWebブラウザ・ベースのターミナルで、
Oracle Cloud Infrastructureの全ユーザーが利用可能
ローカルの端末にOCI-CLIをインストールせずとも、コンソール上でコマンドベースの操作が可能

↓ Cloud Shellを開く
Oracle Cloud Infrastructureのテナンシにサインインし、
コンソールのヘッダーにあるコマンド・プロンプト・アイコンをクリック

↓ Cloud Shell環境が作成され、
コマンドを実行したりAutonomous Databaseに接続したりすることが可能
Cloud Shellの起動には、約1分ほどの時間がかかる

↓ ADB WalletをCloud Shell上にアップロードする
Cloud Shellの上部のメニューをクリックし「アップロード」をクリック
ダウンロードしたファイルを"Drag & Drop"する
Cloud Shellの画面に、ファイルを直接"Drag & Drop"してアップロードすることも可能

↓ lsコマンドで、ファイルが正しくアップロードされていることを確認します。

ls

「Wallet_aitestatp001.zip」が存在していればOKです。

↓ 出力例

$ ls
command_compute-capacity-report  compartment_id.txt  input.json  sche2.json  shape-availabilities_standarde5.json  Wallet_aitestatp001.zip

格納用のディレクトリを作成し、ウォレットファイルを$HOME/network/admin 配下に移動
格納用のディレクトリを作成する

mkdir -p ~/network/admin

ウォレットファイル Wallet_atp01.zip を移動

mv Wallet_aitestatp001.zip ~/network/admin

作成したディレクトリに移動し、圧縮されたウォレットファイルを展開
作成したディレクトリに移動

cd ~/network/admin
unzip Wallet_atp01.zip

↓ lsコマンドでadminディレクトリ内のファイルを一覧し、次のようなファイルが揃っていればOK

$ ls
cwallet.sso  ewallet.p12  ewallet.pem  keystore.jks  ojdbc.properties  README  sqlnet.ora  tnsnames.ora  truststore.jks  Wallet_aitestatp001.zip

↓ TNS_ADMIN 環境変数にウォレットの保存先を設定します。

export TNS_ADMIN=~/network/admin

↓ 出力例

$ export TNS_ADMIN=~/network/admin
$
$ env | grep TNS
TNS_ADMIN=/home/xxxxxxxxxxxxxxxx/network/admin

↓ sqlnet.ora の下記の行を編集し、ウォレットの保存先を置き換える
前の手順で、保存先をTNS_ADMIN環境変数に格納しているため、こちらを使用する

編集前：

WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="?/network/admin")))

編集後：

WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=$TNS_ADMIN)))

↓ 環境変数"ORACLE_HOME"を設定

export ORACLE_HOME=~

echoコマンドで中身を確認し、/home/[username] が出力されればOK

echo $ORACLE_HOME

↓ tnsnames.oraから、接続用のサービス情報を確認
次にように４つの接続サービスがあることが分かる

$ cat tnsnames.ora 
aitestatp001_high = (description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-chicago-1.oraclecloud.com))(connect_data=(service_name=g2b790413f0a7c4_aitestatp001_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))

aitestatp001_low = (description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-chicago-1.oraclecloud.com))(connect_data=(service_name=g2b790413f0a7c4_aitestatp001_low.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))

aitestatp001_medium = (description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-chicago-1.oraclecloud.com))(connect_data=(service_name=g2b790413f0a7c4_aitestatp001_medium.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))

aitestatp001_tp = (description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-chicago-1.oraclecloud.com))(connect_data=(service_name=g2b790413f0a7c4_aitestatp001_tp.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))

aitestatp001_tpurgent = (description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-chicago-1.oraclecloud.com))(connect_data=(service_name=g2b790413f0a7c4_aitestatp001_tpurgent.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))

ADBに接続

SQL*Plus を使った接続 (on Cloud Shell)

Cloud Shellには、SQL Plusのクライアントが実装されているため、
OCI上のADBに簡単に接続が可能

↓ 次のコマンドをCloud Shellのターミナルに入力し、ADBにSQL*Plusを起動する

sqlplus [username]/[password]@[接続サービス名]

SQL> 
SQL> SELECT USERNAME FROM USER_USERS ;

USERNAME
--------------------------------------------------------------------------------
ADMIN

SQL> 
SQL>