Phiên bản được hỗ trợ:hiện tại(17) /16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản không được hỗ trợ:12 / 11

71.2. Danh tỷ lệ kèo bóng đá hệ thống dữ liệu ban đầu

Mỗi danh tỷ lệ kèo bóng đá có bất kỳ dữ liệu ban đầu được tạo bằng tay (một số không) có tương ứng.datTệp chứa dữ tỷ lệ kèo bóng đá ban đầu của nó ở định dạng có thể chỉnh sửa.

71.2.1. Định dạng tệp dữ tỷ lệ kèo bóng đá

mỗi.datTệp chứa các cấu trúc dữ liệu Perl theo nghĩa đen chỉ đơn giản là để tạo ra một cấu trúc dữ liệu trong bộ nhớ bao gồm một mảng các tài liệu tham khảo băm, một hàng trên mỗi hàng danh tỷ lệ kèo bóng đá. Một đoạn trích được sửa đổi một chút từpg_database.datsẽ trình bày tỷ lệ kèo bóng đá tính năng chính:

[[

# Một bình luận có thể xuất hiện ở đây.
oid = '1', oid_symbol = 'Templatedboid',
  Descr = 'Mẫu mặc định của cơ sở dữ tỷ lệ kèo bóng đá',
  datname = 'template1', mã hóa = 'mã hóa', datcollate = 'lc_collate',
  datctype = 'lc_ctype', datistemplate = 't', datallowConn = 't',
  datconnlimit = '-1', datlastsysoid = '0', datfrozenxid = '0',
  datminmxid = '1', dattablespace = 'pg_default', dataCl = '_null_',

]

Điểm để lưu ý:

  • Bố cục tập tin tổng thể là: Khung bình phương mở, một hoặc nhiều bộ niềng răng xoăn mỗi thứ đại diện cho một hàng danh tỷ lệ kèo bóng đá, đóng khung vuông. Viết dấu phẩy sau mỗi lần đóng giằng xoăn.

  • Trong mỗi hàng danh tỷ lệ kèo bóng đá, hãy viết dấu phẩyKey = giá trịcặp. Cho phépKeyS là tên của các cột của danh tỷ lệ kèo bóng đá, cộng với các khóa siêu dữ liệuoid, oid_symbol, mảng_type_oidDescr. (Việc sử dụngoidoid_symbolđược mô tả trongPhần 71.2.2bên dưới, trong khimảng_type_oidđược mô tả trongPhần 71.2.4. Descrcung cấp chuỗi mô tả cho đối tượng, sẽ được chèn vàopg_descriphoặcpg_shdescripkhi thích hợp.) Trong khi các khóa siêu dữ liệu là tùy chọn, tất cả các cột được xác định của danh tỷ lệ kèo bóng đá phải được cung cấp, ngoại trừ khi danh tỷ lệ kèo bóng đá của.hTệp Chỉ định giá trị mặc định cho cột. (Trong ví dụ trên,DatdbaTrường đã bị bỏ qua vìpg_database.hcung cấp giá trị mặc định phù hợp cho nó.)

  • Tất cả các giá trị phải được trích xuất đơn. Các trích dẫn đơn lẻ được sử dụng trong một giá trị với dấu gạch chéo ngược. Backslashes có nghĩa là dữ tỷ lệ kèo bóng đá có thể, nhưng không cần, được nhân đôi; Điều này tuân theo các quy tắc của Perl cho các nghĩa đen được trích dẫn đơn giản. Lưu ý rằng các dấu gạch chéo ngược xuất hiện dưới dạng dữ tỷ lệ kèo bóng đá sẽ được coi là thoát khỏi máy quét bootstrap, theo các quy tắc tương tự như đối với các hằng số chuỗi thoát (xemPhần 4.1.2.2); Ví dụ\ TChuyển đổi thành một ký tự tab. Nếu bạn thực sự muốn một dấu gạch chéo ngược trong giá trị cuối cùng, bạn sẽ cần phải viết bốn trong số chúng: Perl Strips Two, rời khỏi\Để máy quét bootstrap xem.

  • Giá trị null được biểu diễn bằng_NULL_. (Lưu ý rằng không có cách nào để tạo một giá trị chỉ là chuỗi đó.)

  • Nhận xét được đi trước#, và phải ở trên dòng của riêng họ.

  • Các giá trị trường là OID của các tỷ lệ kèo bóng đá danh tỷ lệ kèo bóng đá khác phải được biểu diễn bằng các tên biểu tượng thay vì các OID số thực tế. (Trong ví dụ trên,Dattablespacechứa một tham chiếu như vậy.) Điều này được mô tả trongPhần 71.2.3bên dưới.

  • Vì các băm là các cấu trúc dữ tỷ lệ kèo bóng đá không có thứ tự, thứ tự trường và bố cục dòng không có ý nghĩa về mặt ngữ nghĩa. Tuy nhiên, để duy trì ngoại hình nhất quán, chúng tôi đặt một vài quy tắc được áp dụng bởi tập lệnh định dạngRefleat_dat_file.pl:

    • Trong mỗi cặp niềng răng xoăn, các trường siêu dữ tỷ lệ kèo bóng đáoid, oid_symbol, mảng_type_oidDescr(nếu có) đến trước, theo thứ tự đó, sau đó các trường riêng của danh tỷ lệ kèo bóng đá xuất hiện theo thứ tự được xác định của chúng.

    • Newlines được chèn giữa các trường khi cần thiết để giới hạn độ dài dòng xuống 80 ký tự, nếu có thể. Một dòng mới cũng được chèn giữa các trường siêu dữ tỷ lệ kèo bóng đá và các trường chính quy.

    • Nếu danh tỷ lệ kèo bóng đá của.hTệp Chỉ định giá trị mặc định cho cột và tỷ lệ kèo bóng đá nhập dữ liệu có cùng giá trị đó,Reformat_dat_file.plSẽ bỏ qua nó khỏi tệp dữ tỷ lệ kèo bóng đá. Điều này giữ cho biểu diễn dữ tỷ lệ kèo bóng đá nhỏ gọn.

    • Reformat_dat_file.plBảo tồn tỷ lệ kèo bóng đá dòng trống và tỷ lệ kèo bóng đá dòng bình luận AS-IS.

    Nên chạyRefleat_dat_file.plTrước khi gửi các bản vá dữ liệu danh tỷ lệ kèo bóng đá. Để thuận tiện, bạn chỉ có thể thay đổi thànhsrc/bao gồm/catalog/và chạyLàm cho ReforTat-Dat-Files.

  • Nếu bạn muốn thêm một phương thức mới để làm cho biểu diễn dữ tỷ lệ kèo bóng đá nhỏ hơn, bạn phải thực hiện nó trongReformat_dat_file.plvà cũng dạyDanh tỷ lệ kèo bóng đá :: Parsedata ()Cách mở rộng dữ tỷ lệ kèo bóng đá trở lại thành đại diện đầy đủ.

71.2.2. Gán oid

Một hàng danh tỷ lệ kèo bóng đá xuất hiện trong dữ liệu ban đầu có thể được đưa ra một OID được chỉ định bằng thủ công bằng cách viếtoid =nnnnTrường siêu dữ tỷ lệ kèo bóng đá. Hơn nữa, nếu một OID được gán, một macro C cho OID đó có thể được tạo bằng cách viết mộtoid_symbol =tênTrường siêu dữ tỷ lệ kèo bóng đá.

Các hàng danh tỷ lệ kèo bóng đá được tải sẵn phải có OID được chỉ định trước nếu có các tham chiếu OID cho chúng trong các hàng được tải sẵn khác. Một OID được chỉ định trước cũng cần thiết nếu OID của hàng phải được tham chiếu từ mã C. Nếu không áp dụng trường hợp nào,oidTrường siêu dữ liệu có thể được bỏ qua, trong trường hợp đó, mã bootstrap gán một OID tự động. Trong thực tế, chúng tôi thường chỉ định các OID cho tất cả hoặc không có hàng được tải sẵn trong một danh tỷ lệ kèo bóng đá nhất định, ngay cả khi chỉ một số trong số chúng thực sự được tham chiếu chéo.

Viết giá trị số thực tế của bất kỳ OID nào trong mã C được coi là dạng rất xấu; Thay vào đó, luôn luôn sử dụng một macro. Tài tỷ lệ kèo bóng đá tham khảo trực tiếp đếnpg_procOIDS đủ phổ biến để có một cơ chế đặc biệt để tạo tỷ lệ kèo bóng đá macro cần thiết tự động; nhìn thấysrc/backend/utils/gen_fmgrtab.pl. Tương tự - nhưng, vì lý do lịch sử, không được thực hiện theo cùng một cách - có một phương thức tự động để tạo macro chopg_typeoids.oid_symbolCác tỷ lệ kèo bóng đá không cần thiết trong hai danh tỷ lệ kèo bóng đá đó. Tương tự như vậy, macro chopg_ classOIDS của các danh tỷ lệ kèo bóng đá và chỉ tỷ lệ kèo bóng đá hệ thống được thiết lập tự động. Đối với tất cả các danh tỷ lệ kèo bóng đá hệ thống khác, bạn phải chỉ định thủ công bất kỳ macro nào bạn cần quaoid_symboltỷ lệ kèo bóng đá nhập.

Để tìm một OID có sẵn cho một hàng mới được tải sẵn, hãy chạy tập lệnhsrc/bao gồm/catalog/unude_oids. Nó in phạm vi bao gồm tỷ lệ kèo bóng đá OID chưa sử dụng (ví dụ: dòng đầu ra45-900có nghĩa là OIDS 45 đến 900 chưa được phân bổ). Hiện tại, OIDS 1 Ném9999 được dành riêng để phân công thủ công; Theuned_oidsTập lệnh chỉ cần xem qua các tiêu đề danh tỷ lệ kèo bóng đá và.datTệp để xem cái nào không xuất hiện. Bạn cũng có thể sử dụngtrùng lặp_oidsKịch bản để kiểm tra sai lầm. (Genbki.pl18603_18735

Khi chọn OIDS cho một bản vá không được dự kiến ​​sẽ được thực hiện ngay lập tức, thực tế tốt nhất là sử dụng một nhóm OID liên tiếp hơn hoặc ít hơn bắt đầu với một số lựa chọn ngẫu nhiên trong phạm vi 8000. Điều này giảm thiểu nguy cơ va chạm OID với các bản vá khác đang được phát triển đồng thời. Để giữ cho phạm vi 8000 Wap9999 miễn phí cho các tỷ lệ kèo bóng đá đích phát triển, sau khi một bản vá đã được cam kết với kho lưu trữ Master Git của nó nên được đánh số lại vào không gian có sẵn bên dưới phạm vi đó. Thông thường, điều này sẽ được thực hiện gần cuối mỗi chu kỳ phát triển, di chuyển tất cả các OID được tiêu thụ bởi các bản vá được thực hiện trong chu kỳ đó cùng một lúc. Tập lệnhRenumber_oids.plcó thể được sử dụng cho tỷ lệ kèo bóng đá đích này. Nếu một bản vá không cam kết được tìm thấy có xung đột OID với một số bản vá được cam kết gần đây,Renumber_oids.plcũng có thể hữu ích cho việc phục hồi từ tình huống đó.

Vì quy ước này có thể đánh số lại tỷ lệ kèo bóng đá OID được gán bởi tỷ lệ kèo bóng đá bản vá, tỷ lệ kèo bóng đá OID được gán bởi một bản vá không nên được coi là ổn định cho đến khi bản vá được đưa vào bản phát hành chính thức. Tuy nhiên, chúng tôi không thay đổi đối tượng được chỉ định thủ công một khi được phát hành, vì điều đó sẽ tạo ra tỷ lệ kèo bóng đá vấn đề tương thích tỷ lệ kèo bóng đá loại.

20000_20005Genbki.plCần gán OID cho tỷ lệ kèo bóng đá nhập danh tỷ lệ kèo bóng đá không có OID được chỉ định thủ công, nó sẽ sử dụng một giá trị trong phạm vi 10000 Wap11999. Bộ đếm OID của máy chủ được đặt thành 12000 khi bắt đầu chạy bootstrap. Do đó, các đối tượng được tạo bởi các lệnh SQL thông thường trong các giai đoạn sau của bootstrap, chẳng hạn như các đối tượng được tạo trong khi chạythông tin_schema.sqltập lệnh, nhận OIDS từ 12000 trở lên.

OID được gán trong quá trình hoạt động cơ sở dữ tỷ lệ kèo bóng đá thông thường bị hạn chế là 16384 trở lên. Điều này đảm bảo rằng phạm vi 10000 Wap16383 miễn phí cho các OID được gán tự động bởiGenbki.plhoặc trong bootstrap. tỷ lệ kèo bóng đá OID được chỉ định tự động này không được coi là ổn định và có thể thay đổi từ cài đặt này sang cài đặt khác.

71.2.3. Tra cứu tham chiếu OID

Về nguyên tắc, các tham chiếu chéo từ hàng danh tỷ lệ kèo bóng đá ban đầu này sang hàng khác có thể được viết chỉ bằng cách viết OID được chỉ định trước của hàng được tham chiếu trong trường tham chiếu. Tuy nhiên, điều đó chống lại chính sách dự án, bởi vì nó dễ bị lỗi, khó đọc và bị vỡ nếu OID mới được chỉ định. Vì thếGenbki.plcung cấp các cơ chế để viết các tài tỷ lệ kèo bóng đá tham khảo tượng trưng thay thế. Các quy tắc như sau:

  • Sử dụng các tài liệu tham khảo tượng trưng được bật trong một cột danh tỷ lệ kèo bóng đá cụ thể bằng cách đính kèmbki_lookup (LookUprule)Theo định nghĩa của cột, trong đóLookUprulelà tên của danh tỷ lệ kèo bóng đá được tham chiếu, ví dụ:PG_PROC. BKI_Lookupcó thể được gắn vào tỷ lệ kèo bóng đá cột loạioid, RegProc, oidvectorhoặcoid []; Trong hai trường hợp sau, nó ngụ ý thực hiện tra cứu trên từng phần tử của mảng.

  • Nó cũng được phép đính kèmBKI_LOOKUP (mã hóa)22434_22581Genbki.pl.

  • Trong một số cột danh tỷ lệ kèo bóng đá, nó được phép các tỷ lệ kèo bóng đá nhập bằng không thay vì tham chiếu hợp lệ. Nếu điều này được cho phép, hãy viếtBKI_LOOKUP_OPTthay vìBKI_Lookup. Sau đó, bạn có thể viết0cho một tỷ lệ kèo bóng đá. (Nếu cột được khai báoRegProc, bạn có thể viết tùy ý-thay vì0.) Ngoại trừ trường hợp đặc biệt này, tất cả các tỷ lệ kèo bóng đá trong ABKI_LookupCột phải là tài tỷ lệ kèo bóng đá tham khảo tượng trưng.Genbki.plSẽ cảnh báo về tỷ lệ kèo bóng đá tên không được công nhận.

  • Hầu hết các loại đối tượng danh tỷ lệ kèo bóng đá được tham chiếu đơn giản bằng tên của chúng. Lưu ý rằng tên loại phải khớp chính xác với tham chiếuPG_TYPEEntry'sTYPNAME; Bạn không được sử dụng bất kỳ bí danh nào nhưSố nguyênchoINT4.

  • Một hàm có thể được biểu diễn bằng của nóproname, nếu đó là duy nhất trong sốpg_proc.dattỷ lệ kèo bóng đá nhập (hoạt động như đầu vào RegProc). Nếu không, hãy viết nó dưới dạngproname (argtypename, argtypename, ...), giống như regprocedure. Tên loại đối số phải được đánh vần chính xác như trongpg_proc.datEntry'sproArgTypesTrường. Không chèn bất kỳ khoảng trống nào.

  • tỷ lệ kèo bóng đá toán tử được đại diện bởi, Viết tên loại chính xác như chúng xuất hiện trongpg_operator.datEntry'sOprleftoprrightTrường. (Viết0Đối với toán hạng bị bỏ qua của một toán tử Unary.)

  • Tên của OpClasses và Opfamilies chỉ là duy nhất trong một phương thức truy cập, vì vậy chúng được đại diện bởiaccess_method_name/object_name.

  • 25099_25236pg_cataloglược đồ.

Genbki.plGiải quyết tất cả các tham chiếu tượng trưng trong khi nó chạy và đặt các OID số đơn giản vào tệp BKI phát ra. Do đó, không cần phụ trợ bootstrap để đối phó với các tài tỷ lệ kèo bóng đá tham khảo tượng trưng.

mong muốn đánh dấu tỷ lệ kèo bóng đá cột tham chiếu OID bằngBKI_LookuphoặcBKI_LOOKUP_OPTNgay cả khi danh tỷ lệ kèo bóng đá không có dữ liệu ban đầu yêu cầu tra cứu. Điều này cho phépGenbki.plĐể ghi lại các mối quan hệ khóa nước ngoài tồn tại trong các danh tỷ lệ kèo bóng đá hệ thống. Thông tin đó được sử dụng trong các bài kiểm tra hồi quy để kiểm tra các tỷ lệ kèo bóng đá không chính xác. Xem thêm macroDeclare_forign_key, Declare_forign_key_opt, Declare_array_forign_keyDeclare_array_forign_key_opt, được sử dụng để tuyên bố tỷ lệ kèo bóng đá mối quan hệ khóa nước ngoài quá phức tạp đối vớiBKI_Lookup(Thông thường, tỷ lệ kèo bóng đá khóa nước ngoài nhiều cột).

71.2.4. Tự động tạo ra tỷ lệ kèo bóng đá loại mảng

Hầu hết các loại dữ tỷ lệ kèo bóng đá vô hướng nên có loại mảng tương ứng (nghĩa là loại mảng varlena tiêu chuẩn có loại phần tử là loại vô hướng và được tham chiếu bởiTyparrayTrường thuộc loại vô hướngPG_TYPEtỷ lệ kèo bóng đá nhập).Genbki.plCó thể tạoPG_TYPEtỷ lệ kèo bóng đá nhập cho loại mảng trong hầu hết các trường hợp.

Để sử dụng cơ sở này, chỉ cần viết mộtmảng_type_oid =nnnnTrường siêu dữ tỷ lệ kèo bóng đá trong loại vô hướngpg_typetỷ lệ kèo bóng đá nhập, chỉ định OID để sử dụng cho loại mảng. Sau đó bạn có thể bỏ quaTyparrayTrường, vì nó sẽ được điền tự động bằng oid đó.

Tên của loại mảng được tạo là tên loại vô hướng với một dấu gạch dưới được chuẩn bị. Các trường khác của tỷ lệ kèo bóng đá khác được lấp đầy từBKI_Array_Default (giá trị)chú thích trongpg_type.hhoặc nếu không có, được sao chép từ loại vô hướng. (Cũng có một trường hợp đặc biệt choTypalign.) Sau đóTypelemTyparrayTrường của hai tỷ lệ kèo bóng đá được đặt thành tham chiếu chéo nhau.

71.2.5. Công thức Chỉnh sửa tệp dữ tỷ lệ kèo bóng đá

Dưới đây là một số gợi ý về các cách dễ nhất để thực hiện các tác vụ chung khi cập nhật các tệp dữ liệu danh tỷ lệ kèo bóng đá.

Thêm cột mới với mặc định vào danh tỷ lệ kèo bóng đá:Thêm cột vào tệp tiêu đề vớiBKI_DEFAULT (giá trị)Chú thích. Tệp dữ tỷ lệ kèo bóng đá chỉ cần được điều chỉnh bằng cách thêm trường vào các hàng hiện tại khi cần giá trị không mặc định.

Thêm giá trị mặc định vào cột hiện có không có:Thêm ABKI_DEFAULTChú thích vào tệp tiêu đề, sau đó chạyLàm cho ReforTat-Dat-FilesĐể xóa các tỷ lệ kèo bóng đá nhập trường hiện đang có.

Xóa một cột, cho dù nó có mặc định hay không:Xóa cột khỏi tiêu đề, sau đó chạyLàm cho Reformat-Dat-FilesĐể loại bỏ các tỷ lệ kèo bóng đá nhập trường không sử dụng.

Thay đổi hoặc xóa giá trị mặc định hiện có:Bạn không thể đơn giản thay đổi tệp tiêu đề, vì điều đó sẽ khiến dữ tỷ lệ kèo bóng đá hiện tại được giải thích không chính xác. Chạy đầu tiênLàm cho mở rộng-DAT-FILESĐể viết lại các tệp dữ tỷ lệ kèo bóng đá với tất cả các giá trị mặc định được chèn một cách rõ ràng, sau đó thay đổi hoặc xóaBKI_DEFAULTchú thích, sau đó chạyLàm cho Reformat-Dat-FilesĐể xóa tỷ lệ kèo bóng đá trường thừa.

Chỉnh sửa số lượng lớn ad-hoc: Reformat_dat_file.plcó thể được điều chỉnh để thực hiện nhiều loại thay đổi số lượng lớn. Tìm kiếm tỷ lệ kèo bóng đá bình luận khối của nó hiển thị nơi có thể chèn mã một lần. Trong ví dụ sau, chúng tôi sẽ củng cố hai trường boolean trongPG_PROCthành một trường char:

  1. Thêm cột mới, với mặc định, vàopg_proc.h:

    + / * Xem các danh tỷ lệ kèo bóng đá prokind_ bên dưới * /
    + char prokind bki_default (f);
  2. Tạo tập lệnh mới dựa trênReformat_dat_file.plĐể chèn tỷ lệ kèo bóng đá giá trị thích hợp trên đường bay:

    - # Tại thời điểm này, chúng ta có hàng đầy đủ trong bộ nhớ dưới dạng băm
    - # và có thể thực hiện bất kỳ hoạt động nào chúng tôi muốn. Như đã viết, nó chỉ
    - # Xóa tỷ lệ kèo bóng đá giá trị mặc định, nhưng tập lệnh này có thể được điều chỉnh thành
    - # Thực hiện chỉnh sửa số lượng lớn.
    + # Thay đổi một lần để di chuyển sang Prokind
    + # Mặc định đã được điền vào ngay bây giờ, vì vậy hãy thay đổi sang khác
    + # Giá trị khi thích hợp
    + if ($ value proisagg eq 't')
    + 
    + $ giá trị prokind = 'a';
    +
  3. Chạy tập lệnh mới:

    $ cd src/bao gồm/danh tỷ lệ kèo bóng đá
    $ perl rewrite_dat_with_prokind.pl pg_proc.dat

    Tại thời điểm nàypg_proc.datCó cả ba cột,Prokind, proisaggProisWindow, mặc dù chúng sẽ chỉ xuất hiện trong tỷ lệ kèo bóng đá hàng mà chúng có tỷ lệ kèo bóng đá giá trị không mặc định.

  4. Xóa tỷ lệ kèo bóng đá cột cũ khỏipg_proc.h:

    - /* Nó có phải là một tổng hợp không? */
    - bool proisagg bki_default (f);
    -
    - /* Nó có phải là một chức năng cửa sổ? */
    - bool proiswindow bki_default (f);
  5. Cuối cùng, chạyLàm cho ReforTat-Dat-FilesĐể loại bỏ các tỷ lệ kèo bóng đá cũ vô dụng khỏipg_proc.dat.

Để biết thêm tỷ lệ kèo bóng đá ví dụ về tỷ lệ kèo bóng đá tập lệnh được sử dụng để chỉnh sửa số lượng lớn, xemConvert_oid2Name.plremove_pg_type_oid_symbols.plĐược đính kèm với tin nhắn này:32707_32787

Gửi hiệu chỉnh

Nếu bạn thấy bất cứ điều gì trong tài tỷ lệ kèo bóng đá không chính xác, không khớp Kinh nghiệm của bạn với tính năng cụ thể hoặc yêu cầu làm rõ thêm, Vui lòng sử dụngMẫu nàyĐể báo cáo vấn đề tài tỷ lệ kèo bóng đá.