---
title: "URL_ENCODE - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: URL_ENCODE 描述 该函数用于将字符串中的非 ASCII 字符进行 URL 编码，以转为纯 ASCII 字符。将 expr 中非字母数字字符转换为 % 后跟两位十六进制数的形式。 说明 对于 OceanBase 数据库 V4.3.5 版本，该函数从 V4.3.5 BP1 版本开始支持。 注意事项 该函数当前仅…
---
切换语言

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

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

# URL_ENCODE

更新时间：2026-07-15 20:42:45

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/400.functions-of-mysql-mode/200.single-row-functions-of-mysql-mode/200.string-functions-of-mysql-mode/9170.url_encode-of-mysql-mode.md)  

## 描述

该函数用于将字符串中的非 ASCII 字符进行 URL 编码，以转为纯 ASCII 字符。将 `expr` 中非字母数字字符转换为 `%` 后跟两位十六进制数的形式。

#### 说明

对于 OceanBase 数据库 V4.3.5 版本，该函数从 V4.3.5 BP1 版本开始支持。

## 注意事项

- 该函数当前仅支持字符序 `utf8`。
 - 当输入是 string 类型时，输出 Collation 保持与输入一致。当不是 string 类型时，输出当前 Session 默认的Collation。

## 语法声明

```sql
URL_ENCODE(expr)

```

## 参数解释

`expr`：需要进行 URL 编码的字符串。

## 返回类型

- 返回一个经过 URL 编码的字符串（`VARCHAR` 类型）。
 - `expr` 值为 `NULL` 时，返回 `NULL`。

## 示例

```sql
SELECT URL_ENCODE('https://example.com/path?name=John Doe&age=25'), URL_ENCODE(NULL);

```

返回结果如下：

```shell
+-----------------------------------------------------------------+------------------+
| URL_ENCODE('https://example.com/path?name=John Doe&age=25')     | URL_ENCODE(NULL) |
+-----------------------------------------------------------------+------------------+
| https%3A%2F%2Fexample.com%2Fpath%3Fname%3DJohn%20Doe%26age%3D25 | NULL             |
+-----------------------------------------------------------------+------------------+
1 row in set

```

## 相关文档

[URL_DECODE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002502827)

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