read

说明

从文件中读取 Interactive SQL 语句。

语法

read [ encoding encoding ] file_name [ parameters ]encoding : identifier or string

参数

encoding – 允许指定用于写入文件的编码。encoding 只能用于 ASCII 格式。
file_name – 要读取的文件的名称。
parameters – 对应于语句文件中列出的参数。
identifier – 用于指示要读取的文件的标识符。
string – 用于指示要读取的文件的字符串。

示例

下面是 read 语句示例。

READ status.rpt ‘160’
READ birthday.SQL [>= ’1988-1-1’] [<= ’1988-1-30’]

用法

read 语句从指定的文件中读取一系列 Interactive SQL 语句。此文件可包含任何有效的 Interactive SQL 语句，包括其它 read 语句。read 语句可以嵌套任意多层。如果文件名不包含绝对路径，则 Interactive SQL 会搜索该文件。Interactive SQL 首先会搜索当前目录，接着搜索在环境变量 SQLPATH 中指定的目录，然后搜索在环境变量 PATH 中指定的目录。如果指定文件没有文件扩展名，则 Interactive SQL 将搜索每个目录查找具有扩展名 .SQL 的相同文件名。
encoding 参数允许指定用于读取文件的编码。read 语句在读取文件时不处理转义字符。它假定整个文件都采用指定的编码。如果未指定 encoding，Interactive SQL 将按如下方式确定用于读取文件的代码页，列表中位置靠前的代码页值优先于位置靠后的值：
- 使用 default_isql_encoding 选项指定的代码页（如果设置此选项）
- 启动 Interactive SQL 时使用 -codepage 选项指定的代码页
- 运行 Interactive SQL 的计算机的缺省代码页
可以在命令文件的名称后面列出参数。这些参数对应于在语句文件开头的 parameters 语句中指定的参数。Interactive SQL 在源文件中包含 {parameter_name} 的所有位置改用对应的参数，其中 parameter_name 为相应参数的名称。
传递给命令文件的参数可以是标识符、数字、带引号的标识符或字符串。使用引号将参数引起来时，在替换时引号也放置到文本中。不是标识符、数字或字符串（包含空格或制表符）的参数必须用方括号 ([ ]) 括起来。这样，便可在命令文件中执行任意文本替换。
如果传递给命令文件的参数不够，Interactive SQL 将提示输入缺失参数的值。

权限

任何用户都可以运行此命令。

副作用

无。