更新时间:2024-06-03 GMT+08:00

CREATE CAST

功能描述

定义一个用户自定义的转换。

语法格式

  • 定义通过函数转换的CAST:
    CREATE CAST (source_type AS target_type)
        WITH FUNCTION function_name (argument_type [, ...])
        [ AS ASSIGNMENT | AS IMPLICIT ];
  • 定义不通过函数转换的CAST:
    CREATE CAST (source_type AS target_type)
        WITHOUT FUNCTION
        [ AS ASSIGNMENT | AS IMPLICIT ];
  • 定义通过I/O转换的CAST:
    CREATE CAST (source_type AS target_type)
        WITH INOUT
        [ AS ASSIGNMENT | AS IMPLICIT ];

参数说明

  • source_type

    转换的源数据类型。

  • target_type

    转换的目标数据类型。

  • function_name(argument_type [, ...])

    用于执行转换的函数。 这个函数名可以是用模式名修饰的。 如果它没有用模式名修饰, 那么该函数将从模式搜索路径中找出来。 函数的结果数据类型必须匹配转换的目标类型。 它的参数在下面讨论。

  • WITHOUT FUNCTION

    表明源类型是对目标类型是二进制可强制转换的,所以没有函数需要执行此转换。

  • WITH INOUT

    表明转换是I/O转换,通过调用源数据类型的输出函数来执行,并将结果传给目标数据类型的输入函数。

  • AS ASSIGNMENT

    表示转换可以在赋值模式下隐含调用。

  • AS IMPLICIT

    表示转换可以在任何环境里隐含调用。

    转换实现函数可以有一到三个参数。第一个参数的类型必须与转换的源类型相同的,或可以从转换的源类型二进制可强制转换的。第二个参数,如果存在,必须是integer类型;它接收这些与目标类型相关联的类型修饰符,或者若什么都没有则是-1。第三个参数,如果存在,必须是boolean类型;若转换是一个显式类型转换则会收到true,否则是false。

    一个转换函数的返回类型必须是与转换的目标类型相同或者对转换的目标类型二进制可强制转换。

    通常,一个转换必须有不同的源和目标数据类型。然而,若有多于一个参数的转换实现函数,则允许声明一个有相同的源和目标类型的转换。这用于表示系统目录中的特定类型的长度强制函数。命名的函数用于强制一个该类型的值为第二个参数给出的类型修饰符值。

    如果一个类型转换的源类型和目标类型不同,并且接收多于一个参数,它就表示从一种类型转换成另外一种类型只用一个步骤,并且同时实施长度转换。如果没有这样的项可用,那么转换成一个使用了类型修饰词的类型将涉及两个步骤,一个是在数据类型之间转换,另外一个是施加修饰词指定的转换。

    对域类型的转换目前没有作用。转换一般是针对域相关的所属数据类型。

    cast转换是以调用它的用户的权限来执行,高权限用户在调用其他用户创建的转换时,需要检查转换函数的执行内容,以免转换的创建者借用执行者的权限执行了越权的操作。

示例

为了从类型double precision到类型timestamp with time zone创建一个指派映射要通过使用函数double_to_timestamp(double precision):

--创建函数。
gaussdb=# CREATE OR REPLACE FUNCTION double_to_timestamp(double precision) RETURNS TIMESTAMP WITH TIME ZONE AS $$
SELECT to_timestamp($1);
$$ LANGUAGE SQL STRICT;

--创建类型转换。
gaussdb=# CREATE CAST(double precision AS timestamp with time zone) WITH FUNCTION double_to_timestamp(double precision) AS IMPLICIT;

--删除类型转换。
gaussdb=# DROP CAST (double precision AS timestamp with time zone);

兼容性

CREATE CAST指令符合SQL标准,除了SQL没有为二进制可强制转换类型或者实现函数的额外参数来实现功能。

相关链接

DROP CAST