[整理]：oracle spool 用法

本文来自iDB Stock:http://www.idb-stock.net/idb/2011/06/01/153.html

1.spool的作用是什么？

spool的作用可以用一句话来描述：在sqlplus中用来保存或打印查询结果。

2.spool在oracle 9i、10g和11g下的语法及使用示例

oracle 9i spool语法 SPO[OL] [file_name[.ext]|OFF|OUT]

oracle 10g、11g spool语法

SPO[OL] [file_name[.ext] [CRE[ATE] | REP[LACE] | APP[END]] | OFF | OUT]

oracle 9i spool的主法比较简单，其实就相当于oracle 10g中spool的replace选项，因此本文主要介绍oracle 10g的选项。

file_name[.txt]

保存查询结果集的的路径和文件名，如果没有指定后缀名，默认名一般为.lst或.lis。如果指定系统文件为/dev/null and /dev/stderr，则不会添加后缀名。

off 完成spool。

out 停止spool,并将文件输出到终端设备上，如打印机(可能有些操作系统不支持)。

我们从语法上可以看到，oracle在10g、11g中对spool增加了create、replace、append选项，

create     创建指定文件名的新文件；如指定文件存在，则报文件存在错误。

replace     如果指定文件存在则覆盖替换；如指定文件不存在，则创建，replace为spool默认选项。

append     向指定文件名中追加内容；如指定文件不存在,则创建。

spool常用的设置
set colsep' ';　　　 //域输出分隔符
set echo off;　　　　//显示start启动的脚本中的每个sql命令，缺省为on
set feedback off;　　//回显本次sql命令处理的记录条数，缺省为on
set heading off;　　 //输出域标题，缺省为on
set pagesize 0;　　　//输出每页行数，缺省为24,为了避免分页，可设定为0。
set termout off;　　 //显示脚本中的命令的执行结果，缺省为on
set trimout on;　　　//去除标准输出每行的拖尾空格，缺省为off
set trimspool on;　　//去除重定向（spool）输出每行的拖尾空格，缺省为off

set newp none  //设置查询出来的数据分多少页显示，如果需要连续的数据，中间不要出现空行就把newp设置为none，这样输出的数据行都是连续的，中间没有空行之类的

方法一：采用以下格式脚本　
        set colsep '|'               --设置|为列分隔符
　　set trimspool on
　　set linesize 120
　　set pagesize 2000         
　　set newpage 1
　　set heading off           
　　set term off 
      set num 18                  
      set feedback off           
　　spool 路径+文件名
　　select * from tablename;
　　spool off

方法二：采用以下脚本 
      set trimspool on
　　set linesize 120
　　set pagesize 2000
　　set newpage 1
　　set heading off
　　set term off
　　spool 路径+文件名
　　select col1||','||col2||','||col3||','||col4||'..' from tablename;
　　spool off

使用set命令的语法如下: SET 系统变量  值
其中系统变量及其可选值如下:
  ARRAY[SIZE]          {20(默认值)|n}
  AUTO[COMMIT]         {OFF(默认值)|ON|IMM[EDIATE]}
  BLO[CKTERMINATOR]    {.(默认值)|C}
  CMDS[EP]             {;|C|OFF(默认值)|ON}
  COM[PATIBILITY]      {V5|V6|V7|NATIVE(默认值)}
  CON[CAT]             {.(默认值)|C|OFF|ON(默认值)}
  COPYC[OMMIT]         {0(默认值)|n}
  CRT crt             
  DEF[INE]             {&|C|OFF|ON(默认值)}
  ECHO                 {OFF|ON}
  EMBEDDED             {OFF(默认值)|ON}
  ESC[APE]             {/(默认值)|C|OFF(默认值)|ON}
  FEED[BACK]           {6(默认值)|n|OFF|ON}
  FLU[SH]              {OFF|ON(默认值)}
  HEA[DING]            {OFF|ON(默认值)}
  HEADS[EP]            {|(默认值)|C|OFF|ON(默认值)}
  LIN[ESIZE]           {80(默认值)|n}
  LONG                 {80(默认值)|n}
  LONGC[HUNKSIZE]      {80(默认值)|n}
  MAXD[ATA]            n
  NEWP[AGE]            {1(默认值)|n}
  NULL text
  NUMF[ORMAT]          格式
  NUM[WIDTH]           {10(默认值)|n}
  PAGES[IZE]           {14(默认值)|n}
  PAU[SE]              {OFF(默认值)|ON|text}
  RECSEP               {WR[APPED](默认值)|EA[CH]|OFF}
  RECSEPCHAR           { |C}
  SCAN                 {OFF|ON(默认值)}
  SERVEROUT[PUT]       {OFF|ON} [SIZE n]
  SHOW[MODE]           {OFF(默认值)|ON}
  SPA[CE]              {1(默认值)|n}
  SQLC[ASE]            {MIX[ED](默认值)|LO[WER]|UP[PER]}
  SQLCO[NTINUE]        {>;(默认值)|文本}
  SQLN[UMBER]          {OFF|ON(默认值)}
  SQLPER[FIX]          {#(默认值)|C}
  SQLP[ROMPT]          {SQL>;(默认值)|文本}
  SQLT[ERMINATOR]      {;(默认值)|C|OFF|ON(默认值)}
  SUF[FIX]             {SQL(默认值)|文本}
  TAB                  {OFF|ON(默认值)}
  TERM[OUT]            {OFF|ON(默认值)}
  TI[ME]               {OFF(默认值)|ON}
  TIMI[NG]             {OFF(默认值)|ON}
  TRIM[OUT]            {OFF|ON(默认值)}
  UND[ERLINE]          {-(默认值)|C|OFF|ON(默认值)}
  VER[IFY]             {OFF|ON(默认值)}
  WRA[P]               {OFF|ON(默认值)}

系统变量说明:
  ARRAY[SIZE] {20(默认值)|n} 置一批的行数,是SQL*PLUS一次从数据库获取的行数,有效值为1至5000. 大的值可提高查询和子查询的有效性,可获取许多行,但也需要更多的内存.当超过1000时,其效果不大.

AUTO[COMMIT] {OFF(默认值)|ON|IMM[EDIATE]} 控制ORACLE对数据库的修改的提交. 置ON时,在ORACLE执行每个SQL命令或PL/SQL块后对数据库提交修改;置OFF时则制止自动提交,需要手工地提交修改,例如用SQL的 COMMIT命令. IMMEDIATE功能同ON.

BLO[CKTERMINATOR] {.(默认值)|C} 置非字母数字字符,用于结束PL/SQL块.要执行块时,必须发出RUN命令或/命令.

CMDS[EP] {;|C|OFF(默认值)|ON} 置非字母数字字符,用于分隔在一行中输入的多个SQL/PLUS命令.ON或OFF控制在一行中是否能输入多个命令. ON时将自动地将命令分隔符设为分号(;).其中C表示所置字符.

COM[PATIBILITY] {V5|V6|V7|NATIVE(默认值)} 指定当前所链接的ORACLE版本.如果当前ORACLE的版本为5,则置COMPATIBILITY为V5; 为版本6时置成V6; 为版本7时置成V7. 如果希望由数据库决定该设置,在置成NATIVE.

CON[CAT] {.(默认值)|C|OFF|ON(默认值)}设置结束一替换变量引用的字符.在中止替换变量引用字符之后可跟所有字符,作为体会组成部分,否则 SQL*PLUS将解释为替换变量名的一部分.当CONCAT开关为ON时,SQL*PLUS可重置CONCAT的值为点(.).

COPYC[OMMIT] {0(默认值)|n} 控制COPY命令提交对数据库修改的批数.每次拷贝n批后,将提交到目标数据库.有效值为0到5000. 可用变量ARRAYSIZE设置一批的大小.如果置COPYCOMMIT为0,则仅在COPY操作结束时执行一次提交.

CRT crt  改变SQL*PLUS RUNFORM命令使用的缺省CRT文件.如果置CRT不包含什么,则crt仅包含''''.如果在一个Form的系统调用期间,要使用NEW.CRT(缺省CRT是OLD.CRT),可按下列形式调用Form:
    SQL>;RUNFORM -C NEW form名
    或者
    SQL>;SET CRT NEW
    SQL>;RUNFORM form名
第二中方法存储CRT选择,以致在下次运行RUNFORM命令(是在同一次SQL*PLUS交互中)时,不需要指定.

DEF[INE] {&|C|OFF|ON(默认值)} 设置在替换变量时所使用的字符.ON或OFF控制SQL*PLUS是否扫描替换变量的命令及用他们的值代替. DEFINE的ON或OFF的设置控制SCAN变量的设置.

ECHO {OFF|ON} 控制START命令是否列出命令文件中的每一命令.为ON时,列出命令;为OFF时,制止列清单.

EMBEDDED {OFF(默认值)|ON} 控制每一报表在一页中开始的地方. 为OFF时,迫使每一报表是在新页的顶部开始;为ON时,运行一报表在一页的任何位置开始.

ESC[APE] {/(默认值)|C|OFF(默认值)|ON} 定义作为Escape字符的字符.为OFF时,使Escape字符不起作用.为ON时,使Escape字符起作用.

FEED[BACK] {6(默认值)|n|OFF|ON} 显示由查询返回的记录数.ON和OFF置显示为开或关.置FEEDBACK为ON时,等价于置n为1. 如果置FEEDBACK为0,等价于将它置成OFF.

FLU[SH] {OFF|ON(默认值)} 控制输出送至用户的显示设备.为OFF时,运行操作系统做缓冲区输出;为ON时,不允许缓冲. 仅当非交互方式运行命令文件时使用OFF,这样可减少程序I/O总是,从而改进性能.

HEA[DING] {OFF|ON(默认值)} 控制报表中列标题的打印.为ON时,在报表中打印列标题;为OFF时禁止打印列标题.

HEADS[EP] {|(默认值)|C|OFF|ON(默认值)} 定义标题分隔字符.可在COLUMN命令中使用标题分隔符,将列标题分成多行.ON和OFF将标题分隔置成开或关.当标题分隔为关(OFF)时,SQL*PLUS打印标题分隔符像任何字符一样.

LIN[ESIZE] {80(默认值)|n} 置SQL*PLUS在一行中显示的字符总数,它还控制在TTITLE和BTITLE中对准中心的文本和右对齐文本. 可定义LINESIZE为1至最大值,其最大值依赖于操作系统.

LONG {80(默认值)|n} 为显示和拷贝LONG类型值的最大宽度的设置. 对于ORACLE7, n的最大值为2G字节;对于版本6,最大值为32767.

LONGC[HUNKSIZE] {80(默认值)|n} 为SQL*PLUS检索LONG类型值的增量大小.由于内存的限制,可按增量检索,该变量仅应用于ORACLE7.

MAXD[ATA] n  置SQL*PLUS可处理的最大行宽字符数,其缺省值和最大值在不同操作系统中是可变的.

NEWP[AGE] {1(默认值)|n} 置每一页的头和顶部标题之间要打印的空行数.如果为0, 在页之间送一换号符,并在许多终端上清屏.

NULL text 设置表示空值(null)的文本,如果NULL没有文本,则显示空格(缺省时). 使用COLUMN命令中的NULL子句可控制NULL变量对该列的设置.

NUMF[ORMAT] 格式  设置显示数值的缺省格式,该格式是数值格式.

NUM[WIDTH] {10(默认值)|n} 对显示数值设置缺省宽度.

PAGES[IZE] {14(默认值)|n} 置从顶部标题至页结束之间的行数.在11英寸长的纸上打印报表,其值为54,上下各留一英寸(NEWPAGE值为6).

PAU[SE] {OFF(默认值)|ON|text} 在显示报表时,控制终端滚动.在每一暂停时,必须按RETURN键.ON将引起SQL*PLUS在每一报表输出页开始时暂停.所指定的文本是每一次 SQL*PLUS暂停时显示的文本.如果要键入多个词,必须用单引号将文本括起来.

RECSEP {WR[APPED](默认值)|EA[CH]|OFF}
  RECSEPCHAR { |C}  指定显示或打印记录分行符的条件.一个记录分行符,是由RECSEPCHAR指定的字符组成的单行.空格为RECSEPCHAR的默认字符.
  RECSEP 告诉SQL*PLUS在哪儿做记录分隔.例如将RECSEP置成WRAPPED,在每一缠绕行之后,打印记录分行符.如果将RECSEP置成 EACH,SQL*PLUS在每一行后打印一记录分行符.如果将RECSEP置成OFF, SQL*PLUS不打印分行符.