---
title: "查看 Catalog - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: 查看 Catalog 创建 Catalog 后，可以通过 SQL 语句查看 Catalog 的相关信息。 查看创建 Catalog 的语句 可以使用 SHOW CREATE CATALOG external_catalog_name; 查看 Catalog 的创建语句。 示例如下： obclient> SHOW CR…
---
切换语言

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

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

# 查看 Catalog

更新时间：2026-07-15 15:16:39

[编辑](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/300.view-catalog-of-mysql-mode.md)  

创建 Catalog 后，可以通过 SQL 语句查看 Catalog 的相关信息。

## 查看创建 Catalog 的语句

可以使用 `SHOW CREATE CATALOG external_catalog_name;` 查看 Catalog 的创建语句。

**示例如下：**

```shell
obclient> SHOW CREATE CATALOG test_odps_catalog;

```

## 查看当前租户的 Catalog

可以使用 `SHOW CATALOGS;` 查看当前租户的 Catalog。

**示例如下：**

```shell
obclient> SHOW CATALOGS;

```

## 查看 Catalog 中的数据

在 Catalog 中，可以和数据库内的表一样执行任意查询操作，也可以跨 Catalog 进行联合查询。

**示例如下：**

```shell
obclient> SELECT * FROM internal.test.t1, odps_catalog.default.t1;

```

### 查询 Iceberg 表历史数据

OceanBase 数据库支持查询 Iceberg 表历史数据的功能（Time Travel），即查询表在过去某个快照时的状态，即使这些数据在之后被修改或删除，也仍然可以访问当时的内容。

Time Travel 语句格式如下：

```sql
SELECT select_expr_list
    FROM iceberg_table_name {VERSION AS OF 'version_identifier'
                            | TIMESTAMP AS OF 'timestamp'};

version_identifier:
    branch_name
    | tag_name
    | snapshot_id

```

**参数说明：**

- `select_expr_list`：指定要在查询结果中显示的列或表达式列表。有关 `SELECT` 语句的详细信息，参见 [SELECT](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005687394)。
 - `iceberg_table_name`：指定 Iceberg 表名。
 - `branch_name`：指定分支名称（字符串类型），查询将 Time Travel 到该分支的头部快照。
 - `tag_name`：指定标签名称（字符串类型），查询将 Time Travel 到标签所对应的快照。
 - `snapshot_id`：指定 snapshot id（整数类型），查询将 Time Travel 到 snapshot id 所对应的快照。
 - `timestamp`：指定时间戳（时间戳类型），查询将返回早于或等于该时间点的最新快照。

  #### 说明

  如果指定的时间点（`timestamp`）该表还没有创建，查询将报错并反馈错误消息：Table snapshot does not exist。

**示例如下：**

- Time Travel 到分支为 `audit-branch` 的头部快照。

  ```shell
  obclient> SELECT * FROM prod.db.table VERSION AS OF 'audit-branch';

  ```
 - Time Travel 到标签为 `historical-snapshot` 所对应的快照。

  ```shell
  obclient> SELECT * FROM prod.db.table VERSION AS OF 'historical-snapshot';

  ```
 - Time Travel 到 snapshot id 为 10963874102873 的快照。

  ```shell
  obclient> SELECT * FROM prod.db.table VERSION AS OF 10963874102873;

  ```
 - Time Travel 到 1986 年 10 月 26 日 01:21:00 的最新快照。

  ```shell
  obclient> SELECT * FROM prod.db.table TIMESTAMP AS OF '1986-10-26 01:21:00';

  ```

## Catalog 切换

可以使用 `SET CATALOG catalog_name;` 语句切换 Catalog。

也可以使用 `USE internal.test;` 或 `USE odps_catalog.default` 一次性完成切换 Catalog 和数据库的操作。

**示例如下：**

- 切换成系统内部 Catalog。

  ```shell
  obclient> SET CATALOG internal;

  ```
 - 切换成外部 Catalog。

  ```shell
  obclient> SET CATALOG external_catalog_name;

  ```

## 相关文档

- [Catalog 概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683168)
 - [创建 External Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683169)
 - [删除 Catalog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683167)
 - [SHOW](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005686135)

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