PostgreSQL CREATE TRANSFORM

簡介

CREATE TRANSFORM定義一種新的轉(zhuǎn)換。 CREATE OR REPLACE TRANSFORM將 創(chuàng)建一種新的轉(zhuǎn)換或者替換現(xiàn)有的定義。

一種轉(zhuǎn)換指定了如何把一種數(shù)據(jù)類型適配到一種過程語言。例如，在用 PL/Python 編寫一個(gè)使用hstore類型的函數(shù)時(shí)，PL/Python 沒有關(guān)于如何在 Python 環(huán)境中表示hstore值的先驗(yàn)知識。 語言的實(shí)現(xiàn)通常默認(rèn)會使用文本表示，但是在一些時(shí)候這很不方便，例如 有時(shí)可能用一個(gè)聯(lián)合數(shù)組或者列表更合適。

一種轉(zhuǎn)換指定了兩個(gè)函數(shù)：

沒有必要同時(shí)提供這些函數(shù)。如果有一種沒有被指定，將在必要時(shí)使用與語言相 關(guān)的默認(rèn)行為（為了完全阻止在一個(gè)方向上發(fā)生轉(zhuǎn)換，你也可以寫一個(gè)總是報(bào)錯(cuò) 的轉(zhuǎn)換函數(shù)）。

要?jiǎng)?chuàng)建一種轉(zhuǎn)換，你必須擁有該類型并且具有該類型上的 USAGE特權(quán)，擁有該語言上的 USAGE特權(quán)，并且擁有 from-SQL 和 to-SQL 函數(shù)（如果 指定了）及其上的EXECUTE特權(quán)。

參數(shù)

注解

使用DROP TRANSFORM移除轉(zhuǎn)換。

示例

要為類型hstore和語言 plpythonu創(chuàng)建一種轉(zhuǎn)換，先搞定該類型和語言：

CREATE TYPE hstore ...;

CREATE EXTENSION plpythonu;

然后創(chuàng)建需要的函數(shù)：

CREATE FUNCTION hstore_to_plpython(val internal) RETURNS internal
LANGUAGE C STRICT IMMUTABLE
AS ...;

CREATE FUNCTION plpython_to_hstore(val internal) RETURNS hstore
LANGUAGE C STRICT IMMUTABLE
AS ...;

最后創(chuàng)建轉(zhuǎn)換把它們連接起來：

CREATE TRANSFORM FOR hstore LANGUAGE plpythonu (
    FROM SQL WITH FUNCTION hstore_to_plpython(internal),
    TO SQL WITH FUNCTION plpython_to_hstore(internal)
);

實(shí)際上，這些命令將被包裹在擴(kuò)展中。

contrib小節(jié)包含了一些提供轉(zhuǎn)換的擴(kuò)展， 它們可以作為實(shí)際的例子。

兼容性

這種形式的CREATE TRANSFORM是一種 PostgreSQL擴(kuò)展。在 SQL標(biāo)準(zhǔn)中有一個(gè)CREATE TRANSFORM命令，但是它是用于把數(shù)據(jù)類型適配到 客戶端語言。該用法不受 PostgreSQL支持。

另見

CREATE FUNCTION, CREATE LANGUAGE, CREATE TYPE , DROP TRANSFORM