.\" auto-generated by docbook2man-spec $Revision: 1.1 $
.TH "CREATE CAST" "7" "2003-11-02" "SQL - Language Statements" "SQL Commands"
.SH NAME
CREATE CAST \- 定義一個使用者定義的轉換

.SH SYNOPSIS
.sp
.nf
CREATE CAST (\fIsourcetype\fR AS \fItargettype\fR)
    WITH FUNCTION \fIfuncname\fR (\fIargtype\fR)
    [ AS ASSIGNMENT | AS IMPLICIT ]

CREATE CAST (\fIsourcetype\fR AS \fItargettype\fR)
    WITHOUT FUNCTION
    [ AS ASSIGNMENT | AS IMPLICIT ]
.sp
.fi
.SH "DESCRIPTION 描述"
.PP
\fBCREATE CAST\fR 定義一個新的轉換。 一個轉換說明如何在兩個類型之間進行轉換。比如：
.sp
.nf
SELECT CAST(42 AS text);
.sp
.fi
通過調用前面聲明的一個函數，把整數常量 42 轉換成類型 text， 在這個例子裏是 text(int4)。（如果沒有預先定義好合適的轉換，那麼這個轉換失敗。）
.PP
兩種類型可以是二進制相容的， 意思是它們之間可以"自由轉換"而不用調用任何函數。 這就需要那個對應的數值使用同樣的內部表現形式。 比如，類型 text 和 varchar 是二進制相容的。
.PP
預設時，只有在明確要求轉換的情況下才調用一個轉換， 也就是一個明確的 CAST(x AS typename)， x::typename，或者 typename(x) 構造。
.PP
如果轉換標記為 AS ASSIGNMENT，那麼在賦一個數值給目標數據類型的字段的時候， 可以隱含調用它。比如，假設 foo.f1 是一個類型為 text 的字段，那麼
.sp
.nf
INSERT INTO foo (f1) VALUES (42);
.sp
.fi
如果從類型 integer 到類型 text 的轉換標記為 AS ASSIGNMENT， 上面的這句就被允許，否則就不允許。（我們通常用術語賦值轉換來描述這種轉換。）
.PP
如果轉換標記為 AS IMPLICIT，那麼它就可以在任何環境裏調用， 不管是賦值還是在表達式的內部。比如，因為 || 接受 text 操作數，
.sp
.nf
SELECT 'The time is ' || now();
.sp
.fi
將只有在類型 timestamp 到 text 的轉換標記為 AS IMPLICIT 的時候才允許。否則我們就必須明確書寫轉換， 比如
.sp
.nf
SELECT 'The time is ' || CAST(now() AS text);
.sp
.fi
（我們通常使用術語隱含轉換來描述這種類型的轉換。）
.PP
在標記轉換為隱含的這個問題上保守一些是明智的。 過於豐富的隱含轉換路徑會導致 PostgreSQL 選擇讓人奇怪的命令的解析， 或者是完全不能解析命令，因為存在多個可能的解析。 一條好的拇指定律是，只有在同一個通用類型表裏面的那些可以保留轉換信息的類型之間才標記為可隱含調用轉換。 比如，從 int2 到 int4  可以合理地標記為隱含轉換，但是從 float8 到 int4  可能應該是標記為賦值轉換。跨類型表的轉換，比如 text 到 int4，最好是只能明確地轉換。
.PP
要想創建一個轉換，你必須擁有源或者目的數據類型。要創建一個二進制相容的轉換， 你必須是超級使用者。（做這個限制是因為一種有問題的二進制相容轉換可以很容易摧毀伺服器。）
.SH "PARAMETERS 參數"
.TP
\fB\fIsourcetype\fB\fR
轉換的源數據類型。
.TP
\fB\fItargettype\fB\fR
轉換的目標數據類型。
.TP
\fB\fIfuncname\fB(\fIargtype\fB)\fR
用於執行轉換的函數。這個函數名可以是用模式名修飾的。 如果它沒有用模式名修飾，那麼該函數將從路徑中找出來。 參數類型必須和源數據類型相同，結果數據類型必須匹配轉換的目標類型。
.TP
\fBWITHOUT FUNCTION\fR
表示源數據類型和目標數據類型是二進制相容的， 所以不需要什麼函數來執行轉換。 
.TP
\fBAS ASSIGNMENT\fR
表示轉換可以在賦值環境裏隱含調用。
.TP
\fBAS IMPLICIT\fR
表示這個轉換可以在任何環境裏隱含調用。
.SH "NOTES 注意"
.PP
用 DROP CAST 刪除使用者定義的轉換。
.PP
請注意，如果你想能雙向轉換類型，那麼你需要明確地定義兩個方向的轉換。
.PP
在 PostgreSQL 7.3 之前，如果一個函數的名字和一個數據類型相同， 並且返回該種數據類型，而且還接受另外一種類型的參數自動就是一個轉換函數。 這個傳統隨著模式的引入以及為了能在系統表種表示二進制相容的轉換就被廢棄了。 （內置的轉換函數仍然遵循這個命名規則，但是它們現在必須在系統表 pg_cast 裏顯示為轉換。）
.SH "EXAMPLES 例子"
.PP
要使用函數 int4(text) 創建一個從類型 text 到類型 int4的轉換：
.sp
.nf
CREATE CAST (text AS int4) WITH FUNCTION int4(text);
.sp
.fi
（這個轉換在系統中已經預先定義了。）
.SH "COMPATIBILITY 相容性"
.PP
\fBCREATE CAST\fR 命令遵循 SQL99，只不過 SQL99 沒有提供二進制相容類型。AS IMPLICIT 也是 PostgreSQL  的擴展。
.SH "SEE ALSO 參見"
.PP
CREATE FUNCTION [\fBcreate_function\fR(7)],
CREATE TYPE [\fBcreate_type\fR(7)],
DROP CAST [\fBdrop_cast\fR(7)]
.SH "譯者"
.B Postgresql 中文網站
.B 何偉平 <laser@pgsqldb.org>