ECPG(1)

NAME
ecpg - 嵌入的 SQL C 前處理器

SYNOPSIS

ecpg [ option... ] file...

DESCRIPTION 描述

ecpg 是一個嵌入的用於C 語言的 SQL 預編譯器。 它把嵌有 SQL 語句的 C 程式通過將 SQL 呼叫替換成特殊的函式呼叫的方法轉換成普通的 C 程式碼。 然後輸出的檔案就可以用任何 C 編譯工具進行處理。

clusterdb 將把命令列上給出的每個輸入檔案轉換成對應的 C 輸出檔案。 輸入檔案最好有 .pgc 的副檔名， 這樣，這個擴充套件將被替換成 .c 來決定輸出檔名。 如果輸入檔案的擴充套件不是 .pgc，那麼輸出檔名將通過在全檔名後面附加 .c 來生成。 輸出檔名也可以用 -o 選項覆蓋。

 本手冊頁並不描述嵌入的 SQL 語句，參閱 Chapter 29 獲更多資訊。

OPTIONS 選項

clusterdb 接受下列命令列引數：

-c
     為 SQL 程式碼自動生成某種 C 程式碼。目前，這個選項可以用於 EXEC SQL TYPE。

-C mode
     設定一個相容模式。mode 可以是 INFORMIX 或者 INFORMIX_SE。

-D symbol
     定義一個 C 預編譯器符號。

-i
     同時也分析系統包含檔案。

-I include-path
     宣告一個附加的包含路徑。用於尋找通過 EXEC SQL INCLUDE 包含的檔案。預設是 .（當前目錄）， /usr/local/include， 在編譯時定義的PostgreSQL 包含路徑（預設： /usr/local/pgsql/include）和 /usr/include。順序如上。

-o filename
     宣告ecpg應該把它的所有輸出寫到給出的 filename裡。

-t
     開啟自動提交模式。在這種模式象，每個查詢都自動提交， 除非它是包圍在一個明確的事務塊中。在預設模式下， 命令只是在發出 EXEC SQL COMMIT 的時候提交。

-v
     列印額外的資訊，包括版本和包含路徑。

--help
     顯示一個命令用法的簡單摘要，然後退出。

--version
     顯示版本資訊，然後退出。

NOTES 注意
 在編譯預處理的 C 程式碼檔案的時候，編譯器需要能夠找到 PostgreSQL 包含目錄裡面的 ECPG 標頭檔案。因此，我們在呼叫編譯器的時候可能需要使用 -I （比如，-I/usr/local/pgsql/include）。
 使用了嵌入 SQL 的 C 程式碼必須和 libecpg 庫連結，比如，使用這樣的連結選項： -L/usr/local/pgsql/lib -lecpg
 這些目錄的實際值可以通過 pg_config(1) 找到。

EXAMPLES 例子

 如果你有一個叫 prog1.pgc 的嵌入 SQL 的 C 原始碼，你可以用下面的命令序列建立一個可執行程式：

ecpg prog1.pgc
cc -I/usr/local/pgsql/include -c prog1.c
cc -o prog1 prog1.o -L/usr/local/pgsql/lib -lecpg

譯者
Postgresql 中文網站 何偉平 <laser@pgsqldb.org>

跋
本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh