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.