本节列出了本文档中使用的约定。
SQL Anywhere 可以在各种平台上运行。通常情况下,在所有平台上该软件的行为都是相同的,但也有变动或限制。这些变动或限制通常基于基础操作系统(Windows、Unix),很少基于特定变型(IBM AIX、Windows Mobile)或版本。
为了简化对操作系统的提及,本文档按如下方式对支持的操作系统进行分组:
Windows Microsoft Windows 系列包括主要用于服务器、台式计算机和膝上型计算机的平台,以及用于移动设备的平台。除非另外指定,否则当本文档提及 Windows 时,是指所有基于 Windows 的受支持平台,包括 Windows Mobile。
Windows Mobile 基于 Windows CE 操作系统,该操作系统还用于构建 Windows Mobile 以外的各种平台。除非另外指定,否则当本文档提及 Windows Mobile 时,是指所有使用 Windows CE 构建的受支持平台。
Unix 除非另外指定,否则当本文档提及 Unix 时,是指所有基于 Unix 的受支持平台,包括 Linux 和 Mac OS X。
有关 SQL Anywhere 支持的平台的完整列表,请参见支持的平台。
通常情况下,对目录和文件名的引用在所有支持的平台上都是类似的,只需在不同形式之间进行简单的转换。这时需使用 Windows 约定。在细节更为复杂的情况下,文档显示所有相关形式。
下面是文档编写中用于简化目录和文件名的约定:
大写和小写目录名 在 Windows 和 Unix 上,目录和文件名可以包括大写和小写字母。创建目录和文件时,文件系统会保留字母大小写。
在 Windows 上,对目录和文件的提及不区分大小写。混合使用大小写的目录和文件名很常见,但使用所有小写字母来提及目录和文件的形式也很常见。SQL Anywhere 安装包含诸如 Bin32 和 Documentation 的目录。
在 Unix 上,对目录和文件的提及区分大小写。混合使用大小写的目录和文件名不常见。大多数的目录和文件名全部使用小写字母。SQL Anywhere 安装包含诸如 bin32 和 documentation 的目录。
本文档采用 Windows 形式的目录名。通常情况下,在 Unix 上可以将大小写混合形式的目录名转换成小写字母的等效目录名。
分隔目录和文件名的斜线 文档使用反斜线作为目录分隔符。例如,PDF 格式的文档位于 install-dir\Documentation\zh\PDF(Windows 形式)。
在 Unix 上,用正斜线替换反斜线。PDF 文档位于 install-dir/documentation/zh/pdf 下。
可执行文件 文档使用 Windows 约定显示可执行文件名(带有诸如 .exe 或 .bat 后缀)。在 Unix 上,可执行文件名没有后缀。
例如,在 Windows 上,网络数据库服务器是 dbsrv12.exe。在 Unix 上是 dbsrv12。
install-dir 在安装过程中,选择 SQL Anywhere 的安装位置。创建环境变量 SQLANY12,用来表示此位置。文档中以 install-dir 表示此位置。
例如,本文档将此文件表示为 install-dir/readme.txt。在 Windows 上,这等同于 %SQLANY12%\readme.txt。在 Unix 上,这等同于 $SQLANY12/readme.txt 或 ${SQLANY12}/readme.txt。
有关 install-dir 缺省位置的详细信息,请参见SQLANY 12 环境变量。
samples-dir 在安装过程中,选择 SQL Anywhere 随附的示例的安装位置。创建环境变量 SQLANYSAMP12,用来表示此位置。文档中以 samples-dir 表示此位置。
要打开 samples-dir 的 Windows 资源管理器窗口,请选择 [开始] » [程序] » [SQL Anywhere 12] » [示例应用程序和项目]。
有关 samples-dir 缺省位置的详细信息,请参见SQLANYSAMP 12 环境变量。
大多数操作系统都提供一种或多种使用命令 shell 或命令提示符来输入命令和参数的方法。Windows 命令提示符包括 Command Prompt(DOS 提示符)和 4NT。Unix 命令 shell 包括 Korn shell 和 bash。每个 shell 都具有一些功能,其能力不仅仅局限于简单命令。这些功能通过特殊字符来驱动。特殊字符和功能随 shell 的不同而不同。如果没有正确使用这些特殊字符,通常会导致语法错误或意外行为。
本文档以普通形式提供命令行示例。如果这些示例中包含 shell 的特殊字符,则命令需要根据特定 shell 进行修改。修改方法不在本文档所述范围之内,但通常是在包含这些特殊字符的参数两旁加上引号,或是在特殊字符前面使用转义字符。
下面是命令行语法的一些示例,不同的平台可能会有不同的形式:
括号和大括号 有些命令行选项需要一个参数,该参数将以列表形式接受详细的值指定。该列表通常用括号或大括号括起来。本文档使用括号。例如:
-x tcpip(host=127.0.0.1) |
如果括号导致出现语法问题,用大括号替代:
-x tcpip{host=127.0.0.1} |
如果两种形式都将产生语法问题,应按照 shell 的要求,用引号将整个参数括起来:
-x "tcpip(host=127.0.0.1)" |
分号 在 Unix 上,分号应使用引号括起来。
引号 如果必须在参数值中指定引号,该引号可能会与用于括参数的引号的传统用法发生冲突。例如,要指定值中包含双引号的加密密钥,则可能必须用引号括起密钥,然后转义嵌入的引号:
-ek "my \"secret\" key" |
在大多数 shell 中,本例的意思是:密钥的值为 my "secret" key
。
环境变量 本文档介绍设置环境变量。在 Windows shell 中,环境变量使用语法 %ENVVAR% 来指定。在 Unix shell 中,环境变量使用语法 $ENVVAR 或 ${ENVVAR} 来指定。
![]() |
使用电子邮件发送此页的反馈。 | 版权 © 2010, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.0 |