13.35 PING
構文
PING [[LISTENER] connect_identifier]
データベースまたはデータベース・ネットワーク・リスナーにpingを実行して可用性をチェックします。データベースまたはネットワーク・リスナーのいずれかが使用できない場合、PING
コマンドは失敗となり、エラーが表示されます。これは、ネットワーク・リスナーまたはデータベースを再起動する必要があるか、データベース接続を使用できないため再作成する必要があることを示します。
PING
コマンドが接続識別子なしで実行されると、現在接続されているデータベースにネットワーク・リスナーを介してラウンドトリップ・メッセージが送信されます。接続識別子を使用して実行すると、指定されたネットワーク・リスナーにラウンドトリップ・メッセージが送信され、データベース接続を処理できるかどうかが確認されます。
項
LISTENER
接続識別子で指定されたターゲット・リスナーがアクセス可能かどうかを決定し、ラウンド・トリップがリスナーのpingにかかった合計時間を表示します。これは、Oracle DatabaseのTNSPINGユーティリティに似ています。出力には、tnsnames.ora
ファイルの場所も表示されます(使用されている場合)。
connect_identifier
Oracle Net接続識別子を示します。
例
次の例では、PING
コマンドが実行され、現在の接続のデータベースにpingが送信されます。
PING
Ok (2.669 msec)
次の例では、PING
コマンドが実行され、指定した別名のネットワーク・リスナーにpingが送信されます。
PING INST1
Network service name mapping file: /opt/oracle/tnsnames.ora
Attempting to contact: (DESCRIPTION=(CONNECT_DATA=(SERVICE_NAME=cdb1_pdb1))(ADDRESS=(PROTOCOL=tcp)(HOST=host1.customer.domain.com)(PORT=1521)))
Ok (1.588 msec)
次の例では、PING
コマンドが失敗し、エラー・メッセージが表示されます。
PING INST2
Local Net Naming configuration file: /opt/oracle/tnsnames.ora
Attempting to contact: (DESCRIPTION=(CONNECT_DATA=(SERVICE_NAME=cdb1_pdb1))(ADDRESS=(PROTOCOL=tcp)(HOST=host1.customer.domain.com)(PORT=1521)))
SP2-1683: Ping failed with error TNS-12560.