---
title: "数据湖概述 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: 数据湖概述 OceanBase 支持通过**外部表（External Table） 和 外部目录（External Catalog）**访问外部数据，涵盖文件型数据（CSV / Parquet / ORC）以及 MaxCompute（ODPS）等数据源。 您可以在 OceanBase 中查询、分析存储在对象存储、HD…
---
切换语言

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

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

# 数据湖概述

更新时间：2026-06-24 17:02:52

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/620.obap/400.data-lake/100.data-lake-overview.md)  

OceanBase 支持通过**外部表（External Table）**和**外部目录（External Catalog）**访问外部数据，涵盖文件型数据（CSV / Parquet / ORC）以及 MaxCompute（ODPS）等数据源。

您可以在 OceanBase 中查询、分析存储在对象存储、HDFS 或 MaxCompute 等外部系统中的数据，并与内表进行联邦分析。

#### 说明

数据湖相关能力以 **MySQL 模式**为主；Catalog 能力当前仅 MySQL 模式支持。具体语法与版本边界以 `700.reference` 下 SQL 参考文档为准；接入步骤详见本目录各子文档。

OceanBase 当前支持的数据湖能力主要包括：

- 外部文件格式访问（CSV、Parquet、ORC）
 - 外部 Catalog 接入（ODPS Catalog）
 - 外部存储访问（本地、OSS、S3、HDFS 等）
 - 外部数据查询、部分写入与导出
 - 外部表和外部目录管理

## 数据湖访问模型

OceanBase 访问外部数据时，涉及以下几个层次：

- **存储层**：数据实际存放位置，例如 OSS、S3、HDFS、本地文件系统。
 - **文件格式层**：数据文件的编码方式，例如 Parquet、ORC、CSV。
 - **Catalog 层**：外部元数据服务，例如 ODPS Catalog。
 - **访问层**：通过外部表或 External Catalog 将外部数据纳入 OceanBase SQL 查询体系。

MaxCompute（ODPS）属于外部数仓服务，通过 **ODPS Catalog** 或 **ODPS 外部表**（`PROPERTIES (TYPE = 'ODPS' ...)`）接入。

## 支持的数据湖格式

### 外部数据源

| 数据源 | 说明 | 接入方式 |
| --- | --- | --- |
| MaxCompute（ODPS） | 阿里云大数据计算服务 | [ODPS Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005066782)（项目级，只读）或 [ODPS 外部表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006319716)（单表，支持 `INSERT`） |

### 数据文件格式（File Format）

| 格式 | 说明 | 典型场景 |
| --- | --- | --- |
| Apache Parquet | 列式存储 | 文件外表、`SELECT INTO OUTFILE` |
| Apache ORC | 列式存储 | 文件外表、`SELECT INTO OUTFILE` |
| CSV | 文本格式 | 文件外表、`SELECT INTO OUTFILE`、`LOAD DATA`、URL 外表（`FILES()`） |

## 支持的 Catalog 类型

#### 注意

当前 [CREATE EXTERNAL CATALOG](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002977502) SQL 参考文档主要说明 `TYPE = 'ODPS'` 的用法。创建 ODPS Catalog 需 OceanBase 数据库 V4.3.5 BP2 及以上版本。详细说明参见 [ODPS Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005066782)。

| Catalog 类型 | 说明 | 用途 | 文档 |
| --- | --- | --- | --- |
| ODPS | MaxCompute 项目目录 | 查询 MaxCompute 项目中的表（只读，V4.3.5 BP2+） | [ODPS Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005066782) |

## 支持的存储类型

### 对象存储与分布式存储

| 存储类型 | URI 前缀 | 说明 |
| --- | --- | --- |
| 阿里云 OSS | `oss://` | 文件外表、URL 外表、`SELECT INTO OUTFILE` 等 |
| AWS S3 | `s3://` | 同上 |
| HDFS | `hdfs://` | V4.3.5 BP1 及以上；需部署 Java SDK 环境 |
| 本地文件系统 | `file://` 或路径 | 受 `secure_file_priv` 限制 |

#### 说明

Azure Blob（`azblob://`）当前见于备份/归档等场景；外表 `LOCATION` 是否支持请以 [CREATE EXTERNAL TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002017037) 为准。

### Location 与访问凭证

创建外部表或 Location 时，需配置访问凭证（如 `access_id`、`access_key` 等），支持通过 URL 参数或 `CREATE LOCATION` 预先配置（Location 语法请参考 [CREATE LOCATION]()）。

## 支持的数据操作

### 读操作（SELECT）

| 操作 | 适用对象 | 说明 |
| --- | --- | --- |
| `SELECT` 查询 | 文件外表、URL 外表、External Catalog 表 | 各类型支持范围见对应子文档 |
| 分区裁剪 | ODPS Catalog 表 | 在 `WHERE` 中指定分区列时可缩小扫描 |
| `JOIN` | 上述外部对象与内表 | 支持联邦查询 |

### 写操作与导出

| 操作 | 适用对象 | 说明 |
| --- | --- | --- |
| `INSERT INTO` | [ODPS 外部表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006319716) | 经 MaxCompute API 写入远端表；文件型外表只读 |
| `SELECT INTO OUTFILE` | CSV、Parquet、ORC | 导出到对象存储或本地文件 |
| `CREATE TABLE AS SELECT` | — | 可从外部数据创建**内表** |

### 外表与目录管理

| 操作 | 说明 |
| --- | --- |
| `CREATE EXTERNAL TABLE` | 创建文件外表或 ODPS 外表 |
| `CREATE EXTERNAL CATALOG` | 创建外部目录 |
| `ALTER EXTERNAL TABLE` | 刷新文件列表、管理分区等 |
| `DROP TABLE` / `DROP CATALOG` | 删除外表或目录 |
| `AUTO_REFRESH` | 支持 `OFF`、`IMMEDIATE`、`INTERVAL` |

## 能力边界

### 已知限制

| 限制项 | 说明 |
| --- | --- |
| 文件型外表 | 只读，不支持 DML、约束与索引 |
| External Catalog | Catalog 下对象只读，不支持 `INSERT`、`DROP TABLE` 等（写入 ODPS 请使用 ODPS 外部表） |
| COS 外部表 | 已不再支持新建 |
| Catalog 模式 | 当前仅 MySQL 模式 |

## 相关文档

- [Catalog 与外部表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006319715)
 - [文件外部表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005066785)
 - [URL 外部表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005066787)

 上一篇 下一篇 ![有帮助](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) 咨询热线