---
title: "创建 Catalog - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: 创建 Catalog 本文将向您介绍如何使用 SQL 语句创建 External Catalog。 权限要求 创建 External Catalog，需要当前用户拥有 CREATE CATALOG 权限。有关 OceanBase 数据库权限的详细介绍，参见 MySQL 模式下的权限分类 。 语法 创建 Externa…
---
切换语言

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

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

# 创建 Catalog

更新时间：2026-07-15 20:42:45

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

本文将向您介绍如何使用 SQL 语句创建 External Catalog。

## 权限要求

创建 External Catalog，需要当前用户拥有 `CREATE CATALOG` 权限。有关 OceanBase 数据库权限的详细介绍，参见 [MySQL 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016100)。

## 语法

创建 External Catalog 的 SQL 语句格式如下：

```sql
CREATE EXTERNAL CATALOG [IF NOT EXISTS] external_catalog_name
    PROPERTIES [=] (properties_type_options);

properties_type_options:
    odps_type_list

odps_type_list:
    TYPE = 'ODPS',
    [ACCESSTYPE = 'accesstype_string',]
    ACCESSID = 'string',
    ACCESSKEY = 'string',
    STSTOKEN = 'string',
    ENDPOINT = 'string',
    TUNNEL_ENDPOINT = 'string',
    PROJECT_NAME = 'string',
    [QUOTA_NAME = 'string',]
    [COMPRESSION = 'compression_string',]
    REGION = 'string'

accesstype_string:
    aliyun
    | sts
    | app

compression_string:
    zlib
    | zstd
    | lz4
    | odps_lz4

```

**参数说明：**

- `IF NOT EXISTS`：可选项，如果指定该子句，即使要创建的外部数据目录在当前租户中已存在，也不会报错，系统会提示一条 Warning 信息；如果不指定，则会报错。
 - `external_catalog_name`：表示要创建的外部数据目录的名称。
 - `PROPERTIES [=] (properties_type_options)`：用于指定外部数据目录类型的相关属性选项。
 - `odps_type_list`：表示 ODPS 类型外部数据目录（ODPS Catalog）的相关属性列表。

有关创建 External Catalog 语法的详细参数说明信息，参见 [CREATE EXTERNAL CATALOG](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002977502)。

## 创建 ODPS 类型的 External Catalog

外表读写 MaxCompute 数据时，取值为 `ODPS`。

通过 `CREATE EXTERNAL CATALOG` 创建与 MaxCompute（ODPS）的连接，实现直接查询 ODPS 表数据，无需手动创建映射表。Catalog 下对象为只读；向 MaxCompute 写入数据请使用 [ODPS 外部表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006319716)。

**示例如下：**

```shell
obclient> CREATE EXTERNAL CATALOG test_odps_catalog
    PROPERTIES = (
        TYPE = 'ODPS',
        ACCESSID = '$odps_accessid',
        ACCESSKEY = '$odps_accesskey',
        ENDPOINT = '$odps_endpoint',
        TUNNEL_ENDPOINT = 'http://xxx.maxcompute.aliyun.com',
        PROJECT_NAME = 'mysqltest_regression_sqlqa',
        QUOTA_NAME = '',
        COMPRESSION_CODE = ''
    );

```

## 相关文档

- [Catalog 概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004840206)
 - [查看 Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004840208)
 - [删除 Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004840209)
 - [CREATE EXTERNAL CATALOG](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002977502)

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