---
title: "SET_CATALOG_TABLE_PREFS - OceanBase 数据库 V5.0.1 | OceanBase 文档中心"
description: SET_CATALOG_TABLE_PREFS SET_CATALOG_TABLE_PREFS 用于设置 Catalog 中表级偏好项的值。 说明 该子程序从 V5.0.1 版本开始引入。 语法 DBMS_STATS.SET_CATALOG_TABLE_PREFS ( catname VARCHAR(65535), …
---
切换语言

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

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

# SET_CATALOG_TABLE_PREFS

更新时间：2026-07-29 10:39:51

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V5.0.1/zh-CN/700.reference/600.pl-reference/200.pl-mysql/1000.pl-system-package-mysql/15900.dbms-stats-mysql/3430.set_catalog_table_prefs-of-mysql-mode.md)  

`SET_CATALOG_TABLE_PREFS` 用于设置 Catalog 中表级偏好项的值。

#### 说明

该子程序从 V5.0.1 版本开始引入。

## 语法

```sql
DBMS_STATS.SET_CATALOG_TABLE_PREFS (
    catname        VARCHAR(65535),
    dbname         VARCHAR(65535),
    tabname        VARCHAR(65535),
    pname          VARCHAR(65535),
    pvalue         VARCHAR(65535)
    );

```

## 参数说明

| **参数** | **解释** |
| --- | --- |
| catname | 指定 Catalog 名称。 |
| dbname | 指定 Database 名称。 |
| tabname | 指定表名称。 |
| pname | 指定要设置的偏好项名称，取值如下：   - `CATALOG_STATS_BATCH_SIZE`：用于指定在一次 Catalog 统计信息收集任务中，最多可并入处理的分区（`partition`）数量。 |
| pvalue | 指定偏好项的值。 |

## 示例

设置 Catalog 名称 `hive_catalog` 和 Database 名称 `test_oss` 下表 `lineitem` 的 `CATALOG_STATS_BATCH_SIZE` 值为 `100`。

```shell
obclient> CALL DBMS_STATS.GATHER_CATALOG_TABLE_STATS (
    'hive_catalog',
    'test_oss',
    'lineitem',
    'CATALOG_STATS_BATCH_SIZE',
    100
);

```

## 相关文档

- [DELETE_CATALOG_TABLE_PREFS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006619670)
 - [GET_CATALOG_PREFS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006619683)

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