---
title: "oceanbase.DBA_OB_AI_MODEL_ENDPOINTS - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: oceanbase.DBA_OB_AI_MODEL_ENDPOINTS 说明 该视图从 V4.4.1 版本开始引入。 功能描述 展示查询本租户模型访问信息。 字段说明 字段 类型 是否为 NULL 描述 ENDPOINT_ID int(20) NO 模型访问信息唯一 ID。 ENDPOINT_NAME varchar…
---
切换语言

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

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

# oceanbase.DBA_OB_AI_MODEL_ENDPOINTS

更新时间：2026-04-06 20:56:41

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

#### 说明

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

## 功能描述

展示查询本租户模型访问信息。

## 字段说明

| 字段 | 类型 | 是否为 NULL | 描述 |
| --- | --- | --- | --- |
| ENDPOINT_ID | int(20) | NO | 模型访问信息唯一 ID。 |
| ENDPOINT_NAME | varchar(128) | NO | 用户自定义的模型访问信息唯一名称。 |
| AI_MODEL_NAME | varchar(128) | NO | 访问信息所属的 AI 模型名称。 |
| SCOPE | varchar(128) | NO | 预留字段，默认为 `all`。未来可用于实现跨地域/可用区（region/zone）的模型访问信息配置。 |
| URL | varchar(2048) | NO | 模型的调用地址，URL 支持 HTTP、HTTPS。例如：`https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings`。 |
| ACCESS_KEY | varchar(2048) | NO | 模型调用时使用的 API Key。 |
| PROVIDER | varchar(128) | NO | AI 模型供应商，例如 `openai`、`aliyun`、`deepseek`、`ollama` 等。用于数据库内部 API 消息格式适配；若为空，需提供 UDF 函数，否则将报错。 |
| REQUEST_MODEL_NAME | varchar(128) | YES | 请求消息体中用户自定义的模型名称，例如 `bge-m3-custom`。 |
| PARAMETERS | varchar(2048) | YES | 预留字段，可选参数，用于配置模型调用的额外参数，例如 `context_window` 和 `max_output_tokens`，以支持批量操作。示例：`{"context_window": 128000,"max_output_tokens": 8000}`。 |
| REQUEST_TRANSFORM_FN | varchar(64) | YES | 预留字段，用于构造发送给 AI 模型的请求数据。如果为空，系统将根据 `PROVIDER` 和模型类型（`embedding`/`rerank`/`completion`）使用默认的消息格式发送请求。 |
| RESPONSE_TRANSFORM_FN | varchar(64) | YES | 预留字段，用于解析 AI 模型返回的数据。如果为空，系统将根据 `PROVIDER` 和模型类型（`embedding`/`rerank`/`completion`）使用默认的回复格式进行处理。 |

## 查询示例

用户租户查询本租户的 AI 模型访问信息。

```shell
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_AI_MODEL_ENDPOINTS;

```

查询结果如下：

```shell
+-------------+--------------------+---------------+-------+-------------------+------------------------------------------------------------------+----------+--------------------+------------+----------------------+-----------------------+
| ENDPOINT_ID | ENDPOINT_NAME      | AI_MODEL_NAME | SCOPE | URL               | ACCESS_KEY                                                       | PROVIDER | REQUEST_MODEL_NAME | PARAMETERS | REQUEST_TRANSFORM_FN | RESPONSE_TRANSFORM_FN |
+-------------+--------------------+---------------+-------+-------------------+------------------------------------------------------------------+----------+--------------------+------------+----------------------+-----------------------+
|           1 | my_model_endpoint1 | my_ai_model_1 | ALL   | your ai model url | EAF8BD8998A38C94B9EA596257E8D05CE4B8309E7134F81A78CCB59D60C39846 | openai   | text-embedding-v2  | NULL       | NULL                 | NULL                  |
+-------------+--------------------+---------------+-------+-------------------+------------------------------------------------------------------+----------+--------------------+------------+----------------------+-----------------------+
1 row in set

```

## 相关文档

- [DBMS_AI_SERVICE 概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004479802)
 - [CDB_OB_AI_MODELS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004478208)

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