データベースサーバーへの接続をテストし、オプションでデータベースへの接続をテストします。
構文dbping [ options ]| オプション | 説明 | ||||
|---|---|---|---|---|---|
| @data |
指定された環境変数または設定ファイルからオプションを読み込みます。設定ファイルを参照してください。 設定ファイル内のパスワードなどの情報を保護する場合は、ファイル非表示ユーティリティを使用して、設定ファイルの内容を読みにくくすることができます。ファイル非表示ユーティリティ (dbfhide)を参照してください。 |
||||
| -c "keyword=value; ..." |
サーバーと任意でデータベースへの接続に使用された接続パラメーターを指定します。デフォルトでは、dbping は実行中のサーバーに接続します。データベースに接続するためには -d オプションを指定します。データベースサーバーを見つけられるかどうかのテスト (dbping)を参照してください。 |
||||
| -d |
データベースへの接続をテストします。必要があれば、dbping はサーバーとデータベースを自動的に起動できます。-d があると、dbping は、接続を確立する通常のクライアントアプリケーションのように動作します。 -d オプションを指定した場合、dbping はサーバーとデータベースに接続する処理の成功をレポートします。-d オプションを指定しない場合、dbping はサーバーを検出すると、処理の成功をレポートします。 たとえば、サンプルデータベースを実行する blair という名前のデータベースサーバーがある場合、dbping がサーバー blair に接続できるので、次のコマンドは成功します。
次のコマンドは失敗し、other データベースが実行中ではなかったので、「
|
||||
| -en | 指定したプロパティによって NULL が返された場合に、dbping が失敗を示すリターンコードを返して終了することを指定します。デフォルトでは、 -pc、-pd、-ps のいずれかで指定されたプロパティの値が不明である場合、dbping は NULL を出力し、成功を示すリターンコードを返して終了します。このオプションは、-pc、-pd、-ps を指定する場合のみ使用できます。 | ||||
| -l library |
使用する ODBC ライブラリを指定します (ファイル拡張子は付けません)。このオプションを使用すると、ODBC ドライバーマネージャーの使用が回避されるので、UNIX オペレーティングシステムで便利です。 たとえば、次のコマンドは、ODBC ドライバーを直接ロードします。
UNIX でスレッド接続ライブラリを使用する場合は、ping ユーティリティのスレッドバージョンである dbping_r を使用します。 |
||||
| -m | ODBC を使用して接続を確立します。デフォルトでは、このユーティリティは、Embedded SQL インターフェイスを使用して接続します。 | ||||
| -o filename | 指定したファイルに、出力メッセージを書き込みます。 | ||||
| -pc property,... |
指定されている接続プロパティを表示します。プロパティは、カンマで区切って指定します。このオプションを使用するには、データベース接続を確立するために必要な接続情報を指定してください。接続プロパティ値のアクセスを参照してください。 たとえば、次のコマンドは、接続プロパティとして使用できる fire_triggers オプションの設定を表示します。
|
||||
| -pd property[@db-name],... |
指定されているデータベースプロパティを表示します。プロパティは、カンマで区切って指定します。データベースプロパティ値のアクセスを参照してください。 たとえば、次のコマンドは、データベースで使用されているページサイズを表示します。
必要に応じて、値を取得するデータベースの名前を指定できます。プロパティに @db-name を追加してデータベース名が指定されていない場合は、前のプロパティに指定されたデータベース名が使用されます。 次のコマンドは、データベース mydb で使用されているページサイズと照合を表示します。
|
||||
| -ps property,... |
指定されているデータベースサーバープロパティを表示します。プロパティは、カンマで区切って指定します。このオプションを使用するには、データベース接続を確立するために必要な接続情報を指定してください。データベースサーバープロパティ値のアクセスを参照してください。 たとえば、次のコマンドは、データベースサーバーに対するラインセスシート数またはプロセッサー数を表示します。
|
||||
| -q | クワイエットモードで実行します (メッセージを表示しません)。 | ||||
| -s | dbping を実行しているコンピューターとデータベースサーバーを実行しているコンピューター間のネットワークのパフォーマンス情報を返します。接続速度、遅延時間、スループットの概算値が表示されます。通常は、-c オプションを使用して、サーバー上のデータベースに接続するための接続パラメーターを指定します。dbping -s は Embedded SQL 接続でのみ使用できます。-m または -l を指定した場合、-s オプションは無視されます。デフォルトでは、dbping -s は測定する統計ごとに最低 1 秒間、要求のループ処理を実行します。リソースが浪費されることを防ぐために、処理に要する時間にかかわらず、接続と切断は最高 200 回までしか実行されません。低速のネットワークでは、各統計について最低回数の反復処理を実行するために数秒かかることがあります。パフォーマンス統計は概算値であり、クライアントコンピューターとサーバーコンピューターの両方がアイドル状態である方が統計値の精度は高くなります。Embedded SQL とネットワーク接続パフォーマンスのテスト (dbping)を参照してください。 | ||||
| -st time | -s オプションと同じ情報が返されます。ただし、-st オプションでは、dbping が測定する各統計について要求のループ処理を実行する時間が秒単位で指定されます。このオプションでは、-s を使用した場合より精度の高いタイミング情報を取得できます。Embedded SQL とネットワーク接続パフォーマンスのテスト (dbping)を参照してください。 | ||||
| -z | 接続するために使用されたネットワーク通信プロトコルと、他の診断メッセージを表示します。このオプションは、Embedded SQL 接続が行われるときのみ使用できます。つまり、このオプションは、-m または -l と組み合わせて使用することはできません。 |
備考dbping ユーティリティは、接続の問題をデバッグするのに役立つツールです。これは、完全な接続文字列か部分的な接続文字列を取り、サーバーの検索、またはデータベースへの接続が成功したかどうかを示すメッセージを返します。
このユーティリティは、Embedded SQL または ODBC 接続に対して使用できます。jConnect (TDS) 接続に対しては使用できません。
終了コードは、0 (成功) または 0 以外の値 (失敗) です。
参照 |
DocCommentXchange で意見交換できます
|
Copyright © 2012, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.1 |