---
title: "TRANSLATE - OceanBase 数据库 V4.2.5 | OceanBase 文档中心"
description: TRANSLATE UTL_RAW.TRANSLATE 是一个字节级翻译函数，用于对 RAW 类型的数据进行逐字节的转换。 语法 UTL_RAW.TRANSLATE ( r IN RAW, from_set IN RAW, to_set IN RAW ) RETURN RAW; 参数解释 参数 解释 r 源字节串。 …
---
切换语言

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

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

# TRANSLATE

更新时间：2026-07-15 20:56:58

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/500.sql-reference/300.pl-reference/300.pl-oracle/1400.pl-system-package-oracle/27000.utl-raw-oracle/2200.translate-oracle.md)  

`UTL_RAW.TRANSLATE` 是一个字节级翻译函数，用于对 `RAW` 类型的数据进行逐字节的转换。

## 语法

```sql
UTL_RAW.TRANSLATE (
   r        IN RAW,
   from_set IN RAW,
   to_set   IN RAW  
) RETURN RAW;

```

## 参数解释

| **参数** | **解释** |
| --- | --- |
| r | 源字节串。 |
| from_set | 要查找和替换的字节集。 |
| to_set | 替换目标字节集。 |

## 使用说明

逐字节扫描源字节串 `r` 的值：

- 如果该值在 `from_set` 中，则用 `to_set` 中对应位置的字节替换。
 - 如果字节不在 `from_set` 中，则直接复制到结果中。
 - 如果 `from_set` 中的字节在 `to_set` 中没有对应项，则该字节被删除。
 - 如果 `from_set` 比 `to_set` 长，多余的 `from_set` 字节没有对应翻译，则匹配的字节被删除。
 - 如果 `to_set` 比 `from_set` 长，则多余的 `to_set` 字节被忽略。
 - 如果 `from_set` 中有重复字节，重复的字节将被忽略（同一个字节第二次在 `from_set` 出现则忽略其对应关系）。
 - 三个参数中有 `NULL` 值或者长度为 `0` 就报错 `ValueError`。
 - 字节串长度为奇数，在处理时最左边进行补 `0` 处理。

## 使用示例

执行如下命令，使用 `UTL_RAW.TRANSLATE` 函数，将输入字节序列中的特定字符全部替换为 `F`，其他字符保留原样。

```shell
obclient> SELECT UTL_RAW.TRANSLATE('1236567812125612344434341234567890ABAA1234','12AA34','FFFFFF') FROM dual;

```

返回结果如下：

```sql
+-----------------------------------------------------------------------------------+
| UTL_RAW.TRANSLATE('1236567812125612344434341234567890ABAA1234','12AA34','FFFFFF') |
+-----------------------------------------------------------------------------------+
| FF365678FFFF56FFFF44FFFFFFFF567890ABFFFFFF                                        |
+-----------------------------------------------------------------------------------+

```

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