---
title: "Catalog 概述 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: Catalog 概述 在 OceanBase 数据库 V4.3.5 BP2 之前版本中，用户访问外部数据源需通过 CREATE EXTERNAL TABLE 手动创建映射表。当外部数据源包含大量表时，需要用户手动进行一一映射，灵活性不足。 为方便查询存储在各类外部数据源的数据，OceanBase 数据库引入了 Cat…
---
切换语言

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

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

# Catalog 概述

更新时间：2026-06-12 10:50:41

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/300.database-object-management/100.manage-object-of-mysql-mode/1000.manage-catalog-of-mysql-mode/100.catalog-overview-of-mysql-mode.md)  

在 OceanBase 数据库 V4.3.5 BP2 之前版本中，用户访问外部数据源需通过 `CREATE EXTERNAL TABLE` 手动创建映射表。当外部数据源包含大量表时，需要用户手动进行一一映射，灵活性不足。

为方便查询存储在各类外部数据源的数据，OceanBase 数据库引入了 Catalog（数据目录） 功能，通过新增数据层级实现对外部数据源的统一管理。

## Catalog 类型

Catalog 分为以下两类：

- Internal Catalog（内部数据目录）

  用于管理保存在 OceanBase 数据库内部的数据。每个租户都有且只有一个名为 `internal` 的内部数据目录。在 V4.3.5 BP2 之前的所创建的数据库和数据库内的对象（例如：表）都可认为保存在`internal` 中。Internal Catalog 不可创建、删除、修改。
 - External Catalog（外部数据目录）

  用于连接外部数据源，获取外部数据的元信息。可以通过 External Catalog 直接查询外部数据，无需进行数据导入或迁移。

## Catalog 优势

- 多层级数据管理架构

  在原有 Database-Table 层级基础上，新增 Catalog 层，形成 Catalog-Database-Table 三层结构，支持直接访问外部数据源的目录树。
 - 自动映射与按需查询

  只需通过 `CREATE EXTERNAL CATALOG` 声明与外部数据源的连接，即可透传查询外部表，无需手动创建映射表。
 - 统一查询体验

  查询外部数据源时，语法与本地表一致，支持跨源关联分析。

## Catalog 功能特点

- 支持多数据源

  支持 ODPS（MaxCompute）、HMS（Hive、Iceberg） 等外部数据源。
 - 权限隔离

  通过 Catalog 层控制外部数据源的访问权限，保障数据安全。
 - 性能优化

  基于 Catalog 的查询计划优化，减少中间数据传输，提升跨源查询效率。

## 适用场景

- 联合分析

  需要对 OceanBase 数据库数据与外部数据源进行联合分析的场景。
 - 数据湖/仓联动

  构建统一的数据湖架构，直接查询存储在 ODPS、Hive 等外部系统的海量数据。
 - ETL 管道优化

  减少数据迁移步骤，通过 Catalog 直接访问源系统数据，降低 ETL 开发复杂度。

## 使用限制

当前版本 Catalog 里面的数据是只读的（read-only），暂时不支持修改。所有对 Catalog 下对象的修改语句都会被禁止执行，例如，`DROP TABLE`、`INSERT INTO` 等。

## 相关文档

- [创建 External Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683169)
 - [查看 Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683170)
 - [删除 Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683167)

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