--- title: "关于外表与外部文件 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: 关于外表与外部文件 外表（External Table）的数据存储在 OceanBase 集群外部的存储系统中（本地目录、对象存储、HDFS 等），数据库内仅保存元数据与访问路径。创建成功后，可像普通表一样用于 SELECT 、JOIN、聚合等，但 只读 ，不支持 DML、约束与索引。 与普通表的差异： 特性 外表 … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # 关于外表与外部文件 更新时间：2026-07-15 15:27:38 [编辑](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/100.about-external-tables-of-oracle-mode.md) 外表（External Table）的数据存储在 OceanBase 集群外部的存储系统中（本地目录、对象存储、HDFS 等），数据库内仅保存元数据与访问路径。创建成功后，可像普通表一样用于 `SELECT`、JOIN、聚合等，但**只读**，不支持 DML、约束与索引。 与普通表的差异： | 特性 | 外表 | 普通表 | | --- | --- | --- | | 数据位置 | 外部存储 | OceanBase 内部 | | 读写 | 外表**只读**：可 `SELECT`，不能对其执行 `INSERT`、`UPDATE`、`DELETE` 等 DML。 | 读写 | | 约束与索引 | 不支持 | 支持 | | 典型性能 | 受网络与外部系统影响 | 本地访问更快 | ## 注意事项 - 创建时根据 `LOCATION`、`PATTERN` 收集文件列表；新增文件需刷新，参见 [管理外部文件](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685841) 与 [ALTER EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687544)。 - 外表分区在 `PARTITION_TYPE = USER_SPECIFIED` 时，可通过 [ALTER EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687544) 增加或删除分区 `LOCATION`（MySQL 模式 ALTER 能力请以对应文档为准）。 - 已删除的外部文件查询时不报错；并发修改外部文件可能导致非预期结果。 ## 外部数据访问方式 | 方式 | 是否创建表对象 | 典型场景 | 语法与文档入口 | | --- | --- | --- | --- | | **外表（CREATE EXTERNAL TABLE）** | 是 | 需反复查询、需 JOIN 内表、需管理文件列表与分区 | [CREATE EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687522)、[创建和查询外表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685839) | | **FILES 表函数** | 否 | 临时探查、一次性读取 | [FILES 表函数](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006086416)、[URL 外表（无元数据）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682054) | #### 说明 文件格式（`FORMAT`）的完整参数以 [CREATE EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687522) 为准。External Catalog 等能力以 MySQL 模式文档为主，Oracle 模式请以实际支持的功能为准。 ## HDFS 外表 访问 HDFS 需[部署 OceanBase 数据库 JAVA SDK 环境](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681933)，并配置 [ob_enable_java_env](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685724) 等项。详见 [CREATE EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687522)。故障排查，参见 [外表常见问题排查指南](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681960)。 ## 相关文档 - [创建和查询外表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685839) - [创建外表分区](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685842) - [管理外部文件](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685841) - [数据类型映射](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685843) - [CREATE EXTERNAL TABLE 语法（权威参考）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687522) - [FILES 表函数](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006086416) 上一篇 下一篇 ![有帮助](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) 咨询热线