--- title: "管理外部文件 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: 管理外部文件 外表创建时，系统会将 LOCATION 中指定路径下匹配 PATTERN 的文件列表保存在 OceanBase 数据库的系统表中，外表扫描时会根据该列表来访问外部文件。您可以查看和更新外表可访问的文件。 查看外表的文件 外表创建后，可以通过 ALL_OB_EXTERNAL_TABLE_FILES 视图和… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # 管理外部文件 更新时间：2026-06-29 10:16:47 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/300.database-object-management/200.manage-object-of-oracle-mode/100.manage-tables-of-oracle-mode/1000.manage-external-tables-of-oracle-mode/300.manage-external-files-of-oracle-mode.md) 外表创建时，系统会将 `LOCATION` 中指定路径下匹配 `PATTERN` 的文件列表保存在 OceanBase 数据库的系统表中，外表扫描时会根据该列表来访问外部文件。您可以查看和更新外表可访问的文件。 ## 查看外表的文件 外表创建后，可以通过 `ALL_OB_EXTERNAL_TABLE_FILES` 视图和 `DBA_OB_EXTERNAL_TABLE_FILES` 视图来查看外表信息，语句示例如下： - 外部目录中仅有一个文件的场景 ```sql SELECT * FROM SYS.DBA_OB_EXTERNAL_TABLE_FILES; ``` 查询结果如下： ```sql +------------+-------+----------------+------------------------------+-----------+ | TABLE_NAME | OWNER | PARTITION_NAME | FILE_URL | FILE_SIZE | +------------+-------+----------------+------------------------------+-----------+ | EXT_T3 | SYS | P0 | xx.xx.xx.208:2882%data.csv | 29 | +------------+-------+----------------+------------------------------+-----------+ 1 row in set ``` - 外部目录中有多个文件的场景 ```sql SELECT * FROM SYS.DBA_OB_EXTERNAL_TABLE_FILES WHERE TABLE_NAME= 'EXT_T4'; ``` 查询结果如下： ```shell +------------+-------+----------------+-------------------------------+-----------+ | TABLE_NAME | OWNER | PARTITION_NAME | FILE_URL | FILE_SIZE | +------------+-------+----------------+-------------------------------+-----------+ | EXT_T4 | SYS | P0 | xx.xx.xx.208:2882%data2.csv | 34 | | EXT_T4 | SYS | P0 | xx.xx.xx.208:2882%data1.csv | 33 | +------------+-------+----------------+-------------------------------+-----------+ 2 rows in set ``` 其中： - `TABLE_NAME`：外表的表名。 - `OWNER`：外表所属的用户。 - `PARTITION_NAME`：外表的分区名。 - `FILE_URL`：外表所访问的文件的 URL。 - `FILE_SIZE`：外表所访问的文件的大小。 ## 更新外表的文件 外表创建后，如果外部目录新增了其他文件（该文件在 `LOCATION` 中指定的路径下且匹配 `PATTERN`），您需要执行更新外表文件的操作，才能通过外表访问新增的文件。 更新外表文件的 SQL 语句如下： ```sql ALTER EXTERNAL TABLE table_name refresh; ``` 下面以一个简单的示例进行说明。假设有一个外表 `ext_t4`，其外部文件中包含 `data1.csv` 和 `data2.csv` 两个文件，再在同目录中新增一个 `data3.csv` 文件。 1. 更新外表文件前，查询该外表中的所有文件。 ``` 查询结果如下： ``` 2. 进入外表所在的数据库，并更新外表文件。 ```sql ALTER EXTERNAL TABLE EXT_T4 REFRESH; ``` 3. 再次查询该外表中的所有文件。 ``` 查询结果如下： ```shell +------------+-------+----------------+-------------------------------+-----------+ | TABLE_NAME | OWNER | PARTITION_NAME | FILE_URL | FILE_SIZE | +------------+-------+----------------+-------------------------------+-----------+ | EXT_T4 | SYS | P0 | xx.xx.xx.208:2882%data3.csv | 33 | | EXT_T4 | SYS | P0 | xx.xx.xx.208:2882%data2.csv | 34 | | EXT_T4 | SYS | P0 | xx.xx.xx.208:2882%data1.csv | 33 | +------------+-------+----------------+-------------------------------+-----------+ 3 rows in set ``` ## 相关文档 [关于外表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685840) [创建外表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685839) 上一篇 下一篇 ![有帮助](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) 咨询热线