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：文件格式配置，常见为 CSV/PARQUET/ORC。
• pattern_expr：可选，用于按文件名模式过滤。

使用说明

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

相关文档

• 关于外表与外部文件
• CREATE EXTERNAL TABLE
• 创建和查询外表
• SELECT 语句（MySQL 模式）
• LOAD DATA 语句（MySQL 模式）
• TABLE FUNCTION 概述（MySQL 模式）