停止服务器实用程序 (dbstop)

停止数据库或数据库服务器。

语法

dbstop [ options ] [ server-name ]

选项	说明
@data	从指定的环境变量或配置文件中读入选项。请参见使用配置文件。如果要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序对配置文件的内容进行模糊处理。请参见文件隐藏实用程序 (dbfhide)。
-c "keyword=value; ..."	指定连接字符串。要停止网络服务器，连接字符串必须包含拥有服务器停止权限的用户 ID。缺省情况下，在网络服务器上需要有 DBA 权限，所有用户都可以关闭个人服务器，但可以使用 -gk 服务器选项对此进行更改。如果提供连接参数，则不要再提供服务器名。请参见连接参数、Unconditional 连接参数 [UNC]和-gk 服务器选项。
-d	不停止数据库服务器，而是只停止在连接字符串中指定的数据库。
-o filename	将输出消息写入指定的文件中。
-q	以安静模式运行—不显示消息。
-x	如果仍有到服务器的活动连接，则不停止服务器。指定此选项可以阻止 dbstop 在存在活动连接时提示用户进行确认。
-y	停止服务器，即使仍有到服务器的活动连接。这与在连接参数中包含 Unconditional=YES 具有相同的效果。
server-name	指定当前计算机所运行数据库服务器的名称。必须这样启动数据库服务器：在关闭它时不需要权限。缺省情况下，个人数据库服务器以此模式启动。对于网络数据库服务器，您必须提供 -gk all 选项。请参见-gk 服务器选项。如果提供服务器名，则不要再提供连接参数。

注释

停止服务器实用程序用于使数据库服务器停止运行。可以使用 -d 选项停止指定的数据库。

停止服务器实用程序只能在命令提示符环境中运行。在窗口式环境中，您可以通过单击数据库服务器消息窗口中的 [关闭] 来停止数据库服务器。

选项可让您控制是否停止服务器（即使有活动连接）；以及控制是停止服务器还是只停止数据库。

在服务器上有活动连接的情况下，dbstop 的行为是可以控制的。如果具有活动连接，则 dbstop 会给出一个提示，询问您是否希望关闭服务器。可以使用 -x 和 -y 选项来更改这一行为。

如果 dbstop 能够停止数据库服务器，则只有在所有数据库停止运行并且数据库服务器也停止后，dbstop 才会结束。（数据库服务器完全停止后，另一个服务器才能以相同的名称和数据库启动。）dbstop 成功完成后，数据库服务器进程可能仍在运行，其某些资源（例如由 -o 服务器选项指定的输出文件）可能仍在使用。

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

如果在定义了 SQLCONNECT 环境变量的环境中使用 dbstop，应指定 -c 选项。否则，可能会出现意外的结果。

示例

正在运行名为 myserver 的服务器，该服务器没有启动数据库。若要停止该服务器，请指定实用程序数据库作为 DatabaseName (DBN) 连接参数：

dbstop -c "UID=DBA;PWD=sql;ENG=myserver;DBN=utility_db"

正在运行名为 myserver 的服务器，并且已启动了 demo.db 数据库。要停止该服务器和数据库：

dbstop -c "UID=DBA;PWD=sql;ENG=myserver"

正在运行名为 myserver 的个人服务器。要停止该服务器和数据库而不管是否存在连接：

dbstop -y myserver

正在运行名为 myserver 的服务器，并且已启动了 demo.db 数据库。要仅停止名为 demo 的数据库，但不停止其它数据库或服务器自身，请执行以下命令：

dbstop -c "UID=DBA;PWD=sql;ENG=myserver;DBN=demo" -d