新建函数_云数据库 OceanBase 版(OceanBase)-阿里云帮助中心

功能项	说明
弹窗引导辅助菜单	通过弹窗引导辅助菜单，可添加、删除、上下移动参数。
单击表序号	单击表序号，选中整行，显示辅助菜单（删除、上/下移动）。单击并选中表序号，可拖动整行参数以调整顺序。
右键操作	拖动鼠标选中整行，右键单击鼠标，进行复制行 / 向下移动一行。选择单元格，右键单击鼠标，进行复制。

参数中需指定的模式指参数类型。

MySQL 模式下不支持设定参数模式，Oracle 模式下支持三种参数模式 IN（输入）、OUT（输出）、INOUT（输入输出）：

参数	类型
IN	输入参数，调用函数时将参数的值传入函数供执行函数时使用。
OUT	输出参数，调用函数时，函数会忽略输出参数本身的值并传入一个空值，在函数体中可以修改输出参数并将修改结果返回给输出参数所代表的实参。
INOUT	输入输出参数，即同时具备输入参数和输出参数的功能。

说明

Oracle 模式下函数和存储过程均包含 IN/OUT/INOUT 参数；MySQL 模式下只包含 IN 参数，而存储过程包含 IN/OUT/INOUT 参数。

步骤四：确认创建函数

单击确定，进入 SQL 创建确认页面。

步骤五：编辑函数语句

在 SQL 创建确认页面，编辑函数语句。

同时，在编辑页面的工具栏中提供了以下功能键：

功能	说明
格式化	单击该按钮对选中的 SQL 语句或当前 SQL 窗口中的所有 SQL 语句进行统一的格式化（缩进、换行和高亮关键字等操作）。
查找/替换	在查找框内输入内容以对脚本进行检索，查找后可在替换框内输入内容以对查找内容进行替换。
撤销	将脚本回退到上一步操作执行的结果。
重做	执行撤销操作后，对脚本重新执行撤销前的操作。
大小写	提供全部大写、全部小写和首字母大写三种效果，为脚本中选中的语句转换为对应形式。
缩进	提供添加缩进和删除缩进两种效果，为脚本中选中的语句添加或删除包含的缩进。
注释	提供添加注释和删除注释两种效果，将脚本中选中的语句转换为注释或转换为 SQL 语句。
IN 值转化	可以将如 A B 的格式转化为 ('A','B') 的格式。

用户可以在 SQL 创建确认页面编辑创建的函数语句。语法格式如下：

CREATE FUNCTION < 函数名 > ([ <参数1> <类型1> [ , <参数2> <类型2>] ] …) 
RETURNS < 类型 > 
< 函数主体 >

参数说明：

参数	说明
<函数名>	指定自定义函数的名称。重要自定义函数不能与存储过程具有相同的名称。
<参数><类型>	用于指定自定义函数的参数。该参数只有名称和类型，不能指定关键字 IN、OUT 和 INOUT。
RETURNS<类型>	用于声明自定义函数返回值的数据类型。其中，`<类型>`用于指定返回值的数据类型。重要在 RETURN VALUE 语句中包含 SELECT 语句时，SELECT 语句的返回结果只能是一行且只能有一列值。
<函数主体>	自定义函数的主体部分，亦称函数体。函数体必须包含一个 `RETURN<值>`语句，其中`<值>`用于指定自定义函数的返回值。

示例：

CREATE FUNCTION `function_emp` ( `id` int(45)) RETURNS VARCHAR(300) 

-- 函数体开始
BEGIN

-- 申明变量
DECLARE
  a VARCHAR(300);

-- 变量赋值
SELECT
  name INTO a
FROM
  employee
WHERE
  emp_no = id;

-- 返回值
RETURN a;

-- 函数体结束

END

步骤六：完成新建函数

单击创建，完成新建函数后，可以如同调用系统内置函数一样，使用关键字 SELECT调用用户自定义的函数。

说明

在左侧导航栏中，右键鼠标单击函数列表中的函数名，通过弹出的管理操作列表（包括查看、新建、编辑、编译、调试、运行、下载、删除和刷新），可快速管理和操作目标对象。

更多详情请参见新建函数和常用功能简介。

语法格式：

SELECT <函数名> ([<参数> [,...]])

示例：

SELECT function_emp(2);

MySQL 模式
Oracle 模式
重要
- Oracle 模式下如果包含 OUT 参数，则需通过 CALL方式调用。
- 函数列表中如果出现黄色图标，表示目前有错误或者警告。

概述

操作步骤

步骤一：输入函数名称

步骤二：选择函数返回值的数据类型

步骤三：添加参数

步骤四：确认创建函数

步骤五：编辑函数语句

步骤六：完成新建函数

相关信息