| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
ecpg는 C프로그램용의 매입 SQL 프리프로세서입니다. 특별한 기능 호출과 SQL호출의 대체성에 의해 매입 SQL 명령문을 포함한 C 프로그램을 통상의 C 코드로 변환합니다. 그 출력 파일은 어떠한 C 컴파일러 툴을 사용해도 처리 할 수가 있습니다.
ecpg는 명령줄로 지정되는 각각의 입력 파일을 C의 출력파일로 변환할 것입니다. 입력파일은 .pgc라고 하는 확장자를 붙여 두면, 결정된 출력 파일명의 확장자가 . c로 옮겨지므로 편리합니다. 만약, 입력파일의 확장자가 .pgc이 아닌 경우, 그리고 그 파일의 풀네임의 말미에. c를 추가한 것이 출력 파일명이 됩니다. 출력 파일명은 또한 -o 옵션에 의해 덮어쓰기 할 수도 있습니다.
이 참조 페이지에서는 매입 SQL 언어에 대해서는 설명하지 않습니다. 더 필요한 정보를 원하시면 Chapter 31(을)를 참조해 주세요.
ecpg는 명령라인 매개변수를 받아들입니다.
SQL 코드로부터 유효한 C코드를 자동적으로 생성합니다. 현재, 이 옵션은EXEC SQL TYPE에 대해서 사용할 수 있습니다.
호환 모드를 설정합니다. mode 는INFORMIX혹은INFORMIX_SE의 어느 쪽인지를 취할 수가 있습니다.
C프리프로세서의 심볼을 정의합니다.
분석 시스템은 게다가 파일을 포함하고 있습니다.
추가의 인클루드용 패스를 지정하는데 이것은 EXEC SQL INCLUDE를 사용해 인클루드 되는 파일을 검색할 때에 사용됩니다. 기본값에는 . (현행 디렉토리),/usr/local/include, 컴파일시에 정의되는PostgreSQL의 인크루트 디렉토리(기본값에서는/usr/local/pgsql/include),/usr/include입니다.
ecpg가, 모든 출력을 filename 에 기입하는 것을 지정합니다.
실행시의 동작을 선택합니다. 현시점에서는 option 는 no_indicator만을 취할 수가 있습니다.
트랜잭션(transaction)의 오토커밋을 유효하게 합니다. 이 모드에서는, 각 SQL 명령은 명시적인 트랜잭션(transaction) 블록의 내부에 없는 한, 자동적으로 커밋됩니다. 기본값 모드에서는 EXEC SQL COMMIT가 발행되었을 때에게만 명령이 커밋됩니다.
버젼이나 인클루드용 패스등의 보충 정보를 표시합니다.
명령의 사용법에 대한 간단한 설명을 표시하고 종료합니다.
버젼 정보를 출력하고 종료합니다.
사전 처리 된 C코드 파일을 컴파일 할 때, 컴파일러는PostgreSQL의 인클루드 디렉토리내에 있는ECPG헤더 파일을 검색 가능하지 않으면 안됩니다. 그 때문에, 컴파일러의 호출시에,-I옵션을 사용해야 하는 가능성이 있습니다(예：-I/usr/local/pgsql/include).
SQL가 매입된 C 프로그램에는 libecpg 라이브러리에 대응되는 링크를 해야한다. -L/usr/local/pgsql/lib -lecpg 옵션을 사용하는 것을 예로 들 수 있다.
사용하시는 시스템에 대해, 상기의 2개에 대응하는 디렉토리를 조사하려면,pg_config를 사용합니다.