【Oracle】ネットワーク設定完全ガイド｜tnsnames.ora・listener.ora・sqlnet.ora・lsnrctl・Easy Connect の設定と確認方法まで解説

# $ORACLE_HOME/network/admin/tnsnames.ora
# （クライアント環境では $TNS_ADMIN 環境変数が指すディレクトリも参照される）

# 基本的な接続エントリ（DESCRIPTION を省略した簡略形式）
ORCL =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = db-server.example.com)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = orcl.example.com)   # サービス名（DB_NAME.DB_DOMAIN または DB_SERVICE_NAME）
    )
  )

# SID 形式（古い接続方法。サービス名形式を推奨）
ORCL_SID =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = db-server.example.com)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SID = orcl)   # SID: インスタンス識別子（DB_NAME に相当）
    )
  )

# FAILOVER: 複数ホストへのフェイルオーバー設定
ORCL_HA =
  (DESCRIPTION =
    (FAILOVER = ON)
    (LOAD_BALANCE = OFF)
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = primary-db.example.com)(PORT = 1521))
      (ADDRESS = (PROTOCOL = TCP)(HOST = standby-db.example.com)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = orcl_ha)
    )
  )

# 接続タイムアウトを個別設定する場合（CONNECT_TIMEOUT は sqlnet.ora でも設定可）
ORCL_TIMEOUT =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = db-server.example.com)(PORT = 1521))
    (CONNECT_DATA = (SERVICE_NAME = orcl))
    (RETRY_COUNT = 3)         # 接続リトライ回数
    (RETRY_DELAY = 3)         # リトライ間隔（秒）
    (CONNECT_TIMEOUT = 10)    # 接続タイムアウト（秒）
  )

# $ORACLE_HOME/network/admin/listener.ora

# リスナーの待受アドレス設定（デフォルトリスナー名: LISTENER）
LISTENER =
  (DESCRIPTION_LIST =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = db-server.example.com)(PORT = 1521))
    )
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))   # IPC: ローカル接続用
    )
  )

# 静的サービス登録（動的登録が使えない場合・AS SYSDBA 接続時に必要な場合がある）
SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (SID_NAME = orcl)
      (ORACLE_HOME = /u01/app/oracle/product/19.0.0/dbhome_1)
      (ENVS = "LD_LIBRARY_PATH=/u01/app/oracle/product/19.0.0/dbhome_1/lib")
    )
  )

# 別ポートでリスナーを追加する場合
LISTENER_DEV =
  (DESCRIPTION_LIST =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = db-server.example.com)(PORT = 1522))
    )
  )

# ADR_BASE_LISTENER: リスナーのログ・トレースファイルの出力先
ADR_BASE_LISTENER = /u01/app/oracle

# $ORACLE_HOME/network/admin/sqlnet.ora

# 名前解決の順序（左から順に試みる）
NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT, LDAP)
# TNSNAMES: tnsnames.ora を参照する（最も一般的）
# EZCONNECT: Easy Connect 形式を使う
# LDAP: LDAP/OID で名前解決する

# 接続タイムアウト設定
SQLNET.INBOUND_CONNECT_TIMEOUT = 60    # サーバー: クライアントからの接続確立タイムアウト（秒）
SQLNET.EXPIRE_TIME = 10                # キープアライブの間隔（分）。デッドコネクション検出に使う

# クライアント側の接続タイムアウト
SQLNET.OUTBOUND_CONNECT_TIMEOUT = 15   # 接続確立のタイムアウト（秒）

# ログとトレースの設定（障害調査時に有効にする）
LOG_DIRECTORY_CLIENT = /u01/app/oracle/network/log
LOG_FILE_CLIENT = sqlnet.log
TRACE_LEVEL_CLIENT = OFF               # OFF / USER / ADMIN / SUPPORT

# OS 認証のプレフィックス（OS 認証を使う場合の設定）
OS_AUTHENT_PREFIX = ""                # 空文字にすると OS ユーザー名そのままで認証
# デフォルトは "OPS$" なので、OS ユーザー名が "oracle" の場合は "OPS$ORACLE" ユーザーが必要

# 暗号化（Enterprise Edition のみ）
SQLNET.ENCRYPTION_CLIENT = REQUIRED    # REQUIRED / REQUESTED / ACCEPTED / REJECTED
SQLNET.ENCRYPTION_SERVER = REQUIRED
SQLNET.ENCRYPTION_TYPES_CLIENT = (AES256, AES192)
SQLNET.ENCRYPTION_TYPES_SERVER = (AES256, AES192)

# クライアントの HOSTNAME 解決を無効にする（パフォーマンス向上）
SQLNET.RECV_TIMEOUT = 30              # データ受信タイムアウト（秒）
SQLNET.SEND_TIMEOUT = 30              # データ送信タイムアウト（秒）

# リスナーの起動・停止・再起動
lsnrctl start                     # デフォルトリスナー（LISTENER）を起動
lsnrctl start LISTENER_DEV        # 指定リスナーを起動
lsnrctl stop                      # リスナーを停止
lsnrctl reload                    # listener.ora を再読み込みする（停止なし）

# リスナーの状態確認
lsnrctl status                    # リスナーの状態・登録済みサービスを表示
lsnrctl services                  # サービスの詳細情報を表示

# lsnrctl status の出力例:
# Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=db-server)(PORT=1521)))
# STATUS of the LISTENER
# Alias                     LISTENER
# Version                   TNSLSNR for Linux: Version 19.0.0.0.0
# Start Date                01-APR-2026 10:00:00
# Uptime                    0 days 2 hr. 30 min. 0 sec
# Trace Level               off
# Services Summary...
# Service "orcl" has 1 instance(s).
#   Instance "orcl", status READY, has 1 handler(s) for this service...

# 接続テスト（tnsnames.ora エントリの確認）
tnsping ORCL                       # TNS 名の名前解決テスト
tnsping ORCL 3                     # 3回試す

# tnsping の成功例:
# OK (20 msec)       ← 接続先に到達できた
# TNS-12541: TNS:no listener  ← リスナーが起動していない

# 基本形式: //ホスト:ポート/サービス名
sqlplus hr/hr_password@//db-server.example.com:1521/orcl.example.com

# ポートを省略（デフォルト 1521）
sqlplus hr/hr_password@//db-server.example.com/orcl

# SID 形式（サービス名の代わりに SID を使う場合）
sqlplus hr/hr_password@//db-server.example.com:1521:orcl

# JDBC 接続文字列での Easy Connect（Java アプリケーション向け）
# jdbc:oracle:thin:@//db-server.example.com:1521/orcl.example.com

# sqlnet.ora の NAMES.DIRECTORY_PATH に EZCONNECT が必要
# NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT)

# Easy Connect Plus（Oracle 19c 以降: より豊富なオプションが使える）
# //ホスト:ポート/サービス名?connect_timeout=10&retry_count=3
sqlplus hr/hr_password@"//db-server:1521/orcl?connect_timeout=10"

# ① ping でホスト到達性を確認する
ping db-server.example.com

# ② telnet / nc でポートの到達性を確認する
telnet db-server.example.com 1521
# または: nc -zv db-server.example.com 1521

# ③ tnsping で名前解決と応答を確認する
tnsping ORCL

# ④ lsnrctl status でリスナーとサービスを確認する（サーバー側で実行）
lsnrctl status

# ⑤ sqlnet.ora でトレースを有効にして詳細ログを確認する（クライアント側）
# LOG_DIRECTORY_CLIENT = /tmp
# LOG_FILE_CLIENT = sqlnet.log
# TRACE_LEVEL_CLIENT = SUPPORT

# ⑥ リスナーのログを確認する（サーバー側）
# $ORACLE_BASE/diag/tnslsnr/<hostname>/listener/trace/listener.log

# ⑦ TNSNAMES の解決パスを確認する
# 環境変数 TNS_ADMIN が指すディレクトリの tnsnames.ora を最初に参照する
echo $TNS_ADMIN
ls $TNS_ADMIN/tnsnames.ora
# TNS_ADMIN が未設定の場合: $ORACLE_HOME/network/admin/ を参照