FILES 表函数

描述

FILES(...) 用于把外部文件位置映射为可查询行集，支持在 SELECT ... FROM 中直接读取外部数据。

语法

FILES(location_expr, format_expr [, pattern_expr])

常见写法如下：

SELECT * FROM
FILES(
  location = '/data/',
  format (TYPE = 'csv', field_delimiter = ',', parse_header = true),
  pattern = 'datafiles$'
);

参数说明

• location_expr：外部数据位置。
• format_expr：文件格式子句，写法为 FORMAT (...) 或 format (...)（关键字大小写不敏感）。括号内为逗号分隔的格式选项列表，必须包含一项 TYPE = '<文件类型>'，其中 <文件类型> 为字符串字面量，取 'CSV'、'PARQUET' 或 'ORC'。各选项的语义、默认值与 CREATE EXTERNAL TABLE 中的 format_type_options 一致；在 FILES 中既可以使用文档外表语法中的大写形式（如 FIELD_DELIMITER），也可以使用小写下划线形式（如 field_delimiter），二者等价。
• pattern_expr：可选，用于按文件名模式过滤。

format(...) 中常用选项说明

TYPE 指定后，可按需追加下列选项（仅列出 FILES 读取平面文件时常用项；更完整的语法树见上文链接中的外表章节）。

当 TYPE = 'CSV' 时，还可指定例如：

当 TYPE = 'PARQUET' 或 TYPE = 'ORC' 时，在常见查询场景中一般只需指定 TYPE 即可；若还需叠加其它读入选项，名称与含义与外表 FORMAT = (...) 子句一致，参见 CREATE EXTERNAL TABLE 中的语法定义与参数说明。

使用说明

• FILES(...) 可直接用于 SELECT 的 FROM 子句。
• 在 LOAD DATA 场景中，也可通过 FROM FILES(...) 指定数据来源。

相关文档

• CREATE EXTERNAL TABLE（MySQL 模式）
• SELECT 语句（MySQL 模式）
• LOAD DATA 语句（MySQL 模式）
• TABLE FUNCTION 概述（MySQL 模式）