Provided by: manpages-zh_1.5-1_all bug

NAME

       CREATE TYPE - 定義一虓s的數據類型

SYNOPSIS

       CREATE TYPE name AS
           ( attribute_name data_type [, ... ] )

       CREATE TYPE name (
           INPUT = input_function,
           OUTPUT = output_function
           [ , RECEIVE = receive_function ]
           [ , SEND = send_function ]
           [ , INTERNALLENGTH = { internallength | VARIABLE } ]
           [ , PASSEDBYVALUE ]
           [ , ALIGNMENT = alignment ]
           [ , STORAGE = storage ]
           [ , DEFAULT = default ]
           [ , ELEMENT = element ]
           [ , DELIMITER = delimiter ]
       )

DESCRIPTIONyz
       CREATE              TYPE              為當前數據庫注冊一虓s的數據類型。
       定義該類型的使用者成為其所有者。

        如果給出模式名,那麼該類型是在指定模式中創建。
       否則它是在當前模式中創建。類型名必需和同一模式中任何現有的類型或者域不同。
       (因為表和數據類型有聯系,類型名不能和同模式中的表名字沖突。)

   COMPOSITE TYPESX型
        第一種形式的          CREATE          TYPE           創建一荋_合類型。
       復合類型是通過一列屬性名和數據類型聲明的。這樣實際上和一-
       茠磲漲磌型一樣,  但是如果我怚u是想定義一蚚型,那麼使用  CREATE  TYPE
       避免了直接創建實際的表。                       一蚇W立的復合類型對於一-
       茖蝻漯藀^類型非常有用。

   BASE TYPES型
        第二種形式的CREATE              TYPE創建一種新的基本類型(標量類型)。
       參數可以以任意的順序出現,而不是上掬膆靰漕獐芊C並且大多數都是可選的。
       它n求n在定義類型之前先注冊兩茖蝻]用CREATE  FUNCTION命令)。  支持函數
       input_function 和 output_function 是必須的, 而函數 receive_function 和
       send_function 是可選的。 通常,這些函數必須用 C 或者其它低層語言編寫。

        函數                                                    input_function
       將該類型的外部文本形式轉換成可以被對該類型操作的操作符和函數識別的內部形式。
       output_function      用做相反用途。     輸入函數可以聲明為接受一蚚型為
       c_string  的參數,或者接受三蚚型分別為 c_string,oid,integer 的參數。
       (第一荌捊O                C                字串形式的輸入文本,第二-
       茯O在該類型為數組類型時其元素的類型,                             第三-
       茯O目標字段的typmod,如果已知的話。) 它應該返回一虒蚍矞型本赤獐。
       輸出函數可以聲明為接受一蚚型為新數據類型的參數,           或者接受兩-
       蚚型,第二荌捊疑型是                  oid。                   第二-
       荌捊]是用於數組類型的數組元素類型。輸出函數應該返回類型 cstring。

        可選的                                                receive_function
       把該類型的外部二進制表現形式轉換成內部表現形式。        如果沒有提供這-
       茖蝻A那麼該類型不能用二進制輸入。二進制格式應該選取那種轉換成內部格式比較容易的,同時還有一定移植性的。
       (比如,標準的整數數據類型使用網路字節序作為外部的二進制表現形式,而內部表現形式是機器的本機字節序。)
       接收函數應該聲明為接受一蚚型為    internal   的參數,或者兩蚚型分別為
       internal   和   oid   的參數。   它必須返回一蚍矞型自赤獐。(第一-
       荌捊O一茷向一      StringInfo      緩沖區的,保存接受字節串的指針;
       可選的第二荌捊O元素類型──如果類型是一-
       蚍桼型的話。)類似的,可選的                           send_function
       把類型轉換為外部二進制表現形式。
       如果沒有提供這些函數,那麼類型就不能用二進制方式輸出。發送函數可以聲明為接收一-
       虓s數據類型,       或者接收兩荌捊A第二荌捊疑型是       oid。第二-
       荌捊斯M是用做數組類型的。 發送函數必須返回 bytea。

        這荇-
       唭A應該覺得奇怪,就是輸入和輸出函數怎麼可以聲明為返回新類型的結果或者是接受新類型的參數,
       而且是在新類型創建之前就需n創建它怴C
       答案是輸入函數必須先創建,然後是輸出函數,最後是數據類型。   PostgreSQL
       將漸把新數據類型的名字看作輸入函數的返回類型。             它將創建一-
       "殼"類型,這蚚型只是在 pg_type裏悸漱@茼位符,然後把輸入函數定義和這-
       荋葃型連接起來。
       類似的是輸出函數將連接到(現在已經存在)的殼類型。最後,  CREATE   TYPE
       把這荋葃型替換成完整的類型定義,這樣就可以使用新類型了。

        儘管新類型的內部表現形式只有                                       I/O
       函數和其它你創建來使用該類型的函數了解,  但內部表現還是有幾蚅搣吤眸楓
       PostgreSQL         聲明。        這些中最南的是        internallength。
       基本數據類型可定義成為定長,這時         internallength           是一-
       茈蕪蒱A也可以是變長的,通過把    internallength     設置為   VARIABLE
       表示。(在內部,這茠牯A             是通過將typlen設置為             -1
       實現的。)所有變長類型的內部形式都必須以一茈|字節整數開頭,這-
       蚞蒱馴X此類型這蚍的全長。

        可選的標記         PASSEDBYVALUE          表明該類型的數O用憚滿A
       而不是用引用。你不能傳遞那些內部形式大於   Datum   (大多數機器上是   4
       字節,有些是 8 字節)類型的尺寸的數據類型的C

       alignment   參數聲明該數據類型n求的對齊存儲方式。   允許的數幼藺颿鷊
       1,2,4,或者  8  字節邊界對齊。請注意變長類型必須有至少 4 字節的對齊,
       因為它怚眸極]含一 int4 作為它怐熔臚@茼言驉C

       storage    參數允許為變長數據類型選擇存儲策略。    (定長類型只允許使用
       plain)。   plain  聲明該數據類型總是用內聯的方式而不是壓縮的方式存儲。
       extended                              聲明系統將漸試圖壓縮一茠曭獐-
       A然後如果它仍然太長的話就將它的墨X主表的行,   但系統將不會壓縮它。
       main                              允許壓縮,但是不讚成把數劓吤X主表。
       (用這種存儲策略的數據項可能仍將移動出主表,如果不能放在一行裏的話,
       但是它戔N比 extended 和 external 項更願意呆在主表裏。)

        如果使用者希望字段的數據類型預設時不是        NULL,而是其它什麼東西,
       那麼你可以聲明一蚢w設C      在      DEFAULT      關鍵字裏掄n明預設C
       (這樣的預設可以被附著在特定字段上的明確的 DEFAULT 子句覆蓋。)

        n表示一蚚型是數組,用  ELEMENT   關鍵字聲明數組元素的類型。   比如,-
       n定義一 4 字節整數(int4)的數組,聲明

       ELEMENT = int4

       。 有關數組類型的更多細節在下探yz。

        n聲明用於這種類型數組的外部形式的數孜〞漱戴j符,可用       delimiter
       聲明指定分隔符。預設的分隔符是逗號(,)。
       請注意分隔符是和數組元素類型相關聯,而不是數組類型本芋C

   ARRAY TYPES型
        在創建使用者定義數據類型的時唌APostgreSQL                  自動創建一-
       蚖P之關聯的數組類型,其名字由該基本類型的名字前綴一茪U劃線組成。
       分析器理解這茤R名傳統,並且把對類型為  foo[] 的字段的請求轉換成對類型為
       _foo                                                  的字段的請求。這-
       蚆籈t創建的數組類型是變長並且使用內建的輸入和輸出函數    array_in    和
       array_out。

        你很可能會問如果系統自動製作正確的數組類型,那為什麼有
       ELEMENT選項?使用                                               ELEMENT
       有用的唯一的場合是在你製作的定長類型碰巧在內部是一-
       茪@定數目相同事物的數組,                而你又想允許這               N
       茖咱i以通過腳標直接關聯,以及那些你準備把該類型當做整體進行的操作。
       比如,類型  name  就允許其構成  char  用這種方法關聯。  一茪G維的 point
       類型也可以允許其兩蚨c成浮點型按照類似 point[0] 和 point[1] 的方法關聯。
       請注意這茈\能只適用與那些內部形式是一茯萓P的定長域的序列的類型。    一-
       茈i以腳標化的變長類型必須有被       array_in        和        array_out
       使用的一般化的內部表現形式。                                  出於歷史-
       鴞](也就是說,那些明顯錯誤但補救來得太遲的問題),定長數組類型的腳標從零開始,而不是像變長類型那樣的從一開始。

PARAMETERS數
       name    將n創建的類型名(可以有模式袡╮^。

       attribute_name
               復合類型的一蚅搣吽]字段)的名字。

       data_type
               一胻成為一荋_合類型的字段的現有數據類型的名字。

       input_function
               一茖蝻漲W稱, 將數據從外部類型轉換成內部類型。

       output_function
               一茖蝻漲W稱, 將數據從內部格式轉換成適於顯示的形式。

       receive_function
               把數據從類型的外部二進制形式轉換成其內部形式的函數的名字。

       send_function
               把數據從類型的內部形式轉換成其外部二進制形式的函數名。

       internallength
               一蚍-
              `量,說明新類型的內部表現形式的長度。預設的假設是它是變長的。

       alignment
               該數據類型的存儲對齊n求。如果聲明了,必須是 char, int2,  int4
              或 double; 預設是 int4。

       storage
               該數據類型的存儲策略。如果聲明了,必須是      plain,external,
              extended,或 main; 預設是 plain。

       default
               該類型的預設C通常是省略它的,所以預設是 NULL。

       element
               被創建的類型是數組;這蚆n明數組元素的類型。

       delimiter
               將用做數組的數據元素之間分隔符的字符。

NOTES`N
        使用者定義類型名不能以下劃線(_)          開頭而且只能有           62
       茼r符長。(或者通常是     NAMEDATALEN-2,    而不是其它名字那樣的可以有
       NAMEDATALEN-1                                                 茼r符)。
       以下劃線開頭的類型名被解析成內部創建的數組類型名。

        在    PostgreSQL    版本   7.3   以前,我帔通過使用佔位偽類型   opaque
       代替函數的前向引用來避免創建殼類型。 7.3 之前 cstring 參數和結果同樣需-
       n聲明偽   opaque。  n支持裝載舊的轉儲外那間,CREATE  TYPE  將接受那些用
       opaque聲明的函數, 但是它回發出一條通知並且用正確的類型改變函數的聲明。

EXAMPLESl
        這茖狺l創建一荋_合類型並且在一茖蝻w義中使用它:

       CREATE TYPE compfoo AS (f1 int, f2 text);
       CREATE FUNCTION getfoo() RETURNS SETOF compfoo AS
         'SELECT fooid, fooname FROM foo' LANGUAGE SQL;

        這茤R令創建box數據類型,並且將這種類型用於一茠磼w義:

       CREATE TYPE box (
           INTERNALLENGTH = 16,
           INPUT = my_box_in_function,
           OUTPUT = my_box_out_function
       );

       CREATE TABLE myboxes (
           id integer,
           description box
       );

        如果 box 的內部結構是一茈| float4 的數組,我怚i以說

       CREATE TYPE box (
           INTERNALLENGTH = 16,
           INPUT = my_box_in_function,
           OUTPUT = my_box_out_function,
           ELEMENT = float4
       );

        它允許一 box 的數角嬰叔可以用腳標訪問。 否則該類型和前悸漲甈陘@樣。

        這條命令創建一茪j對象類型並將其用於一茠磼w義:

       CREATE TYPE bigobj (
           INPUT = lo_filein, OUTPUT = lo_fileout,
           INTERNALLENGTH = VARIABLE
       );
       CREATE TABLE big_objs (
           id integer,
           obj bigobj
       );

        更多的例子,包括合適的輸入和輸出函數,在 Chapter  31``Extending  SQL''
       in the documentation。

COMPATIBILITYe性
       CREATE  TYPE  命令是  PostgreSQL  擴展。在  SQL99  裏有一  CREATE TYPE
       語句,但是細節上和 PostgreSQL 的有比較大區別。

SEE ALSO見
       CREATE FUNCTION [create_function(7)], DROP TYPE [drop_type(l)]

者
       Postgresql  <laser@pgsqldb.org>