---
title: "使用 AI_EMBED 函数 - OceanBase Database AI V4.6.2 | OceanBase 文档中心"
description: 使用 AI_EMBED 函数 本文档介绍如何使用 AI 函数服务中的 AI_EMBED 函数在 OceanBase Database AI 中将文本生成向量嵌入。 概述 注意 AI_EMBED 函数目前仅支持文本数据生成向量嵌入。 注意 混合搜索（Hybrid Search）依赖 AI 模型管理和 AI_EMBED …
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*inJjSpyNOjUAAAAAHtAAAAgAeiGDAQ/original) OceanBase Database AIV 4.6.2

# 使用 AI_EMBED 函数

更新时间：2026-08-18 14:13:05

[编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.2/zh-CN/350.data-processing/200.unstructured-data-processing/100.vector-embedding/200.ai-embed-function.md)  

本文档介绍如何使用 AI 函数服务中的 `AI_EMBED` 函数在 OceanBase Database AI 中将文本生成向量嵌入。

## 概述

#### 注意

AI_EMBED 函数目前仅支持文本数据生成向量嵌入。

#### 注意

混合搜索（Hybrid Search）依赖 AI 模型管理和 AI_EMBED 函数功能。在删除 AI 模型时，需检查其是否被混合搜索引用，以避免潜在问题。

OceanBase Database AI 支持使用 AI 函数服务中的 `AI_EMBED` 函数生成向量嵌入。用户无需安装任何依赖，只需注册好模型信息，即可在 OceanBase Database AI 中使用 AI 函数服务生成向量嵌入。

`AI_EMBED` 函数通过 `model_key` 指定一个已注册的嵌入模型（Embedding Model），将用户提供的文本数据转换为向量数据。当模型支持多个维度时，允许通过 `dim` 参数指定输出相关维度的向量。

## 前提条件

### 权限授予

在使用 `AI_EMBED` 函数等 AI 函数服务之前，需要确保你已拥有相关权限。详细权限请参见 [AI 函数调用权限](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006779279)。

### 模型注册

在使用 `AI_EMBED` 函数之前，需要确保你已使用系统包 `DBMS_AI_SERVICE` 中的子程序注册好模型信息。以下是注册示例：

```sql
CALL DBMS_AI_SERVICE.DROP_AI_MODEL ('ob_embed');
CALL DBMS_AI_SERVICE.DROP_AI_MODEL_ENDPOINT ('ob_embed_endpoint');

CALL DBMS_AI_SERVICE.CREATE_AI_MODEL(
'ob_embed', '{
    "type": "dense_embedding",
    "model_name": "BAAI/bge-m3"
}');

CALL DBMS_AI_SERVICE.CREATE_AI_MODEL_ENDPOINT (
'ob_embed_endpoint', '{
    "ai_model_name": "ob_embed",
    "url": "https://api.siliconflow.cn/v1/embeddings",
    -- 需替换为实际的 access_key
    "access_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "provider": "siliconflow"
}');

```

支持的所有模型供应商，及其对应的 URL 具体信息请参见 [CREATE_AI_MODEL_ENDPOINT](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006780717)。

## 语法

```sql
AI_EMBED(model_key, input, [dim])

```

参数说明：

| 参数 | 描述 | 类型 | 是否可空 |
| --- | --- | --- | --- |
| model_key | 数据库内注册的模型。 | VARCHAR(128) | No |
| input | 用户输入的希望转换的文本数据。 | VARCHAR | No |
| dim | 指定输出相关维度的向量。部分大模型厂商提供的 API，支持配置多个维度。 | INT64 | Yes |

必须指定 `model_key`、`input`，并且其中一个为 `NULL` 时，函数提示报错。

返回值说明如下：

- vector 格式的字符串，嵌入模型根据文本转换的向量。

## 示例

### 嵌入单行数据

```sql
SELECT AI_EMBED("ob_embed","Hello world") AS embedding;

```

返回结果如下：

```sql
+----------------+
| embedding      |
+----------------+
| [0.1, 0.2, 0.3]|
+----------------+

```

### 嵌入表上列

```sql
CREATE TABLE comments (
    id INT AUTO_INCREMENT PRIMARY KEY,
    content TEXT
);

INSERT INTO comments (content) VALUES ('hello world!');

SELECT AI_EMBED("ob_embed",content) AS embedding FROM comments;

```

返回结果如下：

```

## 相关文档

- [向量嵌入技术概述](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006779275)
 - [外部嵌入模型使用指南](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006779277)
 - [AI 函数概述](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006779282)
 - AI 函数调用权限

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