描述

CREATE CAST 定义一个新的转换。转换 指定如何执行两种数据类型之间的 转换。例如，

SELECT CAST(42 AS text);

通过调用一个先前指定的函数（这里是 text(int4)）把整数常量 42 转换为 text 类型。（如果没有定义合适的转换， 该转换失败。）

两种类型可以是二进制兼容的，这 意味着它们可以“免费”地互相 转换而无需调用任何函数。这要求 相应的值使用相同的内部表示。例如， text 和 varchar 类型是 二进制兼容的。

默认情况下，一个转换只能在显式转换请求中被调用， 也就是显式的 CAST(x AS typename)、 x::typename 或 typename(x) 构造。

如果转换被标记为 AS ASSIGNMENT，那么在向目标数据类型的列赋值时 它可以被隐式调用。 例如，假设 foo.f1 是一个 text 类型的列，那么

INSERT INTO foo (f1) VALUES (42);

只有在从 integer 类型到 text 类型的转换被标记为 AS ASSIGNMENT 时才 是允许的，否则 不允许。 （我们通常用赋值转换这个术语来描述这种转换。）

如果转换被标记为 AS IMPLICIT，那么它在任何上下文中都可以被 隐式调用，无论是赋值还是表达式内部。例如，由于 || 接受 text 操作数，

SELECT 'The time is ' || now();

只有在从 timestamp 到 text 的转换被标记为 AS IMPLICIT 时才 允许。否则就必须显式写出转换，例如

SELECT 'The time is ' || CAST(now() AS text);

（我们通常用隐式转换这个术语来描述这种转换。）

在把转换标记为隐式方面明智的做法是保守。过多的隐式 转换路径可能导致 PostgreSQL 对命令做出令人惊讶的 解释，或者因为存在多种可能的解释而完全 无法解析命令。一个好的 经验法则是在同一通用类型类别中的类型之间，只让 保持信息的转换可以隐式调用。例如，从 int2 到 int4 的转换可以合理地隐式，但从 float8 到 int4 的转换或许应该 只用于赋值。跨类型类别的转换，例如从 text 到 int4，最好只用于显式转换。

要能创建一个转换，你必须拥有源数据类型或目标 数据类型。要创建一个二进制兼容的转换，你必须 是超级用户。 （这个限制是因为一个错误的二进制兼容转换 很容易使服务器崩溃。）

参数

注意

使用 DROP CAST 删除用户定义的转换。

记住，如果你希望能够双向转换类型，需要 显式地在两个方向上声明转换。

在 PostgreSQL 7.3 之前，每个与某个数据类型同名、 返回该数据类型并且接受一个不同类型 参数的函数都自动是一个转换函数。 面对模式（schema）的引入以及为了能在系统目录中表示 二进制兼容的转换，这一约定已被 放弃。（内建的转换函数仍然遵循这一命名 方案，但现在它们必须作为转换显示在系统目录 pg_cast 中。）

示例

要用函数 int4(text) 创建一个从 text 类型到 int4 类型的转换：

CREATE CAST (text AS int4) WITH FUNCTION int4(text);

（这个转换已经在系统中预定义。）

兼容性

CREATE CAST 命令符合 SQL99，只是 SQL99 没有为二进制兼容类型作规定。 AS IMPLICIT 也是一种 PostgreSQL 扩展。

另见

CREATE FUNCTION, CREATE TYPE, DROP CAST