Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » SQL Anywhere 服务器 - 数据库管理 » 管理数据库 » 数据库管理实用程序

 

Ping 实用程序 (dbping)

查找数据库服务器,并测试数据库连接。

语法
dbping [ options ]
选项 说明
@data

读取来自指定的环境变量或配置文件的选项。请参见使用配置文件

如果要保护口令或配置文件中的其它信息,可以使用文件隐藏实用程序对配置文件的内容进行模糊处理。请参见文件隐藏实用程序 (dbfhide)

-c "keyword=value; ..."

指定控制 dbping 行为的连接参数。如果未指定连接参数,则使用来自 SQLCONNECT 环境变量的连接参数(如果已设置)。请参见连接参数

如果使用以下命令启动 dbping,且有一个名为 demo11 的数据库服务器已经在运行,则 dbping 会尝试连接到名为 demo 的数据库。如果没有这样的数据库该数据库服务器上运行,则数据库服务器会尝试装载 demo.db。如果找不到名为 demo11 的服务器,dbping 会尝试自动启动一个服务器。

dbping -d -c "UID=DBA;PWD=sql;ENG=demo11;DBN=demo;DBF=samples-dir\demo.db"

有关 samples-dir 的信息,请参见示例目录

-d

强制数据库回应,而不仅仅是强制服务器回应。

如果提供 -d 选项,则 dbping 只有在既连接到服务器又连接到数据库的情况下才会报告成功。如果不提供 -d 选项,则 dbping 会在找到 -c 选项所指定的服务器时就报告成功。

例如,如果您拥有的名为 blair 的数据库服务器正在运行示例数据库,则以下命令将成功:

dbping -c "ENG=blair;DBN=demo"

以下命令将失败,并显示消息 [强制数据库回应失败 -- 未找到指定的数据库]:

dbping -c "ENG=blair;DBN=demo" -d
-en 指定您希望在指定的任一属性返回 NULL 时,dbping 退出并返回失败的返回代码。缺省情况下,如果由 -pc、-pd 或 -ps 指定的属性的值为未知,则 dbping 会输出 NULL 并退出,同时返回成功的返回代码。此选项只能与 -pc、-pd 和 -ps 一起使用。
-l library

指定要使用的库(不带其文件扩展名)。此选项避免了使用 ODBC 驱动程序管理器,因此在 Unix 操作系统上特别有用。

例如,以下命令行直接装载 ODBC 驱动程序:

dbping -m -c "DSN=SQL Anywhere 11 Demo" -l dbodbc11

在 Unix 上,如果您希望使用线程连接库,则必须使用 Ping 实用程序的线程版本:dbping_r。

-m 使用 ODBC 建立一个连接。缺省情况下,实用程序使用嵌入式 SQL 接口进行连接。
-o filename 将输出消息写入指定的文件中。
-pc property,...

显示指定的连接属性。在以逗号分隔的列表中提供这些属性。如果使用此选项,则您必须指定足够的连接信息以建立数据库连接。请参见连接属性

例如,以下命令将显示作为连接属性提供的 fire_triggers 选项设置。

dbping -c ... -pc fire_triggers
-pd property[@db-name],...

显示指定的数据库属性。在以逗号分隔的列表中提供这些属性。请参见数据库属性

例如,以下命令显示数据库正在使用的页面大小:

dbping -c ... -pd PageSize

另外,也可以指定正在数据库服务器上运行并想要从中获取值的数据库的名称。对于列出的每个属性,如果未通过将 @db-name 附加到属性来指定数据库名称,则将使用前一个属性所使用的数据库名称。

以下命令显示数据库 mydb 的页面大小和归类:

dbping -c ... -pd PageSize@mydb,Collation
-ps property,...

显示指定的数据库服务器属性。在以逗号分隔的列表中提供这些属性。如果使用此选项,则您必须指定足够的连接信息以建立数据库连接。请参见数据库服务器属性

例如,以下命令显示数据库服务器的许可存取设备数或处理器数:

dbping -c ... -ps LicenseCount
-q 以安静模式运行—不显示消息。
-s 返回有关运行 dbping 的计算机与运行数据库服务器的计算机之间的网络性能的信息。将显示大致的连接速度、等待时间和吞吐量。要指定连接到某服务器上的数据库的连接参数,通常需要 -c 选项。对于嵌入式 SQL 连接,只能使用 dbping -s。如果另外指定了 -m 或 -l,则将忽略此选项。缺省情况下,对于需要测定的每项统计信息,dbping -s 都会循环执行请求,时间至少为一秒钟。但是,最多只能重复执行 200 次的连接和断开操作而不管花费的时间有多少,这样能够避免占用过多的资源。在速度较慢的网络上,即使是达到针对每项统计信息的最少重复执行次数可能也得需要几秒钟的时间。性能统计信息是近似的结果,当客户端和服务器计算机均完全闲置时,得到的统计结果会更精确。请参见测试嵌入式 SQL 连接的性能
-st time 此选项与 -s 相同,但它能指定时间长度(以秒为单位),对于需要测定的每项统计信息,dbping 会在该段时间内循环执行请求。与 -s 相比,此选项能够获得更精确的计时信息。请参见测试嵌入式 SQL 连接的性能
-z 显示用于尝试连接的网络通信协议和其它诊断消息。只有在尝试进行嵌入式 SQL 连接时,才能使用此选项。即无法与 -m 或 -l 组合使用。
注释

dbping 实用程序是帮助解决连接问题的工具。它接受完整或部分连接字符串,然后返回消息,以指出定位服务器或数据库或者建立连接的尝试是否成功。

该实用程序可用于嵌入式 SQL 连接或 ODBC 连接。它不能用于 jConnect (TDS) 连接。

退出代码是零(成功)或非零(失败)。请参见软件组件的退出代码