---
title: "FILES 表函数 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: "FILES 表函数 描述 FILES(...) 用于把外部文件位置映射为可查询行集，支持在 SELECT ... FROM 中直接读取外部数据。 语法 FILES(location_expr, format_expr [, pattern_expr]) 常见写法如下： SELECT * FROM FILES( loc…"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS

# FILES 表函数

更新时间：2026-07-14 20:42:33

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/400.functions-of-mysql-mode/760.table-functions-of-mysql-mode/200.files-table-function-of-mysql-mode.md)  

## 描述

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

## 语法

```sql
FILES(location_expr, format_expr [, pattern_expr])

```

常见写法如下：

```sql
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(...)` 指定数据来源。

## 相关文档

- [关于外表与外部文件](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016851)
 - [CREATE EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002017037)
 - [创建和查询外表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016852)
 - [SELECT 语句（MySQL 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002017573)
 - [LOAD DATA 语句（MySQL 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002017012)
 - [TABLE FUNCTION 概述（MySQL 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006089274)

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线