CREATE TRANSFORM — 定义一个新的转换
CREATE [ OR REPLACE ] TRANSFORM FORtype_name
LANGUAGElang_name
( FROM SQL WITH FUNCTIONfrom_sql_function_name
[ (argument_type
[, ...]) ], TO SQL WITH FUNCTIONto_sql_function_name
[ (argument_type
[, ...]) ] );
CREATE TRANSFORM
定义一种新的转换。
CREATE OR REPLACE TRANSFORM
将
创建一种新的转换或者替换现有的定义。
一种转换指定了两个函数:
一个“from SQL”函数负责将类型从 SQL 环境转换到语言。 这个函数将在该语言编写的一个函数的参数上调用。
一个“to SQL”函数负责将类型从语言转换到 SQL 环境。这 个函数将在该语言编写的一个函数的返回值上调用。
没有必要同时提供这些函数。如果有一种没有被指定,将在必要时使用与语言相 关的默认行为(为了完全阻止在一个方向上发生转换,你也可以写一个总是报错 的转换函数)。
要创建一种转换,你必须拥有该类型并且具有该类型上的
USAGE
特权,拥有该语言上的
USAGE
特权,并且拥有 from-SQL 和 to-SQL 函数(如果
指定了)及其上的EXECUTE
特权。
type_name
该转换的数据类型的名称。
lang_name
该转换的语言的名称。
from_sql_function_name
[(argument_type
[, ...])]
将该类型从 SQL 环境转换到该语言的函数名。它必须接受一个
internal
类型的参数并且返回类型internal
。
实参将是该转换所适用的类型,并且该函数也应该被写成认为它是那种类型(
但是不允许声明一个返回internal
但没有至少一个
internal
类型参数的 SQL 层函数)。实际的返回值将与
语言的实现相关。如果没有指定参数列表,则函数名在该模式中必须唯一。
to_sql_function_name
[(argument_type
[, ...])]
将该类型从语言转换到 SQL 环境的函数名。它必须接受一个
internal
类型的参数并且返回该转换所适用的类型。实参值
将与语言的实现相关。如果没有指定参数列表,则函数名在该模式中必须唯一。
使用DROP TRANSFORM
移除转换。
这种形式的CREATE TRANSFORM
是一种
LightDB扩展。在
SQL标准中有一个CREATE
TRANSFORM
命令,但是它是用于把数据类型适配到
客户端语言。该用法不受
LightDB支持。