更新日期：2024年09月11日
使用 DBPATH 环境变量可以标识包含数据库的数据库服务器。DBPATH 还可指定 DB-
Access 在其中查找命令脚本（.sql 文件）的目录（除当前目录之外）的列表。
CONNECT DATABASE、START DATABASE 和 DROP DATABASE 语句使用 DBPATH 在以下两
种情况下查找该数据库：
如果数据库的位置未显式声明
如果不能在缺省服务器中定位该数据库
CREATE DATABASE 语句不使用 DBPATH。
要向现有条目添加新 DBPATH 条目，请参阅修改环境变量设置。
GBase 8s SQL 指南：参考
南大通用数据技术股份有限公司 - 159 -
full_pathname 是从根目录开始的，存储 .sql 文件的目录的全路径。
pathname 是存储 .sql 文件的目录的有效相对路径。
servername
是存储数据库的 GBase 8s 服务器的名称。不能使用 servername 引用数据库文件。
DBPATH 可包含最多 16 个条目。每个条目必须少于 128 个字符。此外，
DBPATH 的最大长度取决于在其上设置 DBPATH 的硬件平台。
在使用 CONNECT DATABASE、START DATABASE 或 DROP DATABASE 语句
访问数据库时，首先在该语句中指定的目录或数据库服务器中搜索该数据库。如果未指定
任何数据库服务器，那么使用 GBASEDBTSERVER 环境变量指定的缺省数据库服务
器。
如果在初次搜索期间找不到该数据库，同时又设置了 DBPATH，那么会在指定数据
库中搜索 DBPATH 中的数据库服务器和目录。这些条目是按它们列示在 DBPATH 设
置中的顺序搜索的。
将 DBPATH 与 DB-Access 配合使用
如果在尚未选择数据库的情况下使用 DB-Access 并从 SQL 菜单选择中选择选项，
就会看到 DBPATH 中列出的目录中所有 .sql 文件的列表。选择了数据库之后，就不会
使用 DBPATH 来查找 .sql 文件。仅显示当前工作目录中的 .sql 文件。
搜索本地目录
使用不带数据库服务器名的路径名搜索本地计算机上的 .sql 脚本。在以下示例中，
DBPATH 设置让 DB-Access 先在当前目录中搜索这些数据库文件，然后在本地计算机上的
Joachim 和 Sonja 目录中搜索它们：
setenv DBPATH /usr/joachim:/usr/sonja
如先前示例所示，如果该路径名指定目录名但未指定数据库服务器名，那么在运行
GBASEDBTSERVER 指定的缺省数据库服务器的计算机上搜索该目录；请参阅
GBASEDBTSERVER 环境变量。例如，如以下示例所示，对于先前示例，如果将
GBASEDBTSERVER 设置为 quality，DBPATH 值已作了解释，其中双斜杠放在数据库服务器
名称之前：
setenv DBPATH //quality/usr/joachim://quality/usr/sonja
搜索联网计算机以查找数据库
GBase 8s SQL 指南：参考
南大通用数据技术股份有限公司 - 160 -
如果使用多个数据库服务器，可将 DBPATH 显式设置为包含想要对其搜索数据库的数
据库服务器和目录名。例如，如果将 GBASEDBTSERVER 设置为 quality，但您还想搜索
marketing 数据库服务器以查找 /usr/joachim，那么按以下示例所示设置 DBPATH：
setenv DBPATH //marketing/usr/joachim:/usr/sonja
指定服务器名
可将 DBPATH 设置为仅包含数据库服务器名。此功能允许您仅定位数据库；不能使
用它来定位命令文件。
数据库管理员必须将 DBPATH 提及的每个数据库服务器包括在
$GBASEDBTDIR/etc/sqlhosts 文件中。有关通信配置文件和数据库服务器名称的信息，
请参阅《GBase 8s 管理员指南》和 GBase 8s 管理员参考。
例如：如果将 GBASEDBTSERVER 设置为 quality，那么可以通过设置 DBPATH 来先在
quality 数据库服务器上搜索数据库，然后在 marketing 数据库服务器上搜索数据库，
如以下示例所示：
setenv DBPATH //marketing
如果在此示例中使用 DB-Access，那么使用 DATABASE 菜单的选择选项来显示
quality 和 marketing 数据库服务器上所有数据库的名称。