AppInfo (APP) 接続パラメータ

データベースサーバからの特定のクライアント接続の開始を、管理者が容易に識別できるようにします。

構文

{ AppInfo | APP }=keyword=value

使用法

指定可能な値

クライアントは、固有の文字列を指定できます。指定した文字列は、生成された文字列に追加されます。AppInfo プロパティ文字列は、セミコロンで区切られた key=value ペアのシーケンスです。有効なキーは次のとおりです。

API DBLIB、ODBC、OLEDB、ADO.NET、iAnywhereJDBC、PHP、PerlDBD、DBEXPRESS のいずれか
APPINFO 接続文字列に AppInfo を指定したときに入力される文字列
EXE クライアント実行プログラムの名前 (Windows、Linux、Solaris)
HOST クライアントコンピュータのホスト名
IP クライアントコンピュータの IP アドレス
OS オペレーティングシステム名とバージョン番号 (Windows XP など)
OSUSER クライアントプロセスに関連付けられたオペレーティングシステムユーザ名。クライアントプロセスで別のユーザを同一化している場合 (UNIX の場合は、セット ID ビットが設定されている場合)、同一化されたユーザ名が返されます。バージョン 10.0.1 以前のクライアントと HTTP や TDS クライアントでは、空の文字列を返します。
PID クライアントのプロセス ID (Windows と UNIX のみ)
THREAD クライアントのスレッド ID (Windows と UNIX のみ)
TIMEZONEADJUSTMENT 接続のローカル時間を表示するために協定世界時 (UTC: Coordinated Universal Time) に加算する必要がある分数
VERSION 主要なバージョン番号、それ以外のバージョン番号、ビルド番号を含む、使用しているクライアントライブラリのバージョン (16.0.0.1403 など)

デフォルト

備考

この接続パラメータは、Embedded SQL、ODBC、OLE DB、または ADO.NET クライアント、および SQL Anywhere JDBC ドライバを使用するアプリケーションから、データベースサーバに送信されます。Sybase Open Client または jConnect アプリケーションから使用することはできません。

このパラメータは、クライアントコンピュータの IP アドレスや実行されているオペレーティングシステムなどの、クライアントプロセスについての情報を保持するように生成された文字列で構成されています。文字列は、接続するデータベースサーバに関連付けられており、次の文を使用して検索できます。

SELECT CONNECTION_PROPERTY( 'AppInfo' );

クライアント接続パラメータにデバッグログファイルを指定すると、そのファイルに AppInfo 文字列が追加されます。

参照

例

Interactive SQL からのサンプルデータベースに接続します (デフォルトで SQL Anywhere JDBC ドライバを使用します)。

dbisql -c "UID=DBA;PWD=sql;DBF=%SQLANYSAMP16%\demo.db"

アプリケーション情報を表示します。

SELECT CONNECTION_PROPERTY( 'AppInfo' );

結果は、次のとおりです (1 つの文字列で表示されます)。

IP=ip-address;
HOST=computer-name;
OSUSER=user-name;
OS='Windows XP Build 2600 Service Pack 2';
EXE='C:\Program Files\SQL Anywhere 16\Bin32\dbisql.exe';P
ID=0xcac;
THREAD=0xca8;VERSION=16.0.0.1403;
API=iAnywhereJDBC;
TIMEZONEADJUSTMENT=-240

AppInfo プロパティにユーザ固有の情報を追加して、Interactive SQL からサンプルデータベースに接続します。

dbisql -c "UID=DBA;PWD=sql;DBF=%SQLANYSAMP16%\demo.db;APP=Interactive SQL connection"

アプリケーション情報を表示します。

SELECT CONNECTION_PROPERTY( 'AppInfo' );

結果は、次のとおりです (1 つの文字列で表示されます)。

IP=ip-address;
HOST=computer-name;
OSUSER=user-name;
OS=Windows XP Build 2600 Service Pack 2;
EXE=C:\Program Files\SQL Anywhere 16\Bin32\dbisql.exe;
PID=0xcac;
THREAD=0xba8;
VERSION=16.0.0.1403;
API=iAnywhereJDBC;
TIMEZONEADJUSTMENT=-240;
APPINFO='Interactive SQL connection'

DocCommentXchange で意見交換できます