# CREATE CONVERSION ## Name CREATE CONVERSION?--?定義一個新的編碼轉換 ## Synopsis ``` CREATE [ DEFAULT ] CONVERSION _name_ FOR _source_encoding_ TO _dest_encoding_ FROM _function_name_ ``` ## 描述 `CREATE CONVERSION`定義字符集之間的轉換。 標記為`DEFAULT`的轉換可以用于在前端和后端之間的自動編碼轉換。 出于這個原因，一般的轉換如從編碼 A 到 B_和_從編碼B到A，必須定義兩種轉換。 為了可以創建轉換，你必須有函數的`EXECUTE`權限并且在目標模式上有`CREATE`權限。 ## 參數 `DEFAULT` `DEFAULT`選項表示這種轉換是從這種源編碼到目標編碼的缺省轉換。 同一個模式里每一對編碼應該只有一個缺省編碼轉換。 `_name_` 轉換的名字。轉換名可以用模式修飾。如果沒有，那么轉換就在當前模式中定義。 轉換名在一個模式里必須唯一。 `_source_encoding_` 源編碼名。 `_dest_encoding_` 目標編碼名 。 `_function_name_` 用于執行轉換的函數。這個函數名可以用模式名修飾。如果沒有，那么將從路徑中找出這個函數。 此函數必須有如下的樣子： ``` conv_proc( integer, -- source encoding ID integer, -- destination encoding ID cstring, -- source string (null terminated C string) internal, -- destination (fill with a null terminated C string) integer -- source string length ) RETURNS void; ``` ## 注意 用`DROP CONVERSION`刪除用戶定義的轉換。 創建轉換所需要的權限可能在未來的版本中改變。 ## 例子 用`myfunc`創建一個從`UTF8`編碼到`LATIN1`編碼的轉換： ``` CREATE CONVERSION myconv FOR 'UTF8' TO 'LATIN1' FROM myfunc; ``` ## 兼容性 `CREATE CONVERSION`是PostgreSQL的擴展。 在SQL標準里沒有`CREATE CONVERSION`語句。 但有一個在語法和意義上都很相似的`CREATE TRANSLATION`語句。 ## 參見 [ALTER CONVERSION](#calibre_link-816), [CREATE FUNCTION](#calibre_link-4), [DROP CONVERSION](#calibre_link-557)