--- title: "创建和查询外表 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: 创建和查询外表 本文介绍在 Oracle 模式下 创建并查询文件外表 的操作步骤。完整语法、 LOCATION 、 FORMAT 等参数说明，请以 CREATE EXTERNAL TABLE 为准。 若只需临时读取外部文件，请使用 FILES 表函数 。 前提条件 已部署集群并创建 Oracle 模式租户，且已连接数… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # 创建和查询外表 更新时间：2026-06-24 21:06:44 [编辑](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/200.create-a-external-table-of-oracle-mode.md) 本文介绍在 Oracle 模式下**创建并查询文件外表**的操作步骤。完整语法、`LOCATION`、`FORMAT` 等参数说明，请以 [CREATE EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687522) 为准。 若只需临时读取外部文件，请使用 [FILES 表函数](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006086416)。 ## 前提条件 - 已部署集群并创建 Oracle 模式租户，且已连接数据库。 - 当前用户具备 `CREATE` 权限。查看当前用户权限的操作请参见 [查看用户权限](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685761)。如果您没有 `CREATE TABLE` 权限，请联系管理员为您添加，为用户添加权限的相关操作请参见 [直接授予权限](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685760)。 - 本地文件路径须在 [secure_file_priv](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685248) 允许范围内。 - 访问 HDFS 需完成 [部署 OceanBase 数据库 JAVA SDK 环境](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005681933) 配置。 ## 示例 ### 创建本地 CSV 文件外表 假设本地机器的 `/home/admin/oceanbase/` 下存放了一个 `data.csv` 文件，文件中的内容如下。 ```shell 1,"lin",98 2,"hei",90 3,"ali",95 ``` 1. 在 OBServer 节点上，租户管理员通过本地 Unix Socket 连接集群的 Oracle 租户。 连接示例如下： ```shell obclient -S /home/admin/oceanbase/run/sql.sock -uroot@sys -p******** ``` 通过本地 Unix Socket 连接 OceanBase 数据库的具体操作及说明，请参见 [secure_file_priv](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685248)。 2. 配置数据库可以访问的路径 `/home/admin/oceanbase/`。 ```sql SET GLOBAL secure_file_priv = "/home/admin/oceanbase/"; ``` 命令执行成功后，需要重启会话后，修改才能生效。 3. 重新连接数据库后，创建外表 `ext_t3`。 ```sql CREATE EXTERNAL TABLE ext_t3(ID NUMBER(32), NAME VARCHAR2(30),SCORE NUMBER(32)) LOCATION = '/home/admin/oceanbase/' FORMAT = ( TYPE = 'CSV' FIELD_DELIMITER = ',' FIELD_OPTIONALLY_ENCLOSED_BY ='"' ) PATTERN = 'data.csv'; ``` 外表创建成功后，可以像普通表一样使用 `SHOW CREATE TABLE` 语句来查看表的定义。 ```sql SHOW CREATE TABLE ext_t3; ``` 查询结果如下： ```shell +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | TABLE | CREATE TABLE | +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | EXT_T3 | CREATE EXTERNAL TABLE "EXT_T3" ( "ID" NUMBER(32) GENERATED ALWAYS AS (METADATA$FILECOL1), "NAME" VARCHAR2(30) GENERATED ALWAYS AS (METADATA$FILECOL2), "SCORE" NUMBER(32) GENERATED ALWAYS AS (METADATA$FILECOL3) ) LOCATION='file:///home/admin/oceanbase/' PATTERN='data.csv' FORMAT ( TYPE = 'CSV', FIELD_DELIMITER = ',', FIELD_OPTIONALLY_ENCLOSED_BY = '"', ENCODING = 'utf8mb4' )COMPRESS FOR ARCHIVE REPLICA_NUM = 1 BLOCK_SIZE = 16384 USE_BLOOM_FILTER = FALSE TABLET_SIZE = 134217728 PCTFREE = 0 | +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ 1 row in set ``` 也可以像普通表一样进行访问。查询外表时，系统通过外表的驱动层直接读取外部文件，并按照文件格式进行解析，转换成 OceanBase 数据库内部的数据类型后返回数据行。查询刚刚创建的外表 `ext_t3` 的示例如下。 ```sql SELECT * FROM ext_t3; ``` 查询结果如下： ```shell +----+------+-------+ | id | name | score | +----+------+-------+ | 1 | lin | 98 | | 2 | hei | 90 | | 3 | ali | 95 | +----+------+-------+ 3 rows in set ``` 此外，外表也可以与普通表进行组合查询操作。假设当前数据库中有一个普通表 `info`，表中的数据如下所示： ```shell +------+--------+------+ | name | sex | age | +------+--------+------+ | lin | male | 8 | | hei | male | 9 | | li | female | 8 | +------+--------+------+ 3 rows in set ``` 将外部表 `ext_t3` 与普通表 `info` 组合查询的示例如下。 ```sql SELECT info.* FROM info, ext_t3 WHERE info.name = ext_t3.name AND ext_t3.score > 90; ``` 查询结果如下： ```shell +------+--------+------+ | name | sex | age | +------+--------+------+ | lin | male | 8 | | li | female | 8 | +------+--------+------+ 2 rows in set ``` 更多查询操作，请参见 [读取数据](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682529)。 ## 后续操作 - 刷新文件列表：`ALTER EXTERNAL TABLE table_name REFRESH;`，参见 [管理外部文件](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685841) 与 [ALTER EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687544)。 ## 相关文档 - [关于外表与外部文件](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685840) - [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://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685841) 上一篇 下一篇 ![有帮助](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) 咨询热线