---
title: "oceanbase.DBA_OB_AI_GATEWAYS - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: oceanbase.DBA_OB_AI_GATEWAYS 说明 该视图从 V4.6.0 BP1 版本开始引入。 功能描述 展示本租户的 AI 网关（Gateway）配置信息，用于查看通过 CREATE_AI_GATEWAY PL 子程序创建的多端点路由与权重配置。 字段说明 字段 类型 是否为 NULL 描述 GAT…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

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

# oceanbase.DBA_OB_AI_GATEWAYS

更新时间：2026-08-27 17:01:56

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/700.system-views/400.system-view-of-mysql-mode/200.dictionary-view-of-mysql-mode/5705.o-dba_ob_ai_gateways-of-mysql-mode.md)

#### 说明

该视图从 V4.6.0 BP1 版本开始引入。

## 功能描述

展示本租户的 AI 网关（Gateway）配置信息，用于查看通过 `CREATE_AI_GATEWAY` PL 子程序创建的多端点路由与权重配置。

## 字段说明

| 字段 | 类型 | 是否为 NULL | 描述 |
| --- | --- | --- | --- |
| GATEWAY_NAME | varchar(256) | NO | 网关名称。 |
| ENDPOINTS | varchar(32767) | NO | 端点（Endpoint）路由列表 JSON。每项包含 `name`、`model`、`weight` 等字段，`model` 为 `provider/model` 格式。 |
| CIRCUIT_BREAKER | varchar(4096) | YES | 网关级熔断配置 JSON。 |
| CREATE_TIME | timestamp(6) | NO | 创建时间。 |
| UPDATE_TIME | timestamp(6) | NO | 最近修改时间。 |

## 查询示例

本示例展示了用户租户查询本租户的 AI 网关配置信息。

1. 如尚未注册厂商配置，请先执行 `REGISTER_PROVIDER`，并替换 `access_key` 与 `base_url` 为实际值：

   ```shell
   CALL DBMS_AI_SERVICE.REGISTER_PROVIDER('test-provider', '{
   "protocol": "openai",
   "base_url": "https://xxx",
   "access_key": "sk-xxx"
   }');
   CALL DBMS_AI_SERVICE.CREATE_AI_GATEWAY('test', '{
   "endpoints": [
       {"name":"ep1","model":"test-provider/test-model","weight":70},
       {"name":"ep2","model":"test-provider/test-model2","weight":30}
   ]
   }');

   ```
 2. 查询网关配置信息：

   ```sql
   SELECT GATEWAY_NAME, ENDPOINTS, CIRCUIT_BREAKER
   FROM oceanbase.DBA_OB_AI_GATEWAYS
   WHERE GATEWAY_NAME = 'test';

   ```

   示例结果如下：

   ```shell
   GATEWAY_NAME	ENDPOINTS	CIRCUIT_BREAKER
   test	[{"name": "ep1", "model": "test-provider/test-model", "weight": 70}, {"name": "ep2", "model": "test-provider/test-model2", "weight": 30}]	NULL

   ```

#### 说明

如需按端点维度排查路由配置，请查询 `DBA_OB_AI_GATEWAY_ENDPOINTS` 视图。

## 相关文档

- [CREATE_AI_GATEWAY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006926249)
 - [AI 函数服务监控](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006672405)
 - [DBA_OB_AI_GATEWAY_ENDPOINTS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006926256)

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