Oracle
SQL
Loader
的详细语法
Oracle
SQL
Loader
的详细语法
SQL
*LOADER
是
ORACLE
的数据加载工具，通常用来将操作系统文件迁移到
ORACLE
数据库中。
SQL
*LOADER
是大型数据
仓库选择使用的加载方法，因为它提供了最快速的途径（
DIRECT
，
PARALLEL
）。现在，我们抛开其理论不谈，用实例来使您快速掌握
SQL
*LOADER
的使用方法。
首先，我们认识一下
SQL
*LOADER
。
在
NT
下，
SQL
*LOADER
的命令为
SQLLDR
，在
UNIX
下一般为
sqlldr/sqlload
。
如执行：
d:/oracle
>sqlldr
SQL
*Loader
: Release 8.1.6.0.0 - Production on
星期二
1
月
8 11:06:42 2002
(c) Copyright 1999 Oracle
Corporation. All rights reserved.
用法
: SQLLOAD
关键字
=
值
[,keyword=value,...]
有效的关键字
:
userid -- ORACLE
username/password
control -- Control file name
log -- Log file name
bad -- Bad file name
data -- Data file name
discard -- Discard file name
discardmax -- Number of discards to allow (
全部默认
)
skip -- Number of logical records to skip (
默认
0)
load -- Number of logical records to load (
全部默认
)
errors -- Number of errors to allow (
默认
50)
rows -- Number of rows in conventional path bind array or between direct path data saves
（默认
:
常规路径
64,
所有直接路径）
bindsize -- Size of conventional path bind array in bytes(
默认
65536)
silent -- Suppress messages during run (header,feedback,errors,discards,partitions)
direct -- use direct path (
默认
FALSE)
parfile -- parameter file: name of file that contains parameter specifications
parallel
-- do parallel
load (
默认
FALSE)
file -- File to allocate extents from
skip_unusable_indexes -- disallow/allow unusable indexes or index partitions(
默认
FALSE)
skip_index_maintenance -- do not maintain indexes, mark affected indexes as unusable(
默认
FALSE)
commit_discontinued -- commit loaded rows when load is discontinued(
默认
FALSE)
readsize -- Size of Read buffer (
默认
1048576)
PLEASE NOTE:
命令行参数可以由位置或关键字指定
。前者的例子是
'sqlload scott/tiger foo';
后者的例子是
'sqlload control=foo userid=scott/tiger'.
位置指定参数的时间必须早于但不可迟于由关键字指定的参数。例如
,
'SQLLOAD SCott/tiger control=foo logfile=log',
但
'
不允许
SQL
Loader
的详细语法
SQL
*LOADER
是
ORACLE
的数据加载工具，通常用来将操作系统文件迁移到
ORACLE
数据库中。
SQL
*LOADER
是大型数据
仓库选择使用的加载方法，因为它提供了最快速的途径（
DIRECT
，
PARALLEL
）。现在，我们抛开其理论不谈，用实例来使您快速掌握
SQL
*LOADER
的使用方法。
首先，我们认识一下
SQL
*LOADER
。
在
NT
下，
SQL
*LOADER
的命令为
SQLLDR
，在
UNIX
下一般为
sqlldr/sqlload
。
如执行：
d:/oracle
>sqlldr
SQL
*Loader
: Release 8.1.6.0.0 - Production on
星期二
1
月
8 11:06:42 2002
(c) Copyright 1999 Oracle
Corporation. All rights reserved.
用法
: SQLLOAD
关键字
=
值
[,keyword=value,...]
有效的关键字
:
userid -- ORACLE
username/password
control -- Control file name
log -- Log file name
bad -- Bad file name
data -- Data file name
discard -- Discard file name
discardmax -- Number of discards to allow (
全部默认
)
skip -- Number of logical records to skip (
默认
0)
load -- Number of logical records to load (
全部默认
)
errors -- Number of errors to allow (
默认
50)
rows -- Number of rows in conventional path bind array or between direct path data saves
（默认
:
常规路径
64,
所有直接路径）
bindsize -- Size of conventional path bind array in bytes(
默认
65536)
silent -- Suppress messages during run (header,feedback,errors,discards,partitions)
direct -- use direct path (
默认
FALSE)
parfile -- parameter file: name of file that contains parameter specifications
parallel
-- do parallel
load (
默认
FALSE)
file -- File to allocate extents from
skip_unusable_indexes -- disallow/allow unusable indexes or index partitions(
默认
FALSE)
skip_index_maintenance -- do not maintain indexes, mark affected indexes as unusable(
默认
FALSE)
commit_discontinued -- commit loaded rows when load is discontinued(
默认
FALSE)
readsize -- Size of Read buffer (
默认
1048576)
PLEASE NOTE:
命令行参数可以由位置或关键字指定
。前者的例子是
'sqlload scott/tiger foo';
后者的例子是
'sqlload control=foo userid=scott/tiger'.
位置指定参数的时间必须早于但不可迟于由关键字指定的参数。例如
,
'SQLLOAD SCott/tiger control=foo logfile=log',
但
'
不允许
sqlload scott/tiger control=foo log',
即使允许
参数
'log'
的位置正确。
d:/oracle
>
我们可以从中看到一些基本的帮助信息，这里，我用到的是中文的
WIN2000
ADV
SERVER
。
我们知道，
SQL
*LOADER
只能导入纯文本，所以我们现在开始以实例来讲解其用法。
一、已存在数据源
result.csv
，欲倒入
ORACLE
中
FANCY
用户下。
result.csv
内容：
1,
默认
Web
站点
,192.168.2.254:80:,RUNNING
2,other,192.168.2.254:80:test.com,STOPPED
3,third,192.168.2.254:81:thirdabc.com,RUNNING
从中，我们看出
4
列，分别以逗号分隔，为变长字符串。
二、制定控制文件
result.ctl
result.ctl
内容：
load data
infile 'result.csv'
into table resultxt
(resultid char terminated by ',',
website char terminated by ',',
ipport char terminated by ',',
status char terminated by whitespace)
说明：
infile
指数据源文件 这里我们省略了默认的
discardfile result.dsc badfile result.bad
into table resultxt
默认是
INSERT
，也可以
into table resultxt APPEND
为追加方式，或
REPLACE
terminated by ','
指用逗号分隔
terminated by whitespace
结尾以空白分隔
三、此时我们执行加载：
D:/>sqlldr userid=fancy/testpass control=result.ctl log=resulthis.out
SQL
*Loader
: Release 8.1.6.0.0 - Production on
星期二
1
月
8 10:25:42 2002
(c) Copyright 1999 Oracle
Corporation. All rights reserved.
SQL
*Loader
-941:
在描述表
RESULTXT
时出现错误
ORA-04043:
对象
RESULTXT
不存在
提示出错，因为数据库没有对应的表。
四、在数据库建立表
create table resultxt
(resultid varchar2(500),
website varchar2(500),
ipport varchar2(500),
status varchar2(500))
/
五、重新执行加载
D:/>sqlldr userid=fancy/k1i7l6l8 control=result.ctl log=resulthis.out
SQL
*Loader
: Release 8.1.6.0.0 - Production on
星期二
1
月
8 10:31:57 2002
(c) Copyright 1999 Oracle
Corporation. All rights reserved.
达到提交点，逻辑记录计数
2
达到提交点，逻辑记录计数
3
已经成功！我们可以通过日志文件来分析其过程：
resulthis.out
内容如下：
SQL
*Loader
: Release 8.1.6.0.0 - Production on
星期二
1
月
8 10:31:57 2002
(c) Copyright 1999 Oracle
Corporation. All rights reserved.
控制文件
: result.ctl
数据文件
: result.csv
错误文件
: result.bad
废弃文件
:
未作指定
:
(
可废弃所有记录
)
装载数
: ALL
跳过数
: 0
允许的错误
: 50
绑定数组
: 64
行，最大
65536
字节
继续
:
未作指定
所用路径
:
常规
表
RESULTXT
已载入从每个逻辑记录
插入选项对此表
INSERT
生效
列名
位置
长度
中止
包装数据类型
------------------------------ ---------- ----- ---- ---- ---------------------
RESULTID FIRST * , CHARACTER
WEBSITE NEXT * , CHARACTER
IPPORT NEXT * , CHARACTER
STATUS NEXT * WHT CHARACTER
表
RESULTXT:
3
行载入成功
由于数据错误
, 0
行没有载入。
由于所有
WHEN
子句失败
, 0
行没有载入。
由于所有字段都为空的
, 0
行没有载入。
为结合数组分配的空间
: 65016
字节（
63
行）
除绑定数组外的内存空间分配
: 0
字节
跳过的逻辑记录总数
: 0
读取的逻辑记录总数
: 3
拒绝的逻辑记录总数
: 0
废弃的逻辑记录总数
: 0
从星期二
1
月
08 10:31:57 2002
开始运行
在星期二
1
月
08 10:32:00 2002
处运行结束
经过时间为
: 00: 00: 02.70
CPU
时间为
: 00: 00: 00.10(
可
六、并发操作
sqlldr userid=/ control=result1.ctl direct=true parallel
=true
sqlldr userid=/ control=result2.ctl direct=true parallel
=true
sqlldr userid=/ control=result2.ctl direct=true parallel
=true
当加载大量数据时（大约超过
10GB
），最好抑制日志的产生：
SQL
>ALTER TABLE RESULTXT nologging;
这样不产生
REDO
LOG
，可以提高效率。然后在
CONTROL
文件中
load data
上面加一行：
unrecoverable
此选项必须要与
DIRECT
共同应用。
在并发操作时，
ORACLE
声称可以达到每小时处理
100GB
数据的能力！其实，估计能到
1
－
10G
就算不错了，开始可用结构
相同的文件，但只有少量数据，成功后开始加载大量数据，这样可以避免时间的浪费。
有关
SQLLDR
的问题
控制文件：
input.ctl
，内容如下：
load data
--1
、控制文件标识
infile 'test.txt'
--2
、要输入的数据文件名为
test.txt
append into table test
--3
、向表
test
中追加记录
fields terminated by X'09'
--4
、字段终止于
X'09'
，是一个制表符（
TAB
）
(id,username,password,sj)
-----
定义列对应顺序
其中
append
为数据装载方式，还有其他选项：
a
、
insert
，为缺省方式，在数据装载开始时要求表为空
b
、
append
，在表中追加新记录
c
、
replace
，删除旧记录，替换成新装载的记录
d
、
truncate
，同上
即使允许
参数
'log'
的位置正确。
d:/oracle
>
我们可以从中看到一些基本的帮助信息，这里，我用到的是中文的
WIN2000
ADV
SERVER
。
我们知道，
SQL
*LOADER
只能导入纯文本，所以我们现在开始以实例来讲解其用法。
一、已存在数据源
result.csv
，欲倒入
ORACLE
中
FANCY
用户下。
result.csv
内容：
1,
默认
Web
站点
,192.168.2.254:80:,RUNNING
2,other,192.168.2.254:80:test.com,STOPPED
3,third,192.168.2.254:81:thirdabc.com,RUNNING
从中，我们看出
4
列，分别以逗号分隔，为变长字符串。
二、制定控制文件
result.ctl
result.ctl
内容：
load data
infile 'result.csv'
into table resultxt
(resultid char terminated by ',',
website char terminated by ',',
ipport char terminated by ',',
status char terminated by whitespace)
说明：
infile
指数据源文件 这里我们省略了默认的
discardfile result.dsc badfile result.bad
into table resultxt
默认是
INSERT
，也可以
into table resultxt APPEND
为追加方式，或
REPLACE
terminated by ','
指用逗号分隔
terminated by whitespace
结尾以空白分隔
三、此时我们执行加载：
D:/>sqlldr userid=fancy/testpass control=result.ctl log=resulthis.out
SQL
*Loader
: Release 8.1.6.0.0 - Production on
星期二
1
月
8 10:25:42 2002
(c) Copyright 1999 Oracle
Corporation. All rights reserved.
SQL
*Loader
-941:
在描述表
RESULTXT
时出现错误
ORA-04043:
对象
RESULTXT
不存在
提示出错，因为数据库没有对应的表。
四、在数据库建立表
create table resultxt
(resultid varchar2(500),
website varchar2(500),
ipport varchar2(500),
status varchar2(500))
/
五、重新执行加载
D:/>sqlldr userid=fancy/k1i7l6l8 control=result.ctl log=resulthis.out
SQL
*Loader
: Release 8.1.6.0.0 - Production on
星期二
1
月
8 10:31:57 2002
(c) Copyright 1999 Oracle
Corporation. All rights reserved.
达到提交点，逻辑记录计数
2
达到提交点，逻辑记录计数
3
已经成功！我们可以通过日志文件来分析其过程：
resulthis.out
内容如下：
SQL
*Loader
: Release 8.1.6.0.0 - Production on
星期二
1
月
8 10:31:57 2002
(c) Copyright 1999 Oracle
Corporation. All rights reserved.
控制文件
: result.ctl
数据文件
: result.csv
错误文件
: result.bad
废弃文件
:
未作指定
:
(
可废弃所有记录
)
装载数
: ALL
跳过数
: 0
允许的错误
: 50
绑定数组
: 64
行，最大
65536
字节
继续
:
未作指定
所用路径
:
常规
表
RESULTXT
已载入从每个逻辑记录
插入选项对此表
INSERT
生效
列名
位置
长度
中止
包装数据类型
------------------------------ ---------- ----- ---- ---- ---------------------
RESULTID FIRST * , CHARACTER
WEBSITE NEXT * , CHARACTER
IPPORT NEXT * , CHARACTER
STATUS NEXT * WHT CHARACTER
表
RESULTXT:
3
行载入成功
由于数据错误
, 0
行没有载入。
由于所有
WHEN
子句失败
, 0
行没有载入。
由于所有字段都为空的
, 0
行没有载入。
为结合数组分配的空间
: 65016
字节（
63
行）
除绑定数组外的内存空间分配
: 0
字节
跳过的逻辑记录总数
: 0
读取的逻辑记录总数
: 3
拒绝的逻辑记录总数
: 0
废弃的逻辑记录总数
: 0
从星期二
1
月
08 10:31:57 2002
开始运行
在星期二
1
月
08 10:32:00 2002
处运行结束
经过时间为
: 00: 00: 02.70
CPU
时间为
: 00: 00: 00.10(
可
六、并发操作
sqlldr userid=/ control=result1.ctl direct=true parallel
=true
sqlldr userid=/ control=result2.ctl direct=true parallel
=true
sqlldr userid=/ control=result2.ctl direct=true parallel
=true
当加载大量数据时（大约超过
10GB
），最好抑制日志的产生：
SQL
>ALTER TABLE RESULTXT nologging;
这样不产生
REDO
LOG
，可以提高效率。然后在
CONTROL
文件中
load data
上面加一行：
unrecoverable
此选项必须要与
DIRECT
共同应用。
在并发操作时，
ORACLE
声称可以达到每小时处理
100GB
数据的能力！其实，估计能到
1
－
10G
就算不错了，开始可用结构
相同的文件，但只有少量数据，成功后开始加载大量数据，这样可以避免时间的浪费。
有关
SQLLDR
的问题
控制文件：
input.ctl
，内容如下：
load data
--1
、控制文件标识
infile 'test.txt'
--2
、要输入的数据文件名为
test.txt
append into table test
--3
、向表
test
中追加记录
fields terminated by X'09'
--4
、字段终止于
X'09'
，是一个制表符（
TAB
）
(id,username,password,sj)
-----
定义列对应顺序
其中
append
为数据装载方式，还有其他选项：
a
、
insert
，为缺省方式，在数据装载开始时要求表为空
b
、
append
，在表中追加新记录
c
、
replace
，删除旧记录，替换成新装载的记录
d
、
truncate
，同上