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

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>