测试与数据库服务器和数据库(可选)的连接。
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 建立一个连接。缺省情况下,实用程序使用嵌入式 SQL 接口进行连接。 | ||||
-o filename | 将输出消息写入指定的文件中。 | ||||
-pc property,... |
显示指定的连接属性。在以逗号分隔的列表中提供这些属性。如果使用此选项,则您必须指定足够的连接信息以建立数据库连接。请参见连接属性列表。 例如,以下命令将显示作为连接属性提供的 fire_triggers 选项设置。
|
||||
-pd property[@db-name],... |
显示指定的数据库属性。在以逗号分隔的列表中提供这些属性。请参见数据库属性列表。 例如,以下命令显示数据库正在使用的页面大小:
另外,也可以指定正在数据库服务器上运行并想要从中获取值的数据库的名称。对于列出的每个属性,如果未通过将 @db-name 附加到属性来指定数据库名称,则将使用前一个属性所使用的数据库名称。 以下命令显示数据库 mydb 的页面大小和归类:
|
||||
-ps property,... |
显示指定的数据库服务器属性。在以逗号分隔的列表中提供这些属性。如果使用此选项,则您必须指定足够的连接信息以建立数据库连接。请参见数据库服务器属性列表。 例如,以下命令显示数据库服务器的许可存取设备数或处理器数:
|
||||
-q | 以安静模式运行—不显示消息。 | ||||
-s | 返回有关运行 dbping 的计算机与运行数据库服务器的计算机之间的网络性能的信息。将显示大致的连接速度、等待时间和吞吐量。要指定连接到某服务器上的数据库的连接参数,通常需要 -c 选项。对于嵌入式 SQL 连接,只能使用 dbping -s。如果另外指定了 -m 或 -l,则将忽略此选项。缺省情况下,对于需要测定的每项统计信息,dbping -s 都会循环执行请求,时间至少为一秒钟。但是,最多只能重复执行 200 次的连接和断开操作而不管花费的时间有多少,这样能够避免占用过多的资源。在速度较慢的网络上,即使是达到针对每项统计信息的最少重复执行次数可能也得需要几秒钟的时间。性能统计信息是近似的结果,当客户端和服务器计算机均完全闲置时,得到的统计结果会更精确。请参见疑难解答:如何测试嵌入式 SQL 和网络连接的性能 (dbping)。 | ||||
-st time | 返回的信息与 -s 选项相同,但 -st 选项能指定时间长度(以秒为单位),对于需要测定的每项统计信息,dbping 会在该段时间内循环执行请求。与 -s 相比,此选项能够获得更精确的计时信息。请参见疑难解答:如何测试嵌入式 SQL 和网络连接的性能 (dbping)。 | ||||
-z | 显示用于尝试连接的网络通信协议和其它诊断消息。只有在尝试进行嵌入式 SQL 连接时,才能使用此选项。即无法与 -m 或 -l 组合使用。 |
无。
dbping 实用程序是帮助解决连接问题的工具。它接受完整或部分连接字符串,然后返回消息,以指出定位服务器或连接至数据库的尝试是否成功。
该实用程序可用于嵌入式 SQL 连接或 ODBC 连接。它不能用于 jConnect (TDS) 连接。
退出代码是零(成功)或非零(失败)。
![]() |
使用DocCommentXchange讨论此页。
|
版权 © 2013, SAP 股份公司或其关联公司. - SAP Sybase SQL Anywhere 16.0 |