---
title: "CREATE_AI_GATEWAY - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: CREATE_AI_GATEWAY CREATE_AI_GATEWAY 过程用于创建网关配置。网关用于管理多端点路由与权重；端点不携带 access_key ，凭证统一由厂商配置提供。 说明 本过程从 V4.6.0 BP1 开始支持。 语法 PROCEDURE create_ai_gateway( IN gatewa…
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

# CREATE_AI_GATEWAY

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

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/600.pl-reference/200.pl-mysql/1000.pl-system-package-mysql/1000.dbms-ai-service-mysql/1200.create-ai-gateway-mysql.md)  

`CREATE_AI_GATEWAY` 过程用于创建网关配置。网关用于管理多端点路由与权重；端点不携带 `access_key`，凭证统一由厂商配置提供。

#### 说明

本过程从 V4.6.0 BP1 开始支持。

## 语法

```sql
PROCEDURE create_ai_gateway(
    IN gateway_name VARCHAR(256),
    IN json_params JSON);

```

## 参数说明

| 参数 | 描述 | 类型 | 取值范围 | 是否可为 NULL |
| --- | --- | --- | --- | --- |
| gateway_name | 网关名称。 | VARCHAR(256) | 最大 256 字节 | NO |
| json_params | 网关配置，必须为 JSON 对象。 | JSON | 见下表 | NO |

`json_params` 支持的顶层字段如下：

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `endpoints` | JSON ARRAY | 是 | 路由列表。每项为 JSON 对象，须包含 `name`、`model`、`weight` 字段。`model` 为 `provider/model` 格式。 |
| `circuit_breaker` | JSON OBJECT | 否 | 熔断配置。 |

`circuit_breaker` 支持的字段如下：

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `failure_rate_threshold` | INT | 失败率阈值（百分比）。 |
| `window_size_seconds` | INT | 统计窗口大小（秒）。 |
| `minimum_requests` | INT | 触发熔断的最小请求数。 |
| `break_duration_seconds` | INT | 熔断持续时间（秒）。 |
| `probe_requests` | INT | 探活请求数。 |

## 示例

```sql
CALL DBMS_AI_SERVICE.CREATE_AI_GATEWAY('prod_gateway', '{
  "endpoints": [
    {"name":"ep1","model":"aliyun/qwen-plus","weight":70},
    {"name":"ep2","model":"deepseek/deepseek-chat","weight":30}
  ],
  "circuit_breaker": {
    "failure_rate_threshold": 50,
    "window_size_seconds": 60,
    "minimum_requests": 10,
    "break_duration_seconds": 60,
    "probe_requests": 3
  }
}');

```

## 相关文档

- [DBMS_AI_SERVICE 子程序概览](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005686366)
 - [AI 模型注册](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682098)

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