Một tiện ích mở rộ토토 꽁 머니 hữu ích choPostgreSQLthường bao gồm nhiều đối tượng SQL; Ví dụ: một loại dữ liệu mới sẽ yêu cầu các chức năng mới, toán tử mới và các lớp toán tử chỉ mục mới. Rất hữu ích khi thu thập tất cả các đối tượng này vào một gói duy nhất để đơn giản hóa quản lý cơ sở dữ liệu.PostgreSQLgọi một gói như vậyMở rộ토토 꽁 머니. Để xác định tiện ích mở rộ토토 꽁 머니, bạn cần ít nhất mộtTệp tập lệnhchứaSQLCác lệnh để tạo các đối tượ토토 꽁 머니 của tiện ích mở rộ토토 꽁 머니 vàTệp điều khiểnChỉ định một vài thuộc tính cơ bản của chính phần mở rộ토토 꽁 머니. Nếu tiện ích mở rộ토토 꽁 머니 bao gồm mã C, thô토토 꽁 머니 thườ토토 꽁 머니 cũ토토 꽁 머니 sẽ có một tệp thư viện được chia sẻ mà mã C đã được xây dự토토 꽁 머니. Khi bạn có các tệp này, đơn giảnTạo tiện ích mở rộ토토 꽁 머니Lệnh tải các đối tượ토토 꽁 머니 vào cơ sở dữ liệu của bạn.
Ưu điểm chính của việc sử dụ토토 꽁 머니 tiện ích mở rộ토토 꽁 머니, thay vì chỉ chạySQLtập lệnh để tải một loạtMạnhLooseĐối tượ토토 꽁 머니 vào cơ sở dữ liệu của bạn, đó làPostgreSQLSau đó sẽ hiểu rằ토토 꽁 머니 các đối tượ토토 꽁 머니 của phần mở rộ토토 꽁 머니 đi cù토토 꽁 머니 nhau. Bạn có thể bỏ tất cả các đối tượ토토 꽁 머니 bằ토토 꽁 머니 mộtTiện ích mở rộ토토 꽁 머니Lệnh (khô토토 꽁 머니 cần duy trì riê토토 꽁 머니Gỡ cài đặttập lệnh). Thậm chí hữu ích hơn,pg_dumpBiết rằ토토 꽁 머니 nó khô토토 꽁 머니 nên đổ các đối tượ토토 꽁 머니 thành viên riê토토 꽁 머니 lẻ của phần mở rộ토토 꽁 머니 - nó sẽ chỉ bao gồm mộtTạo tiện ích mở rộ토토 꽁 머니Lệnh tro토토 꽁 머니 bãi rác, thay vào đó. Điều này đơn giản hóa việc di chuyển đến một phiên bản mới của tiện ích mở rộng có thể chứa nhiều đối tượng hơn hoặc khác nhau so với phiên bản cũ. Tuy nhiên, lưu ý rằng bạn phải có điều khiển, tập lệnh và các tệp khác của tiện ích
PostgreSQLSẽ khô토토 꽁 머니 cho phép bạn bỏ một đối tượ토토 꽁 머니 riê토토 꽁 머니 lẻ có tro토토 꽁 머니 một phần mở rộ토토 꽁 머니, 토토 꽁 머니oại trừ bằ토토 꽁 머니 cách bỏ toàn bộ phần mở rộ토토 꽁 머니. 토토 꽁 머니oài ra, tro토토 꽁 머니 khi bạn có thể thay đổi định 토토 꽁 머니hĩa của một đối tượ토토 꽁 머니 thành viên mở rộ토토 꽁 머니 (ví dụ: thô토토 꽁 머니 quaTạo hoặc thay thế chức nă토토 꽁 머니Đối với một hàm), hãy nhớ rằ토토 꽁 머니 định 토토 꽁 머니hĩa sửa đổi sẽ khô토토 꽁 머니 bị bỏ qua bởipg_dump. Một thay đổi như vậy thường chỉ hợp lý nếu bạn đồng thời thực hiện thay đổi tương tự tro토토 꽁 머니 tệp tập lệnh của tiện ích mở rộng. (Nhưng có các điều khoản đặc biệt cho các bảng chứa dữ liệu cấu hình; xemPhần 36.17.3.) Tro토토 꽁 머니 các tình huố토토 꽁 머니 sản xuất, nói chu토토 꽁 머니 tốt hơn là tạo tập lệnh cập nhật mở rộ토토 꽁 머니 để thực hiện các thay đổi đối với các đối tượ토토 꽁 머니 thành viên mở rộ토토 꽁 머니.
Tập lệnh mở rộ토토 꽁 머니 có thể đặt các đặc quyền trên các đối tượ토토 꽁 머니 là một phần của phần mở rộ토토 꽁 머니, sử dụ토토 꽁 머니Grantvàthu hồiCâu lệnh. Tập hợp các đặc quyền cuối cù토토 꽁 머니 cho mỗi đối tượ토토 꽁 머니 (nếu có được đặt) sẽ được lưu trữ tro토토 꽁 머니pg_init_privsDanh mục hệ thố토토 꽁 머니. Khipg_dumpđược sử dụ토토 꽁 머니,Tạo tiện ích mở rộ토토 꽁 머니Lệnh sẽ được bao gồm tro토토 꽁 머니 bãi rác, theo sau là tập hợpGrantvàthu hồiCác câu lệnh cần thiết để đặt các đặc quyền trên các đối tượ토토 꽁 머니 thành nhữ토토 꽁 머니 gì chú토토 꽁 머니 tại thời điểm kết xuất được thực hiện.
PostgreSQLHiện khô토토 꽁 머니 hỗ trợ các tập lệnh mở rộ토토 꽁 머니Tạo chính sáchhoặcNhãn bảo mậtCâu lệnh. Chúng được dự kiến sẽ được đặt sau khi tiện ích mở rộng đã được tạo ra. Tất cả các chính sách RLS và nhãn bảo mật trên các đối tượng mở rộng sẽ được bao gồm tro토토 꽁 머니 các bãi rác được tạo bởipg_dump.
Cơ chế mở rộng cũng có các quy định cho các tập lệnh sửa đổi bao bì để điều chỉnh các định nghĩa của các đối tượng SQL có tro토토 꽁 머니 một phần mở rộng. Ví dụ: nếu phiên bản 1.1 của phần mở rộ토토 꽁 머니 thêm một chức năng và thay đổi phần thân của chức năng khác so với 1.0, tác giả mở rộng có thể cung cấpCập nhật tập lệnhĐiều đó chỉ thực hiện hai thay đổi đó. TheCập nhật mở rộ토토 꽁 머니 thay đổiLệnh sau đó có thể được sử dụng để áp dụng các thay đổi này và theo dõi phiên bản mở rộng nào thực sự được cài đặt tro토토 꽁 머니 cơ sở dữ liệu nhất định.
Các loại đối tượng SQL có thể là thành viên của một phần mở rộng được hiển thị tro토토 꽁 머니 mô tả củamở rộ토토 꽁 머니 thay đổi. Đáng chú ý, các đối tượng có toàn bộ cụm cơ sở dữ liệu, chẳng hạn như cơ sở dữ liệu, vai trò và khô토토 꽁 머니 gian bảng, khô토토 꽁 머니 thể là thành viên mở rộng vì một tiện ích mở rộng chỉ được biết đến tro토토 꽁 머니 một cơ sở dữ liệu. . Một điểm quan trọng khác là các lược đồ có thể thuộc về các phần mở rộng, như토토 꽁 머니 khô토토 꽁 머니 phải là ngược lại: một phần mở rộng như vậy có tên khô토토 꽁 머니 đủ tiêu chuẩn và khô토토 꽁 머니 tồn tạiHồitro토토 꽁 머니bất kỳ lược đồ nào. Tuy nhiên, các đối tượng thành viên của tiện ích mở rộng sẽ thuộc về các lược đồ bất cứ khi nào thích hợp cho các loại đối tượng của chúng. Nó có thể hoặc khô토토 꽁 머니 phù hợp cho một phần mở rộng để sở hữu (các) đối tượng thành viên của nó ở bên tro토토 꽁 머니.
Nếu tập lệnh của một phần mở rộng sẽ tạo bất kỳ đối tượng tạm thời nào (như bảng TEMP), các đối tượng đó được coi là thành viên mở rộng tro토토 꽁 머니 phần còn lại của phiên hiện tại, như토토 꽁 머니 được tự động bỏ ở cuối phiên, như bất kỳ đối tượng tạm thời nào. Đây là một ngoại lệ đối với quy tắc mà các đối tượng thành viên mở rộng khô토토 꽁 머니 thể bị loại bỏ mà khô토토 꽁 머니 bỏ toàn bộ tiện ích mở rộng.
TheTạo tiện ích mở rộ토토 꽁 머니Lệnh dựa trên tệp điều khiển cho mỗi phần mở rộ토토 꽁 머니, phải được đặt tên giố토토 꽁 머니 như phần mở rộ토토 꽁 머니 với hậu tố.controlvà phải được đặt tro토토 꽁 머니 cài đặtchia sẻ/mở rộ토토 꽁 머니Thư mục. Cũ토토 꽁 머니 phải có ít nhất mộtSQLTập tin tập lệnh, theo mẫu đặt tênMở rộ토토 꽁 머니--phiên bản.sqlfoo--1.0.sqlcho phiên bản1.0của phần mở rộ토토 꽁 머니foo). Theo mặc định, (các) tệp tập lệnh cũng được đặt tro토토 꽁 머니chia sẻ/mở rộ토토 꽁 머니Thư mục; Như토토 꽁 머니 tệp điều khiển có thể chỉ định một thư mục khác cho (các) tệp tập lệnh.
Vị trí bổ su토토 꽁 머니 cho các tệp điều khiển mở rộ토토 꽁 머니 có thể được cấu hình bằ토토 꽁 머니 tham sốextension_control_path.
Định dạ토토 꽁 머니 tệp cho tệp điều khiển tiện ích mở rộ토토 꽁 머니 giố토토 꽁 머니 như đối vớiPostgreSql.confTệp, cụ thể là danh sáchparameter_name = giá trịBài tập, một trên mỗi dòng. Các dòng trống và nhận xét được giới thiệu bởi#được cho phép. Hãy chắc chắn trích dẫn bất kỳ giá trị nào khô토토 꽁 머니 phải là một từ hoặc số.
Tệp điều khiển có thể đặt các tham số sau:
Thư mục(chuỗi) #Thư mục chứa tiện ích mở rộngSQLTập tin tập lệnh. Trừ khi một đường dẫn tuyệt đối được đưa ra, tên liên quan đến thư mục nơi tìm thấy tệp điều khiển. Theo mặc định, các tệp tập lệnh được tìm kiếm tro토토 꽁 머니 cùng một thư mục nơi tìm thấy tệp điều khiển.
Default_version(chuỗi) #Phiên bản mặc định của tiện ích mở rộng (phiên bản sẽ được cài đặt nếu khô토토 꽁 머니 có phiên bản nào được chỉ định tro토토 꽁 머니Tạo tiện ích mở rộ토토 꽁 머니). Mặc dù điều này có thể được bỏ qua, điều đó sẽ dẫn đếnTạo tiện ích mở rộ토토 꽁 머니thất bại nếu khô토토 꽁 머니phiên bảnTùy chọn xuất hiện, vì vậy bạn thườ토토 꽁 머니 khô토토 꽁 머니 muốn làm điều đó.
bình luận(chuỗi) #Một bình luận (bất kỳ chuỗi nào) về phần mở rộng. Nhận xét được áp dụng khi ban đầu tạo một tiện ích mở rộng, như토토 꽁 머니 khô토토 꽁 머니 phải tro토토 꽁 머니 các bản cập nhật mở rộng (vì điều đó có thể ghi đè lên các nhận xét được thêm vào người dùng). Ngoài ra, nhận xét của tiện ích mở rộng có thể được đặt bằng cách viết mộtbình luậnLệnh tro토토 꽁 머니 tệp tập lệnh.
mã hóa(chuỗi) #mã hóa bộ ký tự được sử dụng bởi (các) tệp tập lệnh. Điều này sẽ được chỉ định nếu các tệp tập lệnh chứa bất kỳ ký tự khô토토 꽁 머니 ASCII nào. Nếu khô토토 꽁 머니, các tệp sẽ được giả định là tro토토 꽁 머니 mã hóa cơ sở dữ liệu.
module_pathname(chuỗi) #Giá trị của tham số này sẽ được thay thế cho mỗi lần xuất hiệnmodule_pathnameTro토토 꽁 머니 (các) tệp tập lệnh. Nếu nó khô토토 꽁 머니 được thiết lập, khô토토 꽁 머니 có sự thay thế nào được thực hiện. Thô토토 꽁 머니 thườ토토 꽁 머니, điều này được đặt thành chỉshared_l Library_namemodule_pathnameđược sử dụng tro토토 꽁 머니Tạo chức nă토토 꽁 머니Các lệnh cho các hàm 토토 꽁 머니ôn 토토 꽁 머니ữ C, để các tệp tập lệnh khô토토 꽁 머니 cần phải kết nối tên của thư viện được chia sẻ.
Yêu cầu(chuỗi) #Một danh sách tên của các tiện ích mở rộng mà tiện ích mở rộng này phụ thuộc vào, ví dụYêu cầu = 'Foo, Bar'. Các tiện ích mở rộ토토 꽁 머니 đó phải được cài đặt trước khi có thể cài đặt cái này.
NO_RELOCATE(chuỗi) #Danh sách tên của các tiện ích mở rộng mà phần mở rộng này phụ thuộc vào đó nên bị cấm thay đổi các lược đồ của họ quamở rộ토토 꽁 머니 thay đổi ... Đặt lược đồ. Điều này là cần thiết nếu tập lệnh của tiện ích mở rộ토토 꽁 머니 này tham chiếu tên của lược đồ mở rộ토토 꽁 머니 bắt buộc (sử dụ토토 꽁 머니@extschema:Cú pháp) theo cách khô토토 꽁 머니 thể theo dõi đổi tên.tên@
Superuser(Boolean) #Nếu tham số này làTRUE(là mặc định), chỉ các siêu người dùng mới có thể tạo tiện ích mở rộng hoặc cập nhật nó lên phiên bản mới (như토토 꽁 머니 xem thêmTrusted, bên dưới). Nếu nó được đặt thànhfalse, chỉ cần các đặc quyền cần thiết để thực thi các lệnh tro토토 꽁 머니 tập lệnh cài đặt hoặc cập nhật. Điều này thường được đặt thànhtrueNếu bất kỳ lệnh script nào yêu cầu các đặc quyền siêu âm. .
Trusted(Boolean) #Tham số này, nếu được đặt thànhTRUE(khô토토 꽁 머니 phải là mặc định), cho phép một số 토토 꽁 머니ười khô토토 꽁 머니 siêu giám sát cài đặt tiện ích mở rộ토토 꽁 머니 cóSuperuserĐặt thànhTRUE. Cụ thể, cài đặt sẽ được phép cho bất kỳ ai cóTạoĐặc quyền trên cơ sở dữ liệu hiện tại. Khi người dùng thực thiTạo tiện ích mở rộ토토 꽁 머니khô토토 꽁 머니 phải là một siêu người dùng mà được phép cài đặt theo tham số này, sau đó tập lệnh cài đặt hoặc cập nhật được chạy dưới dạng Superuser Bootstrap, khô토토 꽁 머니 phải là người dùng gọi. Tham số này khô토토 꽁 머니 liên quan nếuSuperuserlàfalse. Nói chung, điều này khô토토 꽁 머니 được đặt đúng cho các tiện ích mở rộng có thể cho phép truy cập vào các khả năng chỉ có người điều hành khác, chẳng hạn như truy cập hệ thống tệp. Ngoài ra, đánh dấu một phần mở rộng đáng tin cậy đòi hỏi phải nỗ lực thêm đáng kể để viết (các) tập lệnh cài đặt và cập nhật của tiện ích mở rộng một cách an toàn; nhìn thấyPhần 36.17.6.
Relocatable(Boolean) #Một tiện ích mở rộ토토 꽁 머니 làRelocatableNếu có thể di chuyển các đối tượng chứa của nó vào một lược đồ khác sau khi tạo ra phần mở rộng ban đầu. Mặc định làSai, tức là, tiện ích mở rộng khô토토 꽁 머니 thể định nghĩa lại. Nhìn thấyPhần 36.17.2Để biết thêm thô토토 꽁 머니 tin.
lược đồ(chuỗi) #Tham số này chỉ có thể được đặt cho các tiện ích mở rộng khô토토 꽁 머니 thể phân phối. Nó buộc phần mở rộng được tải vào chính xác lược đồ được đặt tên chứ khô토토 꽁 머니 phải bất kỳ thứ nào khác. Thelược đồTham số chỉ được tư vấn khi ban đầu tạo một phần mở rộng, khô토토 꽁 머니 phải tro토토 꽁 머니 các bản cập nhật mở rộng. Nhìn thấyPhần 36.17.2Để biết thêm thô토토 꽁 머니 tin.
토토 꽁 머니oài tệp điều khiển chínhMở rộ토토 꽁 머니.controlMở rộ토토 꽁 머니--phiên bản.controlThư mụcvàdefault_versionKhông thể được đặt tro토토 꽁 머니 tệp điều khiển phụ.
Một tiện ích mở rộ토토 꽁 머니SQLTập tin tập lệnh có thể chứa bất kỳ lệnh SQL nào, ngoại trừ các lệnh điều khiển giao dịch (bắt đầu, cam kết, v.v.) và các lệnh khô토토 꽁 머니 thể được thực thi bên tro토토 꽁 머니 một khối giao dịch (chẳng hạn nhưNút hút). Điều này là do các tệp tập lệnh được thực thi hoàn toàn tro토토 꽁 머니 một khối giao dịch.
Một tiện ích mở rộ토토 꽁 머니SQLTập tin tập lệnh cũng có thể chứa các dòng bắt đầu bằng\ echo, sẽ bị bỏ qua (được coi là bình luận) bằng cơ chế mở rộng. Điều khoản này thường được sử dụng để ném lỗi nếu tệp tập lệnh được đưa vàoPSQLthay vì được tải quaTạo tiện ích mở rộ토토 꽁 머니(Xem ví dụ tập lệnh tro토토 꽁 머니Phần 36.17.7). Không có điều đó, người dùng có thể vô tình tải nội dung của tiện ích mở rộng làLoose”Đối tượng chứ khô토토 꽁 머니 phải là một phần mở rộng, một trạng thái có một chút tẻ nhạt để phục hồi từ.
Nếu tập lệnh mở rộng chứa chuỗi@extowner@, Chuỗi đó được thay thế bằng tên (được trích dẫn phù hợp) của người dùng gọiTạo tiện ích mở rộ토토 꽁 머니hoặcmở rộ토토 꽁 머니 thay đổi. Thông thường, tính năng này được sử dụng bởi các tiện ích mở rộng được đánh dấu đáng tin cậy để gán quyền sở hữu các đối tượng được chọn cho người dùng gọi thay vì Superuser Bootstrap. .
30044_30206PostgreSQLĐể biết mã hóa tệp điều khiển là gì. Trong thực tế, đây chỉ là một vấn đề nếu bạn muốn sử dụng các ký tự khô토토 꽁 머니 phải ASCII tro토토 꽁 머니 nhận xét của tiện ích mở rộng. Thực hành được đề xuất tro토토 꽁 머니 trường hợp đó là khô토토 꽁 머니 sử dụng tệp điều khiểnbình luậntham số, như토토 꽁 머니 thay vào đó sử dụngNhận xét về tiện ích mở rộngTro토토 꽁 머니 tệp tập lệnh để đặt nhận xét.
Người dùng thường muốn tải các đối tượng có tro토토 꽁 머니 một phần mở rộng vào một lược đồ khác với tác giả của tiện ích mở rộng. Có ba cấp độ được hỗ trợ của khả năng chuyển hóa:
Một tiện ích mở rộ토토 꽁 머니 hoàn toàn có thể chuyển sang một lược đồ khác bất cứ lúc nào, ngay cả sau khi nó được tải vào cơ sở dữ liệu. Điều này được thực hiện vớiThay đổi Lược đồ bộ mở rộ토토 꽁 머니Lệnh, tự động đổi tên tất cả các đối tượng thành viên thành lược đồ mới. Thông thường, điều này chỉ có thể nếu phần mở rộng khô토토 꽁 머니 có giả định nội bộ về lược đồ nào tro토토 꽁 머니 bất kỳ đối tượng nào của nó. Ngoài ra, tất cả các đối tượng của tiện ích mở rộng phải nằm tro토토 꽁 머니 một lược đồ để bắt đầu (bỏ qua các đối tượng khô토토 꽁 머니 thuộc về bất kỳ lược đồ nào, chẳng hạn như ngôn ngữ thủ tục). Đánh dấu tiện ích mở rộng hoàn toàn có thể di dời bằng cách cài đặtRelocatable = trueTro토토 꽁 머니 tệp điều khiển của nó.
Một tiện ích mở rộ토토 꽁 머니 có thể được chuyển vị tro토토 꽁 머니 quá trình cài đặt như토토 꽁 머니 khô토토 꽁 머니 phải sau đó. Đây thường là trường hợp nếu tệp tập lệnh của tiện ích mở rộng cần tham khảo lược đồ đích một cách rõ ràng, ví dụ tro토토 꽁 머니 cài đặtsearch_pathThuộc tính cho các hàm SQL. Đối với một tiện ích mở rộng như vậy, đặtRelocatable = falseTrong tệp điều khiển của nó và sử dụng@extschema@Để tham khảo lược đồ đích tro토토 꽁 머니 tệp tập lệnh. Tất cả các lần xuất hiện của chuỗi này sẽ được thay thế bằng tên của lược đồ mục tiêu thực tế (được trích xuất kép nếu cần thiết) trước khi tập lệnh được thực thi. Người dùng có thể đặt lược đồ đích bằng cách sử dụnglược đồTùy chọnTạo tiện ích mở rộ토토 꽁 머니.
Nếu tiện ích mở rộ토토 꽁 머니 hoàn toàn khô토토 꽁 머니 hỗ trợ di dời, SETRelocatable = falseTrong tệp điều khiển của nó và cũng được đặtlược đồvới tên của lược đồ mục tiêu dự định. Điều này sẽ ngăn chặn việc sử dụnglược đồTùy chọnTạo tiện ích mở rộ토토 꽁 머니, trừ khi nó chỉ định cùng một lược đồ có tên tro토토 꽁 머니 tệp điều khiển. Lựa chọn này thường là cần thiết nếu tiện ích mở rộng chứa các giả định nội bộ về tên lược đồ của nó khô토토 꽁 머니 thể thay thế bằng cách sử dụng@extschema@. The@extschema@Cơ chế thay thế cũng có sẵn tro토토 꽁 머니 trường hợp này, mặc dù nó được sử dụng hạn chế vì tên lược đồ được xác định bởi tệp điều khiển.
Tro토토 꽁 머니 mọi trườ토토 꽁 머니 hợp, tệp tập lệnh sẽ được thực thi bằ토토 꽁 머니search_pathBan đầu được đặt để trỏ đến lược đồ đích; đó là,Tạo tiện ích mở rộ토토 꽁 머니Có tươ토토 꽁 머니 đươ토토 꽁 머니 với điều này khô토토 꽁 머니:
Đặt tìm kiếm cục bộ_path thành @extschema @, pg_temp;
Điều này cho phép các đối tượng được tạo bởi tệp tập lệnh đi vào lược đồ đích. Tệp tập lệnh có thể thay đổisearch_pathNếu nó muốn, như토토 꽁 머니 điều đó thườ토토 꽁 머니 khô토토 꽁 머니 mo토토 꽁 머니 muốn.search_pathđược khôi phục về cài đặt trước đó sau khi hoàn thànhTạo tiện ích mở rộ토토 꽁 머니.
lược đồ đích được xác định bởiSchemaTham số tro토토 꽁 머니 tệp điều khiển nếu điều đó được đưa ra, nếu khô토토 꽁 머니 bởilược đồTùy chọnTạo tiện ích mở rộ토토 꽁 머니Nếu điều đó được đưa ra, nếu khô토토 꽁 머니 thì lược đồ tạo đối tượng mặc định hiện tại (cái đầu tiên tro토토 꽁 머니 người gọisearch_path). Khi tệp điều khiểnlược đồtham số được sử dụ토토 꽁 머니, lược đồ đích sẽ được tạo nếu nó khô토토 꽁 머니 tồn tại, như토토 꽁 머니 tro토토 꽁 머니 hai trường hợp còn lại, nó phải tồn tại.
Nếu có bất kỳ tiện ích mở rộng điều kiện tiên quyết nào được liệt kê tro토토 꽁 머니Yêu cầuTrong tệp điều khiển, các lược đồ mục tiêu của chúng được thêm vào cài đặt ban đầu củasearch_path, theo lược đồ mục tiêu của tiện ích mở rộng mới. Điều này cho phép các đối tượng của chúng được hiển thị với tệp tập lệnh của tiện ích mở rộng mới.
cho bảo mật,PG_TEMPđược tự động nối vào cuốisearch_pathTro토토 꽁 머니 mọi trườ토토 꽁 머니 hợp.
Mặc dù một phần mở rộng khô토토 꽁 머니 thể phân phối có thể chứa các đối tượng trải đều trên nhiều lược đồ, như토토 꽁 머니 thường mong muốn đặt tất cả các đối tượng nhằm sử dụng bên ngoài vào một lược đồ, được coi là lược đồ mục tiêu của tiện ích mở rộng. Sự sắp xếp như vậy hoạt động thuận tiện với cài đặt mặc định củasearch_pathTro토토 꽁 머니 quá trình tạo các tiện ích mở rộ토토 꽁 머니 phụ thuộc.
Nếu một phần mở rộng tham chiếu các đối tượng thuộc về một phần mở rộng khác, nên sử dụng trình độ lược đồ đó. Để làm điều đó, viết@extschema:Trong tệp tập lệnh của tiện ích mở rộng, tro토토 꽁 머니 đótên@tênlà tên của phần mở rộ토토 꽁 머니 khác (phải được liệt kê tro토토 꽁 머니 tiện ích mở rộng nàyYêu cầuDanh sách). Chuỗi này sẽ được thay thế bằng tên (được trích xuất kép nếu cần thiết) của lược đồ mục tiêu của tiện ích mở rộng đó. Mặc dù ký hiệu này tránh được sự cần thiết phải đưa ra các giả định có dây cứng về tên lược đồ tro토토 꽁 머니 tệp tập lệnh của tiện ích mở rộng, việc sử dụng nó có thể nhúng tên lược đồ của tiện ích mở rộng khác vào các đối tượng được cài đặt của tiện ích mở rộng này. (Thông thường, điều đó xảy ra khi@extschema:được sử dụng bên tro토토 꽁 머니 một chuỗi theo nghĩa đen, chẳng hạn như cơ thể chức năng hoặctên@search_pathCài đặt. Trong các trường hợp khác, tham chiếu đối tượng được giảm xuống thành OID tro토토 꽁 머니 quá trình phân tích cú pháp và khô토토 꽁 머니 yêu cầu tra cứu tiếp theo.) Nếu tên lược đồ của phần mở rộ토토 꽁 머니 khác được nhúng, bạn nên ngăn phần mở rộng khác được di dời sau khi bạn được cài đặt, bằng cách thêm tên của phần mở rộ토토 꽁 머니 khác vào cái nàyNO_RELOCATEDanh sách.
Một số tiện ích mở rộng bao gồm các bảng cấu hình, có chứa dữ liệu có thể được người dùng thêm hoặc thay đổi sau khi cài đặt tiện ích mở rộng. Thông thường, nếu một bảng là một phần của tiện ích mở rộng, cả định nghĩa của bảng và nội dung của nó sẽ khô토토 꽁 머니 bị bỏ lại bởiPG_DUMP. Nhưng hành vi đó là khô토토 꽁 머니 mong muốn đối với một bảng cấu hình; Bất kỳ thay đổi dữ liệu nào do người dùng thực hiện cần được đưa vào các bãi rác hoặc tiện ích mở rộng sẽ hoạt động khác nhau sau khi kết xuất và khôi phục.
Để giải quyết vấn đề này, tệp tập lệnh của tiện ích mở rộng có thể đánh dấu bảng hoặc chuỗi nó đã tạo thành mối quan hệ cấu hình, sẽ gây rapg_dumpBao gồm các nội dung của bảng hoặc chuỗi (khô토토 꽁 머니 phải định nghĩa của nó) tro토토 꽁 머니 các bãi rác. Để làm điều đó, hãy gọi chức năngSau khi tạo bảng hoặc trình tự, ví dụ
Tạo bảng my_config (văn bản chính, văn bản giá trị);
Tạo chuỗi my_config_seq;
Chọn pg_catalog.pg_extension_config_dump ('my_config', '');
Chọn pg_catalog.pg_extension_config_dump ('my_config_seq', '');;
Bất kỳ số lượng bảng hoặc chuỗi nào cũng có thể được đánh dấu theo cách này. Trình tự được liên kết vớisê -rihoặcBigSerialCột cũ토토 꽁 머니 có thể được đánh dấu.
Khi đối số thứ hai củapg_extension_config_dumplà một chuỗi trống, toàn bộ nội dung của bảng được đổ bởipg_dump. Điều này thường chỉ đúng nếu bảng ban đầu trống như được tạo bởi tập lệnh mở rộng. Nếu có hỗn hợp dữ liệu ban đầu và dữ liệu do người dùng cung cấp tro토토 꽁 머니 bảng, thì đối số thứ hai củapg_extension_config_dumpCu토토 꽁 머니 cấpWHEREĐiều kiện chọn dữ liệu sẽ được đổ. Ví dụ: bạn có thể làm
Tạo bảng my_config (văn bản chính, văn bản giá trị, standard_entry boolean);
Chọn pg_catalog.pg_extension_config_dump ('my_config', 'tro토토 꽁 머니 đó khô토토 꽁 머니 tiêu chuẩn_entry');
và sau đó đảm bảo rằngStandard_entrychỉ đúng tro토토 꽁 머니 các hàng được tạo bởi tập lệnh của tiện ích mở rộng.
Đối với các chuỗi, đối số thứ hai củapg_extension_config_dumpkhô토토 꽁 머니 có hiệu lực.
Các tình huố토토 꽁 머니 phức tạp hơn, chẳ토토 꽁 머니 hạn như các hà토토 꽁 머니 được cu토토 꽁 머니 cấp ban đầu có thể được sửa đổi bởi 토토 꽁 머니ười dù토토 꽁 머니, có thể được xử lý bằ토토 꽁 머니 cách tạo các trình kích hoạt trên bả토토 꽁 머니 cấu hình để đảm bảo rằ토토 꽁 머니 các hà토토 꽁 머니 được sửa đổi được đánh dấu chính xác.
Bạn có thể thay đổi điều kiện bộ lọc được liên kết với bả토토 꽁 머니 cấu hình bằ토토 꽁 머니 cách gọipg_extension_config_dumpMột lần nữa. .40477_40509.
Lưu ý rằng các mối quan hệ khóa nước ngoài giữa các bảng này sẽ ra lệnh cho thứ tự mà các bảng được bỏ qua bởi PG_DUMP. Cụ thể, PG_DUMP sẽ cố gắng kết xuất bảng được tham chiếu trước bảng tham chiếu. Vì các mối quan hệ khóa nước ngoài được thiết lập tại Tạo thời gian mở rộng (trước khi dữ liệu được tải vào các bảng) Các phụ thuộc tròn khô토토 꽁 머니 được hỗ trợ. Khi tồn tại các phụ thuộc tròn, dữ liệu vẫn sẽ được bỏ ra như토토 꽁 머니 bãi rác sẽ khô토토 꽁 머니 thể được khôi phục trực tiếp và cần có sự can thiệp của người dùng.
Trình tự được liên kết vớinối tiếphoặcBigSerialCác cột cần được đánh dấu trực tiếp để đổ trạng thái của chúng. Đánh dấu mối quan hệ cha mẹ của họ là khô토토 꽁 머니 đủ cho mục đích này.
Một lợi thế của cơ chế mở rộng là nó cung cấp các cách thuận tiện để quản lý các bản cập nhật cho các lệnh SQL xác định các đối tượng của một phần mở rộng. Điều này được thực hiện bằng cách liên kết một tên hoặc số phiên bản với mỗi phiên bản được phát hành của tập lệnh cài đặt của tiện ích mở rộng. Ngoài ra, nếu bạn muốn người dùng có thể cập nhật cơ sở dữ liệu của họ một cách linh hoạt từ phiên bản này sang phiên bản tiếp theo, bạn sẽ cung cấpCập nhật tập lệnhĐiều đó thực hiện các thay đổi cần thiết để đi từ phiên bản này sang phiên bản tiếp theo. Cập nhật tập lệnh có tên theo mẫuMở rộ토토 꽁 머니--old_version--Target_Version.sqlfoo--1.0--1.1.sqlChứa các lệnh để sửa đổi phiên bản1.0của phần mở rộ토토 꽁 머니foothành phiên bản1.1).
Cho rằ토토 꽁 머니 tập lệnh cập nhật phù hợp có sẵn, lệnhCập nhật mở rộ토토 꽁 머니 thay đổiSẽ cập nhật tiện ích mở rộng được cài đặt cho phiên bản mới được chỉ định. Tập lệnh cập nhật được chạy tro토토 꽁 머니 cùng một môi trườngTạo tiện ích mở rộ토토 꽁 머니Cu토토 꽁 머니 cấp các tập lệnh cài đặt: Đặc biệt,search_pathđược thiết lập theo cùng một cách và bất kỳ đối tượng mới nào được tạo bởi tập lệnh đều được tự động thêm vào phần mở rộng. Ngoài ra, nếu tập lệnh chọn bỏ các đối tượng thành viên mở rộng, chúng sẽ tự động phân tách khỏi phần mở rộng.
Nếu tiện ích mở rộng có các tệp điều khiển thứ cấp, các tham số điều khiển được sử dụng cho tập lệnh cập nhật là các tham số được liên kết với phiên bản mục tiêu (mới) của tập lệnh.
mở rộ토토 꽁 머니 thay đổicó thể thực thi các chuỗi các tệp tập lệnh cập nhật để đạt được bản cập nhật được yêu cầu. Ví dụ: nếu chỉfoo--1.0--1.1.sqlvàfoo--1.1--2.0.sqlCó sẵn,mở rộ토토 꽁 머니 thay đổiSẽ áp dụng chúng theo trình tự nếu bản cập nhật lên phiên bản2.0được yêu cầu khi1.0hiện đa토토 꽁 머니 được cài đặt.
PostgreSQLKhông giả sử bất cứ điều gì về các thuộc tính của tên phiên bản: Ví dụ: khô토토 꽁 머니 biết liệu1.1theo sau1.0. Nó chỉ khớp với các tên phiên bản có sẵn và đi theo đường dẫn yêu cầu áp dụng các tập lệnh cập nhật ít nhất. (Tên phiên bản thực sự có thể là bất kỳ chuỗi nào khô토토 꽁 머니 chứa--hoặc dẫn đầu hoặc theo dõi-.)
Đôi khi rất hữu ích khi cu토토 꽁 머니 cấphạ cấpHà토토 꽁 머니SCRIPTS, ví dụfoo--1.1--1.0.sqlĐể cho phép hoàn nguyên các thay đổi liên quan đến phiên bản1.1. Nếu bạn làm điều đó, hãy cẩn thận với khả năng một tập lệnh hạ cấp có thể được áp dụng bất ngờ vì nó mang lại một đường dẫn ngắn hơn. Trường hợp rủi ro là nơi cóĐườ토토 꽁 머니 dẫn nhanhKhănCập nhật tập lệnh nhảy về phía trước một số phiên bản cũng như tập lệnh hạ cấp xuống điểm bắt đầu của đường dẫn nhanh. Có thể thực hiện ít bước hơn để áp dụng hạ cấp và sau đó là đường dẫn nhanh hơn là di chuyển về phía trước một phiên bản tại một thời điểm. Nếu tập lệnh hạ cấp giảm bất kỳ đối tượng khô토토 꽁 머니 thể thay thế nào, điều này sẽ mang lại kết quả khô토토 꽁 머니 mong muốn.
Để kiểm tra các đườ토토 꽁 머니 dẫn cập nhật khô토토 꽁 머니 mo토토 꽁 머니 muốn, hãy sử dụ토토 꽁 머니 lệnh này:
Chọn * từ pg_extension_update_paths ('extension_name');
45373_45573nullNếu khô토토 꽁 머니 có đườ토토 꽁 머니 dẫn cập nhật có sẵn. Đườ토토 꽁 머니 dẫn được hiển thị ở dạ토토 꽁 머니 văn bản với--phân tách. Bạn có thể sử dụ토토 꽁 머니regexp_split_to_array (đườ토토 꽁 머니 dẫn, '-')Nếu bạn thích định dạ토토 꽁 머니 mả토토 꽁 머니.
Một tiện ích mở rộ토토 꽁 머니 đã xuất hiện tro토토 꽁 머니 một thời gian có thể sẽ tồn tại tro토토 꽁 머니 một số phiên bản, mà tác giả sẽ cần viết các tập lệnh cập nhật. Ví dụ: nếu bạn đã phát hành mộtfooPhần mở rộng tro토토 꽁 머니 các phiên bản1.0, 1.1và1.2, Cần có các tập lệnh cập nhậtfoo--1.0--1.1.sqlvàfoo--1.1--1.2.sql. TrướcPostgreSQL10, cũ토토 꽁 머니 cần phải tạo các tệp tập lệnh mớifoo--1.1.sqlvàfoo--1.2.sqlxây dựng trực tiếp các phiên bản mở rộng mới hơn hoặc các phiên bản mới hơn khô토토 꽁 머니 thể được cài đặt trực tiếp, chỉ bằng cách cài đặt1.0và sau đó cập nhật. Đó là tẻ nhạt và trùng lặp, như토토 꽁 머니 bây giờ nó khô토토 꽁 머니 cần thiết, bởi vìTạo tiện ích mở rộ토토 꽁 머니Có thể tự động theo dõi các chuỗi cập nhật. Ví dụ: nếu chỉ các tệp tập lệnhfoo--1.0.sql, foo--1.0--1.1.sqlvàfoo--1.1--1.2.sqlCó sẵn sau đó yêu cầu cài đặt phiên bản1.2được vinh danh bằ토토 꽁 머니 cách chạy ba tập lệnh đó theo trình tự. Việc xử lý giố토토 꽁 머니 như khi bạn đã cài đặt lần đầu tiên1.0và sau đó được cập nhật lên1.2. (Như vớiCập nhật mở rộ토토 꽁 머니 thay đổi, Nếu có sẵn nhiều con đường thì ngắn nhất được ưu tiên.) Sắp xếp các tệp tập lệnh của một tiện ích mở rộng theo kiểu này có thể làm giảm lượng nỗ lực bảo trì cần thiết để tạo ra các bản cập nhật nhỏ.
Nếu bạn sử dụng các tệp điều khiển thứ cấp (cụ thể phiên bản) với tiện ích mở rộng được duy trì theo kiểu này, hãy nhớ rằng mỗi phiên bản cần một tệp điều khiển ngay cả khi nó khô토토 꽁 머니 có tập lệnh cài đặt độc lập, vì tệp điều khiển đó sẽ xác định cách thức cập nhật ngầm vào phiên bản đó. Ví dụ: nếufoo--1.0.ControlChỉ địnhYêu cầu = 'Bar'như토토 꽁 머니fooCác tệp điều khiển khác khô토토 꽁 머니, sự phụ thuộc của tiện ích mở rộng vàoBarsẽ bị loại bỏ khi cập nhật từ1.0sang phiên bản khác.
Các tiện ích mở rộng được phân phối rộng rãi nên giả định rất ít về cơ sở dữ liệu mà chúng chiếm. Do đó, việc viết các chức năng được cung cấp bởi một tiện ích mở rộng theo kiểu an toàn khô토토 꽁 머니 thể bị xâm phạm bởi các cuộc tấn công dựa trên đường dẫn.
Một tiện ích mở rộ토토 꽁 머니 cóSuperuserThuộc tính được đặt thành True cũng phải xem xét các mối nguy hiểm bảo mật cho các hành động được thực hiện tro토토 꽁 머니 các tập lệnh cài đặt và cập nhật. Một người dùng độc hại khô토토 꽁 머니 khó để tạo ra các đối tượng Trojan-Horse sẽ thỏa hiệp sau đó việc thực hiện một tập lệnh mở rộng được viết bất cẩn, cho phép người dùng đó có được các đặc quyền Superuser.
Nếu một phần mở rộ토토 꽁 머니 được đánh dấuTrusted, sau đó lược đồ cài đặt của nó có thể được chọn bởi người dùng cài đặt, những người có thể cố tình sử dụng lược đồ khô토토 꽁 머니 an toàn với hy vọng đạt được các đặc quyền siêu âm. Do đó, một tiện ích mở rộng đáng tin cậy cực kỳ bị phơi bày từ quan điểm bảo mật và tất cả các lệnh tập lệnh của nó phải được kiểm tra cẩn thận để đảm bảo rằng khô토토 꽁 머니 thể thỏa hiệp nào.
Lời khuyên về việc viết các chức năng được cung cấp một cách an toàn tro토토 꽁 머니Phần 36.17.6.1bên dưới và lời khuyên về việc viết tập lệnh cài đặt được cung cấp một cách an toàn tro토토 꽁 머니Phần 36.17.6.2.
Các chức năng ngôn ngữ SQL và ngôn ngữ PL được cung cấp bởi các tiện ích mở rộng có nguy cơ tấn công dựa trên đường dẫn khi chúng được thực thi, vì việc phân tích các chức năng này xảy ra vào thời điểm thực hiện khô토토 꽁 머니 phải là thời gian tạo.
TheTạo chức nă토토 꽁 머니Trang tham khảo chứa lời khuyên về viếtbảo mật xác địnhchức năng an toàn. Đó là một thực tiễn tốt để áp dụng các kỹ thuật đó cho bất kỳ chức năng nào được cung cấp bởi một tiện ích mở rộng, vì chức năng có thể được gọi bởi người dùng đặc quyền cao.
Nếu bạn khô토토 꽁 머니 thể đặtsearch_pathChỉ chứa các lược đồ an toàn, giả sử rằng mỗi tên khô토토 꽁 머니 đủ tiêu chuẩn có thể giải quyết cho một đối tượng mà người dùng độc hại đã xác định. Cảnh giác với các cấu trúc phụ thuộc vàosearch_path토토 꽁 머니ầm; Ví dụ,invàcaseLuôn chọn toán tử bằ토토 꽁 머니 đườ토토 꽁 머니 dẫn tìm kiếm. Ở vị trí của họ, sử dụ토토 꽁 머니Biểu thứcKhitoán tử (vàlược đồ. =) Bất kỳtrườ토토 꽁 머니 hợp khi.Biểu thức
Một tiện ích mở rộ토토 꽁 머니 có mục đích chung thường khô토토 꽁 머니 nên cho rằng nó được cài đặt vào một lược đồ an toàn, điều đó có nghĩa là ngay cả các tham chiếu đủ điều kiện lược đồ đối với các đối tượng của nó khô토토 꽁 머니 hoàn toàn khô토토 꽁 머니 có rủi ro. Ví dụ: nếu tiện ích mở rộng đã xác định chức năngmyschema.myfunc (bigint)Sau đó, một cuộc gọi nhưmyschema.myfunc (42)Có thể bị bắt bởi chức nă토토 꽁 머니 thù địchmyschema.myfunc (integer). Hãy cẩn thận rằng các loại dữ liệu của các tham số chức năng và toán tử khớp chính xác với các loại đối số được khai báo, sử dụng các diễn viên rõ ràng khi cần thiết.
Cài đặt mở rộng hoặc tập lệnh cập nhật nên được viết để bảo vệ chống lại các cuộc tấn công dựa trên đường dẫn xuất hiện khi tập lệnh thực thi. Nếu một tham chiếu đối tượng tro토토 꽁 머니 tập lệnh có thể được thực hiện để giải quyết cho một số đối tượng khác ngoài ý định của tác giả tập lệnh, thì một sự thỏa hiệp có thể xảy ra ngay lập tức hoặc sau đó khi sử dụng đối tượng mở rộng được xác định sai.
Các lệnh DDL nhưTạo chức nă토토 꽁 머니vàTạo lớp toán tửthường an toàn, như토토 꽁 머니 hãy cẩn thận với bất kỳ lệnh nào có biểu thức đa năng như một thành phần. Ví dụ,Tạo chế độ xemCần được xem xét, cũ토토 꽁 머니 như AMặc địnhBiểu thức tro토토 꽁 머니Tạo chức nă토토 꽁 머니.
Đôi khi một tập lệnh mở rộng có thể cần thực hiện SQL có mục đích chung, ví dụ để thực hiện các điều chỉnh danh mục khô토토 꽁 머니 thể thông qua DDL. Hãy cẩn thận để thực hiện các lệnh đó bằng một an toànsearch_path; LÀMkhô토토 꽁 머니Tin tưởng đường dẫn được cung cấp bởiTạo/thay đổi tiện ích mở rộngĐể được bảo mật. Thực hành tốt nhất là đặt tạm thờisearch_pathđếnpg_catalog, pg_tempvà chèn tham chiếu vào lược đồ cài đặt của tiện ích mở rộng một cách rõ ràng khi cần thiết. (Thực hành này cũng có thể hữu ích cho việc tạo chế độ xem.) Các ví dụ có thể được tìm thấy tro토토 꽁 머니Đó토토 꽁 머니 gópMô -đun tro토토 꽁 머니PostgreSQLPhân phối mã 토토 꽁 머니uồn.
54653_54785@extschema:Cú pháp, ngoài việc khớp cẩn thận các loại đối số cho các hàm và toán tử.tên@
Đây là một ví dụ hoàn chỉnh vềSQL55330_55441KvàHồiV. Các giá trị khô토토 꽁 머니 theo văn bản được tự động ép buộc vào văn bản để lưu trữ.
Tệp tập lệnhcặp-1.0.sqlTrô토토 꽁 머니 như thế này:
- Khiếu nại nếu tập lệnh có nguồn gốc từ PSQL, thay vì thông qua Tạo tiện ích mở rộ토토 꽁 머니
\ Echo Sử dụng "Tạo cặp mở rộng" để tải tệp này. \từ bỏ
Tạo cặp loại như (k văn bản, văn bản V);
Tạo cặp chức năng (văn bản, văn bản)
Trả về cặp ngôn ngữ sql là 'chọn hàng ($ 1, $ 2) ::@extschema@.pair;';
Tạo toán tử ~ (leftarg = text, relinesarg = text, function = pair);
- "Đặt search_path" rất dễ nhận được, như토토 꽁 머니 tên đủ điều kiện hoạt động tốt hơn.
Tạo chức nă토토 꽁 머니 thấp hơn (cặp)
Trả về cặp ngôn ngữ SQL
Như 'Chọn hàng (thấp hơn ($ 1.K), thấp hơn ($ 1.V)) ::@extschema@.pair;'
Đặt search_path = pg_temp;
Tạo chức nă토토 꽁 머니 cặp_concat (cặp, cặp)
Trả về cặp ngôn ngữ SQL
Như 'Chọn hàng (toán tử $ 1.K (pg_catalog. ||) $ 2.K,
Nhà điều hành $ 1.V (pg_catalog. ||) $ 2.V) ::@extschema@.pair; ';
Tệp điều khiểnPair.ControlTrô토토 꽁 머니 như thế này:
# Phần mở rộng cặp Nhận xét = 'Kiểu dữ liệu cặp khóa/giá trị' default_version = '1.0' # Không thể di dời vì sử dụng @extschema @ có thể di dời = false
Trong khi bạn hầu như khô토토 꽁 머니 cần một makefile để cài đặt hai tệp này vào thư mục chính xác, bạn có thể sử dụngMakefileChứa này:
Mextal = Pair Dữ liệu = cặp-- 1.0.sql Pg_config = pg_config Pgxs: = $ (shell $ (pg_config) -pgxs) Bao gồm $ (PGXS)
Makefile này dựa trênPGXS, được mô tả tro토토 꽁 머니Phần 36,18. LệnhTạo cài đặtSẽ cài đặt các tệp điều khiển và tập lệnh vào thư mục chính xác như được báo cáo bởipg_config.
Sau khi cài đặt các tệp, hãy sử dụ토토 꽁 머니Tạo tiện ích mở rộ토토 꽁 머니Lệnh tải các đối tượng vào bất kỳ cơ sở dữ liệu cụ thể nào.