#external_table
external_table_data_props_clause::=
external_table_clause用于在创建一个外部表时，指定其对应的外部数据信息。
本语句不会对外部数据是否存在及正确进行校验，即只要语法正确均可创建成功。查询一个外部表时，系统根据本语句所定义的外部数据信息进行检索，不满足条件时则会报错。
# type
通过TYPE关键字指定外部表驱动名，可省略。access_driver_type的值可为YASDB_LOADER或ORACLE_LOADER，二者等价。
# external_table_data_props_clause
指定外部表中数据的属性，可省略。
# default directory
指定外部表对应数据文件所在的缺省目录，可省略。当后续语句中未指定directory_name时，将以本目录作为数据或日志文件所在的默认目录。
directory_name必须为YashanDB中已创建的一个目录对象，创建方式参考CREATE DIRECTORY。
# access parameters
指定在查询外部表时，读取外部数据文件的参数，包括源文件名称、列格式以及日志记录。
# record_format_info_clause
指定数据行格式，可省略。
# delimited by newline
指定读取外部数据文件时，数据记录之间的分隔符是换行符。
# output_files_clause
指定数据库在读取外部数据时的日志信息，若省略该子句，系统将以默认名称创建日志文件进行记录。
# nobadfile | badfile
指定BADFILE时，查询外部数据过程中遇到的错误数据将记录在file_pos_clause指定的文件中。
指定NOBADFILE时，系统不会记录查询外部数据时的错误数据。
# nologfile | logfile
指定LOGFILE时，查询外部数据的操作过程将记录在file_pos_clause指定的文件中。
指定NOLOGFILE时，系统不会记录查询外部数据时的操作信息。
# file_pos_clause
指定上述badfile或logfile所对应的物理文件，格式为directory_name:file_name。
directory_name必须为YashanDB中已创建的一个目录对象，省略时默认为DEFAULT DIRECTORY所指定目录对象。
Note:
出于性能考虑，在共享集群部署中不建议将badfile和logfile的directory设置在YFS。
file_name为一个操作系统可接受的文件名称，对于不存在的文件将由系统在记录日志时创建，对于已存在的文件，系统将对badfile进行覆盖填写，对logfile进行追加填写。
对于file_name，数据库会对部分符号进行替换：
%%将被替换为%；%a、%p将被替换为当前线程ID。
# field_definitions_clause
指定外部数据列格式，可省略。
# terminated by
指定外部数据文件的字段之间的分隔符，分隔符的类型只能为字符，应与外部数据文件中实际使用的分隔符保持一致，若省略则默认为','。
# optionally enclosed by
如果外部数据文件中使用了封闭符号（只能使用'"'封闭符），需通过本语句进行指定，且只能指定为'"'。
# location
指定外部数据文件所在的路径，格式为(directory_name:location_specifier)。
directory_name必须为YashanDB中已创建的一个目录对象，省略时默认为DEFAULT DIRECTORY所指定目录对象。
location_specifier为一个已存在的CSV文件的名称。
# reject limit
指定在查询外部数据时，可容忍的最多错误数据行数，达到容忍值时系统将终止查询操作。可省略，则默认为0行。UNLIMITED表示容许所有的数据错误。
示例（单机部署）
-- 在/data/area.csv中存在如下数据：
8|load|801|loadbranch|8
9|load|901|loadbranch|9
-- 在数据库中创建目录对象和外部表
CREATE DIRECTORY dir_ext AS '/data';
CREATE TABLE area_external(
area_no CHAR(2),
area_name VARCHAR2(60),
DHQ VARCHAR2(20) DEFAULT 'ShenZhen')
ORGANIZATION EXTERNAL(
TYPE YASDB_LOADER
DEFAULT DIRECTORY dir_ext
ACCESS PARAMETERS(
RECORDS BADFILE 'area_bad.log' LOGFILE 'area_log.log'
FIELDS TERMINATED BY ',')
LOCATION ('area.csv')
)
REJECT LIMIT 1;
-- 查询表数据，由于文件内数据格式与表定义格式不匹配，将无法查询到数据且达到容错行数退出
SELECT * FROM area_external;
YAS-02687 reject limit reached
下载文档
复制链接