数据源实用程序 (dbdsn)

dbdsn [ modifier-options ]
   { -l[ s | u ]
   | -d[ s | u ] dsn
   | -g[ s | u ] dsn
   | -w[ s | u ] dsn [details-options;...]
   | -cl }

主选项	说明
@data	读取来自指定的环境变量或配置文件的选项。要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序对配置文件的内容进行模糊处理。
-l[ s \| u ]	列出可用的 ODBC 数据源。您可以使用 -b 或 -v 选项修改列表格式。在 Windows 中，可以使用 u（用户）或 s（系统）指定符来修改该选项。缺省指定符是 u。
-d[ s \| u ] dsn	删除指定的数据源。如果提供 -y，则删除任何现有数据源而无需确认。在 Windows 中，可以使用 u（用户）或 s（系统）指定符来修改该选项。缺省指定符是 u。
-g[ s \| u ] dsn	列出指定数据源的定义。您可以使用 -b 或 -v 选项修改输出的格式。在 Windows 中，可以使用 u（用户）或 s（系统）指定符来修改该选项。缺省指定符是 u。
-w[ s \| u ] dsn [ details-options ]	创建新数据源；如果存在同名的数据源，则覆盖它。必须与 -w 选项一并指定 -c 选项。如果提供 -y，则覆盖任何现有数据源而无需确认。在 Windows 中，可以使用 u（用户）或 s（系统）指定符来修改该选项。缺省指定符是 u。
-cl	列出 dbdsn 实用程序支持的连接参数。

修饰符选项说明

-b 将列表的输出格式设置为单行连接字符串。

-cm

显示用来创建数据源的命令。此选项可用于将创建命令输出到一个文件中。可使用该创建命令将数据源添加到其它计算机，或者如果数据源有更改，也可用该命令将数据源恢复到其原始状态。您必须使用 -cm 指定 -g 选项或 -l 选项，否则命令将失败。指定 -g 会显示指定数据源的创建命令，而指定 -l 则会显示所有数据源的创建命令。

如果指定的数据源不存在，则会生成删除数据源的命令。例如，如果计算机上不存在 mydsn 数据源，则 dbdsn -cm -g mydsn 会返回下列命令来删除 mydsn 数据源：

dbdsn -y -du "mydsn"

-dr

显示数据源时包括 Driver 参数。在使用 -cm 选项重新创建数据源时，它允许当前版本的 dbdsn 创建那些引用另一个版本的 ODBC 驱动程序的数据源。

例如，运行以下命令可以创建版本 11 的数据源：

dbdsn -y -wu "11.0 Student Sample" -c "UID=DBA;PWD=sql;...;Driver=
SQL Anywhere 11"

运行 dbdsn -cm -l 时，dbdsn 列出不包括 Driver= 参数的相同命令，随后可使用 SQL Anywhere 版本 16 ODBC 驱动程序来重新创建 ODBC 数据源。

但如果运行 dbdsn -dr -cm -l，Driver= 参数会包括在内，数据源会完全按照最初的创建方式重新创建：即使用版本 11 ODBC 驱动程序。

-f 显示所使用的系统文件的名称。此选项只能在 Unix 中使用。

-ns

指定用于确定系统信息文件（缺省情况下名为 .odbc.ini）位置的环境变量设置。如果在环境中存在多个候选系统信息文件，则此选项对于确定 dbdsn 正在使用哪个文件非常有用。此选项只能在 Unix 中使用。

如果在创建数据源时不指定 -ns，dbdsn 也会在用户主目录和路径中检查系统信息文件。

-o filename 将输出消息写入指定的文件中。

-or

使用 -c 选项指定时，可创建 SQL Anywhere 16 - Oracle 驱动程序的数据源。例如：

dbdsn -w MyOracleDSN -or -c Userid=DBA;Password=sql;
ServiceName=abcd;ArraySize=500;ProcResults=y

您可以指定 -cl 选项和 -or 选项，以获取 SQL Anywhere 16 - Oracle 驱动程序的连接参数列表。

-pe 对 Password 连接参数中指定的口令进行加密，并使用 ENP 连接参数将加密的口令存储在数据源中。

-q 取消向数据库服务器消息窗口的输出。如果您在删除或修改数据源时指定 -q，则还必须指定 -y。

-v 将列表的输出格式设置为数行（即表格形式）。

-y 删除或覆盖每个数据源，而不提示您进行确认。如果您在删除或修改数据源时指定 -q，则还必须指定 -y。

细节选项	说明
-c "keyword=value;..."	将连接参数指定为连接字符串。
-cw	确保 DBF 参数（使用 -c 指定）是一个绝对文件名。如果 DBF 的值不是绝对文件名，dbdsn 会在其前面添加当前工作目录 (CWD)。此选项十分有用，因为有些操作系统不会在批处理文件中自动提供 CWD 信息。

无。

修饰符选项可以出现在主选项设定之前或之后。

数据源实用程序是 ODBC 数据源管理器的跨平台替代工具，用于创建、删除、说明和列出 ODBC 数据源。此实用程序对于批处理操作是很有用的。

小心

在数据源中存储用户 ID、口令（加密或未加密）和/或数据库密钥是不安全的。如果数据库包含敏感数据，建议您不要将此信息存储在数据源中。

在 Windows 操作系统中，数据源保存在注册表中。

有关使用 ODBC 数据源管理器在 Windows 上创建数据源的信息，请参见ODBC 数据源。

在 Unix 操作系统中，数据源保存在系统信息文件中（缺省名为 .odbc.ini）。在 Unix 中使用数据源实用程序来创建或删除 ODBC 数据源时，该实用程序会自动更新系统信息文件的 [ODBC Data Sources] 段。如果在 Unix 中没有使用 -c 选项指定 Driver 连接参数，数据源实用程序会根据 SQLANY16 环境变量的设置自动添加一个带有 SQL Anywhere ODBC 驱动程序完整路径的 Driver 项。

小心

在 Unix 中不要使用文件隐藏实用程序 (dbfhide) 对系统信息文件 (.odbc.ini) 进行模糊处理，除非您将仅使用 SQL Anywhere 数据源。如果计划使用其它数据源（例如，为了 MobiLink 同步），则系统信息文件的模糊处理可能会妨碍其它驱动程序正常工作。

退出代码是零（成功）或非零（失败）。

写入数据源 newdsn 的定义。如果数据源已存在，不提示进行确认。

dbdsn -y -w newdsn -c "UID=DBA;PWD=sql;Host=myhost"

或者，使用不同的选项顺序：

dbdsn -w newdsn -c "UID=DBA;PWD=sql;Host=myhost" -y

列出所有已知用户数据源，每行对应一个数据源名称：

dbdsn -l

列出所有已知系统数据源，每行对应一个数据源名称：

dbdsn -ls

列出所有数据源及其相关连接字符串：

dbdsn -l -b

报告用户数据源 MyDSN 的连接字符串：

dbdsn -g MyDSN

报告系统数据源 MyDSN 的连接字符串：

dbdsn -gs MyDSN

删除数据源 BadDSN，但首先列出 BadDSN 的连接参数，并提示进行确认：

dbdsn -d BadDSN -v

删除数据源 BadDSN，但不提示进行确认。

dbdsn -d BadDSN -y

为数据库服务器 MyServer 创建名为 NewDSN 的数据源：

dbdsn -w NewDSN -c "UID=DBA;PWD=sql;Server=MyServer"

如果 NewDSN 已经存在，会提示就是否覆盖该数据源进行确认。

列出所有连接参数名及其别名：

dbdsn -cl

列出所有用户数据源：

dbdsn -l -o dsninfo.txt

列出所有连接参数名：

dbdsn -cl -o dsninfo.txt

指定一个绝对文件名。ODBC 数据源创建时，它包含 DBF=c:\SQLAnywhere16\my.db。

c:\SQLAnywhere16> dbdsn -w testdsn -cw -c UID=DBA;PWD=sql;Server=SQLAny;DBF=my.db

运行以下命令创建 SQL Anywhere 16 Demo 数据源，并将其输出到名为 restoredsn.bat 的文件中：

dbdsn -cm -gs "SQL Anywhere 16 Demo" > restoredsn.bat

restoredsn.bat 文件包含以下内容：

dbdsn -y -ws "SQL Anywhere 16 Demo" -c "UID=DBA;PWD=sql;
DBF='C:\Documents and Settings\All Users\Documents\SQL Anywhere 16\Samples\demo.db';
Server=demo16;START='C:\Program Files\SQL Anywhere 16\Bin32\dbeng16.exe';
ASTOP=yes;Description='SQL Anywhere 16 Sample Database'"

运行以下命令返回 Unix 中系统信息文件的位置：

dbdsn -f

此命令会返回以下输出：

dbdsn using /home/user/.odbc.ini

更改系统信息文件的位置：

export ODBCINI=./myodbc.ini

使用 dbdsn -f 验证系统信息文件的新位置：

dbdsn using ./myodbc.ini

创建数据源时使用 -ns 选项：

dbdsn -w NewDSN -c "UID=DBA" -ns

这将产生以下输出：

Configuration "newdsn" written to file ./myodbc.ini

数据源实用程序 (dbdsn)

语法

特权

注释

小心

小心

另请参见

示例