| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 31. ECPG - C언어에 의한 매입SQL | Fast Forward | Next |
여기까지, 매입 SQL C프로그램의 작성 방법은 이해할 수 있었다고 생각합니다. 여기부터는 그 컴파일 방법에 대해 이야기합니다. 컴파일의 전에, 그 파일을 매입SQL C에 통합니다. 이것은, 사용하는 SQL문을 특별한 함수 호출로 변환합니다. 컴파일 후, 필요한 함수를 가지는 특별한 라이브러리와 링크하지 않으면 안됩니다. 이러한 함수는 인자로부터 정보를 꺼내, libpq를 사용해 그 SQL를 실행해, 출력용으로 지정된 인자에 그 결과를 저장합니다.
프리프로세서 프로그램은 ecpg라는 이름으로, 통상 PostgreSQL의 설치에 포함되어 있습니다. 통상, 매입 SQL 프로그램의 확장자(extension)는 . pgc로 합니다. prog1.pgc라는 이름의 프로그램 파일이 있는 경우, 단순하게 이하를 호출하는 것으로 사전 처리를 실시할 수가 있습니다.
ecpg prog1.pgc
이것은 prog1.c라는 이름의 파일을 작성합니다. 입력 파일이 이 제안 패턴에 따른 이름이 아닌 경우, -o 옵션을 사용해 명시적으로 출력 파일을 지정할 수가 있습니다.
사전 처리 후의 파일은 보통으로 컴파일 할 수 있습니다. 이하에 예를 나타냅니다.
cc -c prog1.c
생성된 C 소스 파일은 PostgreSQLInstallation에 부수하는 헤더 파일을 포함합니다. 그러므로, 기본값으로 검색되지 않는 장소에 PostgreSQL를 설치했을 경우는, 컴파일용의 명령 라인에 -I/usr/local/pgsql/include와 같은 옵션을 추가해야 합니다.
매입 SQL 프로그램을 링크하기 위해서는, 이하와 같이, libecpg라이브러리를 포함해야 합니다.
cc -o myprog prog1.o prog2.o ... -lecpg
반복이 됩니다만, 명령 라인에 -L/usr/local/pgsql/lib라고 하는 옵션을 추가할 필요가 있을지도 모릅니다. -L/usr/local/pgsql/lib to that command line.
대규모 프로젝트의 구축 처리를 make를 사용해 관리하고 있는 경우, 이하의 암묵 규칙을 Makefile에 포함해 두면 편리합니다.
ECPG = ecpg
%.c: %.pgc
$(ECPG) $<
ecpg명령의 완전한 구문은 ecpg 에 설명이 있습니다.
configure의 --enable-thread-safety명령 라인 옵션을 사용해 구축했을 경우, ecpg라이브러리는 쓰레드 세이프입니다 (클라이언트 코드의 컴파일시에 다른 쓰레드 관련의 명령 라인 옵션을 사용할 필요가 있을지도 모릅니다).