AppInfo 连接参数 [APP]

帮助管理员识别某数据库服务器的特定的客户端连接。

用法

任何位置

值

字符串

缺省值

空字符串

注释

此连接参数既可以从嵌入式 SQL、ODBC、OLE DB 或 ADO.NET 客户端发送到数据库服务器，也可使用 iAnywhere JDBC 驱动程序从应用程序发送到数据库服务器。它在 Open Client 或 jConnect 应用程序中不可用。

它由存有客户端进程信息（如客户端计算机的 IP 地址、运行此客户端进程的操作系统等）的生成的字符串组成。该字符串在数据库服务器中与特定连接相关联，您可以使用以下语句对其进行检索：

SELECT CONNECTION_PROPERTY( 'AppInfo' );

客户端还可指定自己的字符串，该字符串被附加到生成的字符串上。AppInfo 属性字符串是一系列由分号分隔的 key=value 对。有效的键值如下：

API DBLIB、ODBC、OLEDB、ADO.NET、iAnywhereJDBC、PHP、PerlDBD 或 DBEXPRESS。
APPINFO 如果在连接字符串中指定了 AppInfo，则输入该字符串。
EXE 客户端可执行文件的名称（Windows、Linux 和 Solaris）。
HOST 客户端计算机的主机名称。
IP 客户端计算机的 IP 地址。
OS 操作系统名和版本号（例如，Windows 2000）。
OSUSER 与客户端进程相关联的操作系统用户名。如果客户端进程模拟另一个用户（或者设置的 ID 位在 Unix 上设置），则返回被模拟的用户名。对于 10.0.1 版及更早版本的客户端，以及 HTTP 和 TDS 客户端，将返回空字符串。
PID 客户端的进程 ID（仅限 Windows 和 Unix）。
THREAD 客户端的线程 ID（仅限 Windows 和 Unix）。
TIMEZONEADJUSTMENT 必须添加到协调通用时间 (UTC) 中以显示连接本地时间的分钟数。
VERSION 正在使用的客户端库的版本，包括主版本号、子版本号和内部版本号（例如，11.0.0.2023）。

如果您在客户端连接参数中指定调试日志文件，则 APPINFO 字符串会添加到该文件中。

另请参见

示例

从 Interactive SQL 连接到示例数据库（缺省情况下使用 iAnywhere JDBC 驱动程序）：

dbisql -c "UID=DBA;PWD=sql;DBF=samples-dir\demo.db"

查看应用程序信息：

SELECT CONNECTION_PROPERTY( 'AppInfo' );

结果如下所示（在单个字符串中）：

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

从 Interactive SQL 连接到示例数据库，并将自己的信息附加到 AppInfo 属性：

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

查看应用程序信息：

SELECT CONNECTION_PROPERTY( 'AppInfo' );

结果如下所示（在单个字符串中）：

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