| Postgresql 9.3.25 Tài liệu | ||||
|---|---|---|---|---|
| prev | UP | Chương 35. Mở kèo bóng đá phápSQL | NEXT | |
Nếu bạn đang nghĩ về việc phân phốiPostgreSQLMô -đun mở kèo bóng đá pháp, thiết lập một Hệ thống xây dựng di động cho họ có thể khá khó khăn. Vì thế ThePostgreSQLCài đặt Cung cấp cơ sở hạ tầng xây dựng cho các tiện ích mở kèo bóng đá pháp, được gọi làPGXS, vì vậy phần mở kèo bóng đá pháp đơn giản đó Các mô -đun có thể được xây dựng chỉ đơn giản là dựa trên máy chủ đã được cài đặt.PGXSchủ yếu là dành cho các tiện ích mở kèo bóng đá pháp bao gồm mã C, mặc dù nó có thể được sử dụng cho Phần mở kèo bóng đá pháp Pure-SQL quá. Lưu ý rằngPGXSkhông có ý định là một bản dựng phổ quát Khung hệ thống có thể được sử dụng để xây dựng bất kỳ phần mềm nào giao thoa ĐẾNPostgreSQL; nó chỉ đơn giản là tự động hóa Quy tắc xây dựng phổ biến cho các mô -đun mở kèo bóng đá pháp máy chủ đơn giản. Để biết thêm các gói phức tạp, bạn có thể cần phải viết bản dựng của riêng mình hệ thống.
Để sử dụngPGXSCơ sở hạ tầng cho phần mở kèo bóng đá pháp của bạn, bạn phải viết một đơn giản Makefile. Trong Makefile, bạn cần đặt một số biến và Cuối cùng bao gồm toàn cầuPGXSMakefile. Dưới đây là một ví dụ xây dựng một mô -đun mở kèo bóng đá pháp có tênisbn_issn, bao gồm một thư viện chia sẻ chứa một số mã C, tệp điều khiển mở kèo bóng đá pháp, tập lệnh SQL, và một tệp văn bản tài liệu:
Mô -đun = isbn_issn Tiện ích mở kèo bóng đá pháp = isbn_issn DATA = ISBN_ISSN--1.0.SQL Tài liệu = readme.isbn_issn Pg_config = pg_config Pgxs: = $ (shell $ (pg_config) -pgxs) Bao gồm $ (PGXS)
Ba dòng cuối cùng phải luôn giống nhau. Sớm hơn trong Tệp, bạn gán các biến hoặc thêm tùy chỉnhlàmquy tắc.
Đặt một trong ba biến này để chỉ định những gì được xây dựng:
Danh sách các đối tượng chia sẻ-thư viện được xây dựng từ các tệp nguồn Với cùng một thân (không bao gồm các hậu tố thư viện trong danh sách này)
Một thư viện được chia sẻ để xây dựng từ nhiều tệp nguồn (Danh sách Tệp đối tượng trongobjs)
Một chương trình thực thi để xây dựng (liệt kê các tệp đối tượng trongobjs)
Các biến sau đây cũng có thể được đặt:
Tên mở kèo bóng đá pháp (s); Đối với mỗi tên, bạn phải cung cấp mộtMở kèo bóng đá pháp.controlTệp, sẽ được cài đặt vàotiền tố/chia sẻ/mở kèo bóng đá pháp
Subdirectory củatiền tố/chia sẻtrong đó dữ liệu và tài liệu nào Các tệp sẽ được cài đặt (nếu không được đặt, mặc định làMở kèo bóng đá phápnếuMở kèo bóng đá phápIS Đặt hoặcĐóng gópnếu không)
Tệp ngẫu nhiên để cài đặt vàotiền tố/chia sẻ/$ moduledir
Tệp ngẫu nhiên để cài đặt vàotiền tố/chia sẻ/$ moduledir, cần phải được xây dựng đầu tiên
Tệp ngẫu nhiên để cài đặt dướitiền tố/chia sẻ/tsearch_data
Tệp ngẫu nhiên để cài đặt dướitiền tố/doc/$ moduledir
Tập tin tập lệnh (không phải nhị phân) để cài đặt vàotiền tố/bin
Tập tin tập lệnh (không phải nhị phân) để cài đặt vàotiền tố/bin, mà cần được xây dựng đầu tiên
Danh sách các trường hợp kiểm tra hồi quy (không có hậu tố), xem bên dưới
Chuyển đổi bổ sung để chuyển sangPG_ERESS
Các tệp bổ sung để xóa tronglàm sạch
sẽ được thêm vàocppflags
sẽ được thêm vàoChương trìnhLink Line
sẽ được thêm vàomodule_bigLiên kết đường kẻ
đường dẫn đếnpg_configChương trình cho ThePostgreSQLCài đặt vào xây dựng chống lại (thường chỉ làpg_configđến Sử dụng cái đầu tiên trong của bạnđường dẫn)
Đặt makefile này làMakefileTrong Thư mục giữ tiện ích mở kèo bóng đá pháp của bạn. Sau đó, bạn có thể làmlàmĐể biên dịch, và sau đóLàm cài đặtĐể cài đặt mô -đun của bạn. Theo mặc định, phần mở kèo bóng đá pháp là được biên dịch và cài đặt choPostgreSQLCài đặt tương ứng với đầu tiênpg_configChương trình được tìm thấy trong bạnđường dẫn. Bạn có thể sử dụng một bản cài đặt khác bằng cách cài đặtpg_configĐể trỏ đến nópg_configChương trình, trong Makefile hoặc trênlàmdòng lệnh.
| THẬN TRỌNG |
|
Thay đổipg_configChỉ hoạt động khi Xây dựng chống lạiPostgreSQL8.3 hoặc sau đó. Với các bản phát hành cũ hơn, nó không hoạt động để đặt nó thành bất cứ điều gì ngoại trừpg_config; bạn phải thay đổi của bạnđường dẫnĐể chọn cài đặt để xây dựng chống lại. |
Các tập lệnh được liệt kê trongThủy loạnBiến được sử dụng để kiểm tra hồi quy mô -đun của bạn, có thể Được viện dẫn bởiTạo cài đặtsau đang làmTạo cài đặt. Để điều này hoạt động bạn Phải có một lần chạyPostgreSQLMáy chủ. Các tệp tập lệnh được liệt kê trongThủy loạnphải xuất hiện trong một thư mục con có tênSQL/Trong thư mục tiện ích mở kèo bóng đá pháp của bạn. Những tệp này phải có phần mở kèo bóng đá pháp.sql, không được bao gồm trongThủy loạnDanh sách trong Makefile. Cho mỗi Kiểm tra cũng nên có một tệp chứa đầu ra dự kiến trong một thư mục con tênmong đợi/, với Cùng một thân và phần mở kèo bóng đá pháp.out. Tạo InstallcheckThực thi mỗi tập lệnh kiểm tra vớiPSQL, và so sánh kết quả đầu ra cho tệp dự kiến phù hợp. Bất kỳ sự khác biệt nào cũng sẽ được ghi vào tệpRepression.diffsindiff -cĐịnh dạng. Lưu ý rằng cố gắng chạy một Kiểm tra thiếu tệp dự kiến của nó sẽ được báo cáo là"Sự cố", vì vậy hãy chắc chắn rằng bạn có tất cả Các tệp dự kiến.
Tip:Cách dễ nhất để tạo các tệp dự kiến là Tạo các tệp trống, sau đó chạy thử (tất nhiên sẽ báo cáo sự khác biệt). Kiểm tra các tệp kết quả thực tế được tìm thấy trongKết quả/Thư mục, sau đó sao chép chúng vàomong đợi/Nếu chúng phù hợp với những gì bạn mong đợi từ bài kiểm tra.