| PostgreSQL: kèo bóng đá hôm nay và ngày mai liệu: | |||
|---|---|---|---|
| prev | UP | Chương 9. kèo bóng đá euro chức năng và toán tử | NEXT |
kèo bóng đá euro chức năng được mô tả trong phần này được sử dụng để kiểm soát và giám sát APostgreSQLCài đặt.
Bảng 9-76Hiển thị kèo bóng đá euro chức năng có sẵn cho kèo bóng đá euro tham số cấu hình thời gian chạy và thay đổi.
Bảng 9-76. Cài đặt cấu hình Chức kèo bóng đá euro
| tên | Return Type | Mô tả |
|---|---|---|
current_sinsting (settings_name[,mất tích_ok]) |
Text | Nhận giá trị hiện tại kèo bóng đá euro cài đặt |
set_config (settings_name,new_value,IS_LOCAL) |
Text | Đặt tham số và trả về giá trị mới |
hàmcurrent_sinstingmang lại giá trị hiện tại kèo bóng đá euro cài đặtsettings_name. Nó tương ứng vớiSQLlệnhshow. Một ví dụ:
chọn current_sinsting ('datestyle');
Nếu không có cài đặt có tênsettings_name,current_sinstingném lỗi trừ khimất tích_okđược cung cấp và làTRUE.
set_configĐặt tham sốsettings_nameđếnnew_value. Nếu nhưIS_LOCALlàTRUE, giá trị mới sẽ chỉ áp dụng cho giao dịch hiện tại. Nếu bạn muốn giá trị mới áp dụng cho phiên hiện tại, hãy sử dụngSaiThay kèo bóng đá euroo đó. Hàm tương ứng với lệnh sqlset. Một ví dụ:
chọn set_config ('log_statement_stats', 'off', false);kèo bóng đá euro chức năng được hiển thị trongBảng 9-77Gửi tín hiệu điều khiển đến kèo bóng đá euro quy trình máy chủ khác. Việc sử dụng kèo bóng đá euro chức năng này được giới hạn ở Superuser theo mặc định nhưng quyền truy cập có thể được cấp cho kèo bóng đá euro chức năng khác vớiGrant, với kèo bóng đá euro ngoại lệ được ghi nhận.
Bảng 9-77. Chức kèo bóng đá euro báo hiệu máy chủ
| tên | Loại trả lại | Mô tả |
|---|---|---|
PG_CANCEL_BACKEND (PID int) |
Boolean | Hủy truy vấn hiện tại kèo bóng đá euro phụ trợ. Điều này cũng được cho phép nếu vai trò gọi là thành viên kèo bóng đá euro vai trò mà phụ trợ đang bị hủy bỏ hoặc vai trò gọi điện đã được cấppg_signal_backendTuy nhiên, chỉ có SuperUsers mới có thể hủy bỏ phụ trợ Superuser. |
pg_reload_conf () |
Boolean | Nguyên nhân kèo bóng đá euro quy trình máy chủ tải lại kèo bóng đá euro tệp cấu hình của họ |
pg_rotate_logfile () |
Boolean | Tập tin nhật ký kèo bóng đá euro máy chủ xoay |
pg_terminate_backend (PID int) |
Boolean | Chấm dứt phụ trợ. Điều này cũng được cho phép nếu vai trò gọi là thành viên kèo bóng đá euro vai trò mà phụ trợ đang bị chấm dứt hoặc vai trò gọi đã được cấppg_signal_backendTuy nhiên, chỉ có siêu người dùng mới có thể chấm dứt kèo bóng đá euro phụ trợ của Superuser. |
Mỗi chức kèo bóng đá euro này trả vềTRUENếu thành công vàSainếu không.
PG_CANCEL_BACKENDvàpg_terminate_backendGửi tín hiệu (Siginthoặcsigtermtương ứng) cho kèo bóng đá euro quy trình phụ trợ được xác định bởi ID quy trình. ID quy trình của một phụ trợ hoạt động có thể được tìm thấy từPIDCột kèo bóng đá europg_stat_activityXem hoặc bằng cách liệt kêPostgresQuy trình trên máy chủ (sử dụngPStrên Unix hoặcTrình quản lý tác vụtrênWindows). Vai trò kèo bóng đá euro một phụ trợ hoạt động có thể được tìm thấy từusenameCột kèo bóng đá europg_stat_activityXem.
PG_RELOAD_CONFGửi ASIGHUPTín hiệu cho máy chủ, khiến kèo bóng đá euro tệp cấu hình được tải lại bởi tất cả kèo bóng đá euro quy trình máy chủ.
PG_ROTATE_LOGFILETín hiệu Trình quản lý tệp đăng nhập để chuyển sang tệp đầu ra mới ngay lập tức. Điều này chỉ hoạt động khi trình thu thập nhật ký tích hợp đang chạy, vì nếu không thì không có quy trình phụ Trình quản lý tệp đăng nhập.
kèo bóng đá euro chức năng được hiển thị trongBảng 9-78Hỗ trợ thực hiện kèo bóng đá euro bản sao lưu trực tuyến. kèo bóng đá euro chức năng này không thể được thực thi trong quá trình phục hồi (ngoại trừ không độc quyềnpg_start_backup, không độc quyềnpg_stop_backup,PG_IS_IN_BACKUP,pg_backup_start_timevàpg_xlog_location_diff).
Bảng 9-78. Chức kèo bóng đá euro điều khiển sao lưu
| tên | Return Type | Mô tả |
|---|---|---|
pg_create_restore_point (tên Text) |
PG_LSN | Tạo một điểm được đặt tên để thực hiện khôi phục (giới hạn cho Superuser theo mặc định, nhưng người dùng khác có thể được cấp thực thi để chạy chức kèo bóng đá euro) |
|
PG_LSN | Nhận vị trí xóa nhật ký giao dịch hiện tại |
|
PG_LSN | Nhận vị trí chèn nhật ký giao dịch hiện tại |
|
PG_LSN | Nhận vị trí ghi nhật ký giao dịch hiện tại |
pg_start_backup (nhãn Text[,nhanh Boolean[,Độc quyền Boolean]]) |
PG_LSN | Chuẩn bị để thực hiện sao lưu trực tuyến (giới hạn cho kèo bóng đá euro siêu người dùng theo mặc định, nhưng người dùng khác có thể được cấp thực thi để chạy chức năng) |
pg_stop_backup () |
PG_LSN | 18563_18705 |
pg_stop_backup (Độc quyền Boolean) |
Setof Record | 18915_19074 |
pg_is_in_backup () |
bool | Đúng nếu sao lưu độc quyền trực tuyến vẫn đang được tiến hành. |
pg_backup_start_time () |
dấu thời gian với múi giờ | Nhận thời gian bắt đầu kèo bóng đá euro bản sao lưu độc quyền trực tuyến đang được tiến hành. |
pg_switch_xlog () |
PG_LSN | Công tắc lực sang tệp nhật ký giao dịch mới (được giới hạn ở Superusers theo mặc định, nhưng người dùng khác có thể được cấp thực thi để chạy chức kèo bóng đá euro) |
pg_xlogfile_name (Vị trí pg_lsn) |
Text | Chuyển đổi chuỗi vị trí nhật ký giao dịch thành tên tệp |
pg_xlogfile_name_offset (Vị trí PG_LSN) |
Text,Số nguyên | Chuyển đổi chuỗi vị trí nhật ký giao dịch thành tên tệp và độ lệch byte thập phân trong tệp |
pg_xlog_location_diff (Vị trí PG_LSN,Vị trí PG_LSN) |
Số | Tính toán chênh lệch giữa hai vị trí nhật ký giao dịch |
pg_start_backupChấp nhận nhãn do người dùng tùy ý cho bản sao lưu. .Backup_Label) Và, nếu có bất kỳ liên kết nào trongpg_tblspc/thư mục, tệp bản đồ không gian bảng (TableSpace_Map) vào thư mục dữ kèo bóng đá euro của cụm cơ sở dữ kèo bóng đá euro, thực hiện điểm kiểm tra và sau đó trả về vị trí nhật ký giao dịch bắt đầu của sao lưu dưới dạng văn bản. Người dùng có thể bỏ qua giá trị kết quả này, nhưng nó được cung cấp trong trường hợp nó hữu ích.pg_stop_backupHàm và nên được ghi kèo bóng đá euroo bản sao lưu bởi người gọi.
postgres =# chọn pg_start_backup ('Label_goes_here');
Có tham số thứ hai tùy chọn loạiBoolean. Nếu nhưTRUE, nó chỉ định thực thipg_start_backupcàng nhanh càng tốt. Điều này buộc một điểm kiểm tra ngay lập tức sẽ gây ra sự tăng đột biến trong kèo bóng đá euro hoạt động I/O, làm chậm mọi truy vấn thực thi đồng thời.
Trong bản sao lưu độc quyền,pg_stop_backupXóa tệp nhãn và, nếu nó tồn tại,TablePace_MapTệp được tạo bởipg_start_backup. Trong bản sao lưu không độc quyền, nội dung kèo bóng đá euroBackup_LabelvàTablespace_Mapđược trả về trong kết quả của hàm và nên được ghi vào kèo bóng đá euro tệp trong bản sao lưu (và không phải trong thư mục dữ liệu). Khi được thực thi trên chínhpg_stop_backupSẽ đợi Wal được lưu trữ, miễn là lưu trữ được bật.
trên chế độ chờpg_stop_backupSẽ quay lại ngay lập tức mà không phải chờ đợi, vì vậy điều quan trọng là phải xác minh rằng tất cả kèo bóng đá euro phân đoạn WAL cần thiết đã được lưu trữ. Nếu hoạt động ghi trên chính là thấp, có thể hữu ích khi chạypg_switch_xlogTrên chính để kích hoạt công tắc phân đoạn.
Khi được thực thi trên chính, chức kèo bóng đá euro cũng tạo ra một tệp lịch sử sao lưu trong khu vực lưu trữ nhật ký ghi lại. Tệp lịch sử bao gồm nhãn được cung cấp chopg_start_backup, kèo bóng đá euro vị trí nhật ký giao dịch bắt đầu và kết thúc cho bản sao lưu và thời gian bắt đầu và kết thúc của bản sao lưu. Giá trị trả về là vị trí nhật ký giao dịch kết thúc của sao lưu (một lần nữa có thể bị bỏ qua).
pg_switch_xlogChuyển sang tệp nhật ký giao dịch tiếp theo, cho phép lưu trữ tệp hiện tại (giả sử bạn đang sử dụng lưu trữ liên tục). Giá trị trả về là vị trí nhật ký giao dịch kết thúc + 1 trong tệp nhật ký giao dịch vừa hoàn thành.pg_switch_xlogKhông có gì và trả về vị trí bắt đầu kèo bóng đá euro tệp nhật ký giao dịch hiện đang được sử dụng.
pg_create_restore_pointTạo bản ghi nhật ký giao dịch được đặt tên có thể được sử dụng làm mục tiêu khôi phục và trả về vị trí nhật ký giao dịch tương ứng. Tên đã cho sau đó có thể được sử dụng vớirecovery_target_nameĐể chỉ định điểm cho sự phục hồi sẽ tiến hành. Tránh tạo nhiều điểm khôi phục có cùng tên, vì khôi phục sẽ dừng ở điểm đầu tiên có tên khớp với mục tiêu khôi phục.
Hiển thị vị trí ghi nhật ký giao dịch hiện tại theo cùng định dạng được sử dụng bởi kèo bóng đá euro chức năng trên. Tương tự,Hiển thị điểm chèn nhật ký giao dịch hiện tại vàHiển thị điểm xả nhật ký giao dịch hiện tại. Điểm chèn là"logic"Kết thúc nhật ký giao dịch bất cứ lúc nào, trong khi vị trí ghi là kết thúc của những gì thực sự đã được viết ra từ bộ đệm bên trong của máy chủ và vị trí Flush là vị trí được đảm bảo được ghi vào lưu trữ bền. Vị trí ghi là kết thúc của những gì có thể được kiểm tra từ bên ngoài máy chủ và thường là những gì bạn muốn nếu bạn quan tâm đến việc lưu trữ kèo bóng đá euro tệp nhật ký giao dịch hoàn chỉnh một phần.
Bạn có thể sử dụngpg_xlogfile_name_offsetĐể trích xuất tên nhật ký giao dịch tương ứng và bù byte từ kết quả kèo bóng đá euro bất kỳ chức năng nào ở trên. Ví dụ:
postgres =# select * từ pg_xlogfile_name_offset (pg_stop_backup ());
Tương tự,pg_xlogfile_nameTrích xuất chỉ tên tệp nhật ký giao dịch. Khi vị trí nhật ký giao dịch đã cho chính xác ở ranh giới tệp nhật ký giao dịch, cả hai chức năng này đều trả về tên kèo bóng đá euro tệp nhật ký giao dịch trước đó.
pg_xlog_location_diffTính toán sự khác biệt về byte giữa hai vị trí nhật ký giao dịch. Nó có thể được sử dụng vớipg_stat_replicationhoặc một số chức kèo bóng đá euro được hiển thị trongBảng 9-78Để có được độ trễ sao chép.
Để biết chi tiết về việc sử dụng đúng kèo bóng đá euro chức năng này, xemPhần 25.3.
kèo bóng đá euro hàm được hiển thị trongBảng 9-79Cung cấp thông tin về trạng thái hiện tại của chế độ chờ. kèo bóng đá euro chức năng này có thể được thực thi cả trong quá trình phục hồi và khi chạy bình thường.
Bảng 9-79. kèo bóng đá euro chức năng thông tin phục hồi
| tên | Loại trả lại | Mô tả |
|---|---|---|
pg_is_in_recovery () |
bool | Đúng nếu phục hồi vẫn đang được tiến hành. |
pg_last_xlog_receive_location () |
PG_LSN | Nhận vị trí nhật ký giao dịch cuối cùng nhận được và đồng bộ hóa với đĩa bằng cách phát trực tuyến sao chép. Trong khi sao chép phát trực tuyến đang được tiến hành, điều này sẽ tăng đơn điệu. |
pg_last_xlog_replay_location () |
PG_LSN | Nhận vị trí nhật ký giao dịch cuối cùng được phát lại trong quá trình phục hồi. Nếu sự phục hồi vẫn đang được tiến hành, điều này sẽ tăng đơn điệu. |
pg_last_xact_replay_timestamp () |
dấu thời gian với múi giờ | Nhận tem thời gian kèo bóng đá euro giao dịch cuối cùng được phát lại trong quá trình phục hồi. Đây là thời gian mà bản ghi WAL cam kết hoặc hủy bỏ cho giao dịch đó được tạo ra trên chính. |
kèo bóng đá euro chức năng được hiển thị trongBảng 9-80Kiểm soát tiến trình phục hồi. kèo bóng đá euro chức năng này chỉ có thể được thực thi trong quá trình phục hồi.
Bảng 9-80. Chức kèo bóng đá euro điều khiển khôi phục
| Tên | Return Type | Mô tả |
|---|---|---|
|
bool | Đúng nếu phục hồi được tạm dừng. |
pg_xlog_replay_pause () |
void | Phục hồi tạm dừng ngay lập tức (giới hạn ở siêu người dùng theo mặc định, nhưng người dùng khác có thể được cấp thực thi để chạy chức kèo bóng đá euro). |
pg_xlog_replay_resume () |
void | 30849_30984 |
Trong khi phục hồi được tạm dừng không có thay đổi cơ sở dữ liệu nào được áp dụng. Nếu ở chế độ chờ nóng, tất cả kèo bóng đá euro truy vấn mới sẽ thấy cùng một ảnh chụp nhanh nhất quán của cơ sở dữ liệu và sẽ không có xung đột truy vấn nào được tạo ra cho đến khi phục hồi được nối lại.
Nếu sao chép phát trực tuyến bị vô hiệu hóa, trạng thái tạm dừng có thể tiếp tục vô thời hạn mà không gặp vấn đề gì. Mặc dù việc sao chép phát trực tuyến đang được tiến hành, WAL Records sẽ tiếp tục được nhận, cuối cùng sẽ lấp đầy không gian đĩa có sẵn, tùy thuộc vào thời gian tạm dừng, tốc độ kèo bóng đá euro thế hệ Wal và không gian đĩa có sẵn.
PostgreSQLCho phép kèo bóng đá euro phiên cơ sở dữ liệu đồng bộ hóa ảnh chụp nhanh của họ. MỘTSnapshotXác định dữ kèo bóng đá euro nào có thể hiển thị cho giao dịch đang sử dụng ảnh chụp nhanh. Ảnh chụp nhanh được đồng bộ hóa là cần thiết khi hai hoặc nhiều phiên cần xem nội dung giống hệt nhau trong cơ sở dữ kèo bóng đá euro.Bắt đầu giao dịchkèo bóng đá euro lệnh, để một phiên thấy kèo bóng đá euro tác động của giao dịch đó và cái kia thì không.
Để giải quyết vấn đề này,PostgreSQLCho phép giao dịch đếnxuấtẢnh chụp nhanh mà nó đang sử dụng. Miễn là giao dịch xuất vẫn mở, kèo bóng đá euro giao dịch khác có thểNhậpẢnh chụp nhanh của nó và do đó được đảm bảo rằng họ thấy chính xác cùng một quan điểm của cơ sở dữ liệu mà giao dịch đầu tiên nhìn thấy. Nhưng lưu ý rằng bất kỳ thay đổi cơ sở dữ liệu nào được thực hiện bởi bất kỳ một trong kèo bóng đá euro giao dịch này vẫn vô hình với kèo bóng đá euro giao dịch khác, như thông thường cho kèo bóng đá euro thay đổi được thực hiện bởi kèo bóng đá euro giao dịch không cam kết.
Ảnh chụp nhanh được xuất vớipg_export_snapshotHàm, hiển thị trongBảng 9-81, và được nhập vớiPostgreSQL: Tàilệnh.
Bảng 9-81. Chức kèo bóng đá euro đồng bộ hóa chụp nhanh
| tên | Return Type | Mô tả |
|---|---|---|
pg_export_snapshot () |
Text | Lưu ảnh chụp nhanh hiện tại và trả về định danh kèo bóng đá euro nó |
hàmpg_export_snapshotLưu ảnh chụp nhanh hiện tại và trả về ATextChuỗi xác định ảnh chụp nhanh. Chuỗi này phải được truyền (bên ngoài cơ sở dữ liệu) cho kèo bóng đá euro máy khách muốn nhập ảnh chụp nhanh.Đọc cam kếtGiao dịch, kể từĐọc lặp lạivà mức độ cô lập cao hơn, kèo bóng đá euro giao dịch sử dụng cùng một ảnh chụp nhanh trong suốt cuộc đời của họ. Khi một giao dịch đã xuất bất kỳ ảnh chụp nhanh nào, nó không thể được chuẩn bị vớiChuẩn bị giao dịch.
xemPostgreSQL: TàiĐể biết chi tiết về cách sử dụng ảnh chụp nhanh đã xuất.
kèo bóng đá euro chức năng được hiển thị trongBảng 9-82là để kiểm soát và tương tác với kèo bóng đá euro tính năng sao chép. Nhìn thấyPhần 26.2.5,Phần 26.2.6vàChương 48Để biết thông tin về kèo bóng đá euro tính năng cơ bản. Việc sử dụng kèo bóng đá euro chức năng cho nguồn gốc sao chép được giới hạn ở siêu người dùng.sao chépĐặc quyền.
Nhiều trong số kèo bóng đá euro chức năng này có kèo bóng đá euro lệnh tương đương trong giao thức sao chép; nhìn thấyPhần 51.3.
kèo bóng đá euro chức năng được mô tả trongPhần 9.26.3,Phần 9.26.4vàPhần 9.26.5cũng có liên quan để sao chép.
Bảng 9-82. Sao chépSQLchức kèo bóng đá euro
| function | Loại trả về | Mô tả |
|---|---|---|
pg_create_physical_replication_slot (slot_name tên[,ngay lập tức_reserve Boolean]) |
(slot_name tên,XLOG_PATION PG_LSN) | Tạo một khe sao chép vật lý mới có tênslot_name. Tham số thứ hai tùy chọn, khiTRUE, Chỉ định rằngLSNĐối với vị trí sao chép này được đặt trước ngay lập tức; nếu không thìLSNđược bảo lưu trên kết nối đầu tiên từ máy khách sao chép phát trực tuyến. Truyền phát kèo bóng đá euro thay đổi từ một khe vật lý chỉ có thể với giao thức sao chép phát trực tuyến-xemPhần 51.3. Hàm này tương ứng với lệnh giao thức sao chépcreated_replication_slot ... vật lý. |
PG_Drop_Replication_Slot (slot_name tên) |
void | Thả khe sao chép vật lý hoặc logic có tênslot_name. Giống như lệnh giao thức sao chépDROP_REPLICATION_SLOT. |
pg_create_logical_replication_slot (slot_name tên,plugin tên) |
(slot_name tên,xlog_poseition PG_LSN) | Tạo khe sao chép logic (giải mã) mới có tênslot_nameSử dụng plugin đầu raplugin. Một cuộc gọi đến chức kèo bóng đá euro này có hiệu ứng tương tự như lệnh giao thức sao chépcreate_Replication_Slot ... logic. |
pg_logical_slot_get_changes (slot_name tên,UPTO_LSN PG_LSN,upto_nchanges int, VariadicTùy chọn Text []) |
(Vị trí PG_LSN,XID XID,Data Text) | Trả về kèo bóng đá euro thay đổi trong kheslot_name, bắt đầu từ điểm mà vì kèo bóng đá euro thay đổi đã được tiêu thụ cuối cùng. Nếu nhưUPTO_LSNvàUPTO_NCHANGESlà null, giải mã logic sẽ tiếp tục cho đến khi kết thúc Wal. Nếu nhưUPTO_LSNkhông phải là null, giải mã sẽ chỉ bao gồm kèo bóng đá euro giao dịch cam kết trước LSN được chỉ định. Nếu nhưupto_nchangeskhông phải là null, giải mã sẽ dừng khi số lượng hàng được tạo ra bằng cách giải mã vượt quá giá trị được chỉ định. Tuy nhiên, lưu ý rằng số lượng hàng thực tế được trả về có thể lớn hơn, vì giới hạn này chỉ được kiểm tra sau khi thêm kèo bóng đá euro hàng được tạo ra khi giải mã từng cam kết giao dịch mới. |
pg_logical_slot_peek_changes (slot_name tên,UPTO_LSN PG_LSN,upto_nchanges int, VariadicTùy chọn Text []) |
(Vị trí Text,XID XID,Dữ kèo bóng đá euro Text) | Hành xử giống nhưpg_logical_slot_get_changes ()Hàm, ngoại trừ việc kèo bóng đá euro thay đổi không được tiêu thụ; nghĩa là, họ sẽ được trả lại một lần nữa trong kèo bóng đá euro cuộc gọi trong tương lai. |
pg_logical_slot_get_binary_changes (slot_name tên,UPTO_LSN PG_LSN,upto_nchanges int, VariadicTùy chọn Text []) |
(Vị trí PG_LSN,XID XID,Data bytea) | Hành xử giống nhưpg_logical_slot_get_changes ()Hàm, ngoại trừ những thay đổi được trả về dưới dạngbytea. |
pg_logical_slot_peek_binary_changes (slot_name tên,UPTO_LSN PG_LSN,upto_nchanges int, VariadicTùy chọn Text []) |
(Vị trí PG_LSN,XID XID,Data bytea) | Hành xử giống nhưpg_logical_slot_get_changes ()Hàm, ngoại trừ kèo bóng đá euro thay đổi được trả về dưới dạngbyteavà những thay đổi đó không được tiêu thụ; nghĩa là, họ sẽ được trả lại một lần nữa trong kèo bóng đá euro cuộc gọi trong tương lai. |
PG_Replication_Origin_Create (node_name Text) |
OID | Tạo nguồn gốc sao chép với tên ngoài đã cho và trả về ID nội bộ được gán cho nó. |
PG_Replication_Origin_Drop (node_name Text) |
void | Xóa nguồn gốc sao chép được tạo trước đó, bao gồm mọi tiến trình phát lại được liên kết. |
PG_Replication_origin_oid (node_name Text) |
OID | Tra cứu nguồn gốc sao chép theo tên và trả về ID nội bộ. Nếu không tìm thấy nguồn gốc sao chép tương ứng, một lỗi sẽ được ném. |
PG_Replication_origin_session_setup (node_name Text) |
void | Đánh dấu phiên hiện tại là phát lại từ nguồn gốc đã cho, cho phép theo dõi tiến trình phát lại. Sử dụngPG_Replication_origin_session_resetĐể hoàn nguyên. Chỉ có thể được sử dụng nếu không có nguồn gốc trước đó được cấu hình. |
PG_Replication_Origin_Session_Reset () |
void | Hủy kèo bóng đá euro hiệu ứng củaPG_Replication_origin_session_setup (). |
PG_Replication_origin_session_is_setup () |
bool | Có nguồn gốc sao chép được cấu hình trong phiên hiện tại? |
Flush bool) |
PG_LSN | Trả về vị trí phát lại cho nguồn gốc sao chép được cấu hình trong phiên hiện tại. Tham sốFlushXác định xem giao dịch cục bộ tương ứng sẽ được đảm bảo đã được chuyển thành đĩa hay không. |
PG_Replication_origin_xact_setup (Origin_lsn PG_LSN,Origin_Timestamp TIMESTAMPTZ) |
void | Đánh dấu giao dịch hiện tại là phát lại một giao dịch đã thực hiện tại đã choLSNvà dấu thời gian. Chỉ có thể được gọi khi nguồn gốc sao chép trước đây đã được cấu hình bằng cách sử dụngPG_Replication_origin_session_setup (). |
PG_Replication_origin_xact_reset () |
void | Hủy kèo bóng đá euro hiệu ứng củaPG_Replication_origin_xact_setup (). |
PG_Replication_Origin_Advance(node_name Text,POS PG_LSN) |
void | Đặt tiến trình sao chép cho nút đã cho thành vị trí đã cho. Điều này chủ yếu là hữu ích để thiết lập vị trí ban đầu hoặc một vị trí mới sau khi cấu hình thay đổi và tương tự. |
PG_Replication_Origin_ProTHER (node_name Text,Flush bool) |
PG_LSN | Trả về vị trí phát lại cho nguồn gốc sao chép đã cho. Tham sốFlushXác định xem giao dịch cục bộ tương ứng sẽ được đảm bảo đã được chuyển thành đĩa hay không. |
pg_logical_emit_message (Giao dịch bool,tiền tố Text,Nội dung Text) |
PG_LSN | phát ra thông báo giải mã logic văn bản. Điều này có thể được sử dụng để chuyển kèo bóng đá euro thông điệp chung cho kèo bóng đá euro plugin giải mã logic thông qua Wal.Giao dịchChỉ định nếu thông báo nên là một phần kèo bóng đá euro giao dịch hiện tại hoặc nếu nó nên được viết ngay lập tức và được giải mã ngay khi giải mã logic đọc bản ghi. Thetiền tốlà tiền tố văn bản được sử dụng bởi kèo bóng đá euro plugin giải mã logic để dễ dàng nhận ra kèo bóng đá euro thông báo thú vị cho chúng. TheNội dunglà văn bản kèo bóng đá euro tin nhắn. |
pg_logical_emit_message (Giao dịch bool,tiền tố Text,Nội dung bytea) |
PG_LSN | phát ra thông báo giải mã logic nhị phân. Điều này có thể được sử dụng để chuyển kèo bóng đá euro thông điệp chung cho kèo bóng đá euro plugin giải mã logic thông qua Wal.Giao dịchChỉ định nếu thông báo nên là một phần kèo bóng đá euro giao dịch hiện tại hoặc nếu nó nên được viết ngay lập tức và được giải mã ngay khi giải mã logic đọc bản ghi. Thetiền tốlà tiền tố văn bản được sử dụng bởi kèo bóng đá euro plugin giải mã logic để dễ dàng nhận ra kèo bóng đá euro thông báo thú vị cho chúng. TheNội dunglà nội dung nhị phân kèo bóng đá euro tin nhắn. |
kèo bóng đá euro chức năng được hiển thị trongBảng 9-83Tính cách sử dụng không gian đĩa của kèo bóng đá euro đối tượng cơ sở dữ liệu.
Bảng 9-83. Chức năng kích thước đối tượng cơ sở dữ kèo bóng đá euro
| tên | Loại trả lại | Mô tả |
|---|---|---|
pg_column_size (Any) |
int | Số byte được sử dụng để lưu trữ một giá trị cụ thể (có thể được nén) |
pg_database_size (oid) |
Bigint | Không gian đĩa được sử dụng bởi cơ sở dữ kèo bóng đá euro với OID được chỉ định |
pg_database_size (tên) |
Bigint | Không gian đĩa được sử dụng bởi cơ sở dữ kèo bóng đá euro với tên được chỉ định |
pg_indexes_size (RegClass) |
Bigint | Tổng dung lượng đĩa được sử dụng bởi kèo bóng đá euro chỉ mục được gắn vào bảng được chỉ định |
pg_relation_size (Mối quan hệ RegClass,Fork Text) |
BIGINT | Không gian đĩa được sử dụng bởi ngã ba được chỉ định ('Main','FSM','VM'hoặc'init') kèo bóng đá euro bảng hoặc chỉ mục được chỉ định |
pg_relation_size (Mối quan hệ RegClass) |
Bigint | tốc ký chopg_relation_size (..., 'chính') |
pg_size_bytes (Text) |
Bigint | Chuyển đổi kích thước ở định dạng có thể đọc được với kèo bóng đá euro đơn vị kích thước thành byte |
pg_size_pretty (Bigint) |
Text | Chuyển đổi kích thước thành byte được biểu thị dưới dạng số nguyên 64 bit thành định dạng có thể đọc được với con người với kèo bóng đá euro đơn vị kích thước |
pg_size_pretty (Số) |
Text | Chuyển đổi kích thước bằng byte được biểu thị dưới dạng giá trị số thành định dạng có thể đọc được của con người với kèo bóng đá euro đơn vị kích thước |
pg_table_size (RegClass) |
Bigint | Không gian đĩa được sử dụng bởi bảng được chỉ định, không bao gồm kèo bóng đá euro chỉ mục (nhưng bao gồm bánh mì nướng, bản đồ không gian trống và bản đồ khả năng hiển thị) |
pg_tablespace_size (oid) |
Bigint | Không gian đĩa được sử dụng bởi không gian bảng với OID được chỉ định |
pg_tablespace_size (tên) |
BIGINT | Không gian đĩa được sử dụng bởi không gian bảng có tên được chỉ định |
pg_total_relation_size (RegClass) |
Bigint | Tổng dung lượng đĩa được sử dụng bởi bảng được chỉ định, bao gồm tất cả kèo bóng đá euro chỉ mục vàPostgreSQL: Tài liệu:Dữ kèo bóng đá euro |
pg_column_sizeHiển thị không gian được sử dụng để lưu trữ bất kỳ giá trị dữ kèo bóng đá euro riêng lẻ nào.
PG_TOTAL_RELATION_SIZEChấp nhận OID hoặc tên của bảng hoặc bảng bánh mì nướng và trả về tổng dung lượng trên đĩa được sử dụng cho bảng đó, bao gồm tất cả kèo bóng đá euro chỉ mục liên quan. Chức năng này tương đương vớipg_table_size + pg_indexes_size.
pg_table_sizeChấp nhận OID hoặc tên của bảng và trả về không gian đĩa cần thiết cho bảng đó, không bao gồm kèo bóng đá euro chỉ mục. (Không gian nướng, bản đồ không gian trống và bản đồ hiển thị được bao gồm.)
pg_indexes_sizeChấp nhận OID hoặc tên của bảng và trả về tổng dung lượng đĩa được sử dụng bởi tất cả kèo bóng đá euro chỉ mục được gắn vào bảng đó.
pg_database_sizevàpg_tablespace_sizeChấp nhận OID hoặc tên của cơ sở dữ kèo bóng đá euro hoặc không gian bảng và trả về tổng dung lượng đĩa được sử dụng trong đó. Sử dụngPG_DATABASE_SIZE, bạn phải cóKết nốiQuyền trên cơ sở dữ kèo bóng đá euro được chỉ định (được cấp theo mặc định). Sử dụngpg_tablespace_size, bạn phải cóTạoQuyền trên không gian bảng được chỉ định, trừ khi đó là không gian bảng mặc định cho cơ sở dữ kèo bóng đá euro hiện tại.
pg_relation_sizeChấp nhận OID hoặc tên của bảng, chỉ mục hoặc bảng bánh mì nướng và trả về kích thước trên đĩa trong byte của một ngã ba của mối quan hệ đó. (Lưu ý rằng đối với hầu hết kèo bóng đá euro mục đích, việc sử dụng kèo bóng đá euro hàm cấp cao hơn sẽ thuận tiện hơnPG_TOTAL_RELATION_SIZE54855_54861pg_table_size, tổng hợp kèo bóng đá euro kích thước của tất cả kèo bóng đá euro dĩa.) Với một đối số, nó trả về kích thước của ngã ba dữ liệu chính của quan hệ. Đối số thứ hai có thể được cung cấp để chỉ định nĩa nào để kiểm tra:
'Main'Trả về kích thước của ngã ba dữ kèo bóng đá euro chính của quan hệ.
'FSM'Trả về kích thước kèo bóng đá euro bản đồ không gian trống (xemPhần 65.3) được liên kết với mối quan hệ.
'VM'Trả về kích thước kèo bóng đá euro bản đồ hiển thị (xemPhần 65.4) được liên kết với mối quan hệ.
'init'Trả về kích thước kèo bóng đá euro ngã ba khởi tạo, nếu có, được liên kết với mối quan hệ.
pg_size_prettycó thể được sử dụng để định dạng kết quả của một trong kèo bóng đá euro chức năng khác theo cách có thể đọc được của con người, sử dụng byte, kb, mb, gb hoặc tb khi thích hợp.
PG_SIZE_BYTEScó thể được sử dụng để có được kích thước theo byte từ một chuỗi ở định dạng có thể đọc được của con người. Đầu vào có thể có đơn vị byte, KB, MB, GB hoặc TB và được phân tích phân tích kèo bóng đá euro trường hợp không nhạy cảm.
Lưu ý:Đơn vị KB, MB, GB và TB được sử dụng bởi kèo bóng đá euro chức năng
pg_size_prettyvàPG_SIZE_BYTES56343_564352= 1048576 byte, v.v.
kèo bóng đá euro hàm trên hoạt động trên kèo bóng đá euro bảng hoặc chỉ mục chấp nhận ARegClassĐối số, chỉ đơn giản là oid kèo bóng đá euro bảng hoặc chỉ mục trongPG_ClassDanh mục kèo bóng đá euro. Tuy nhiên, bạn không cần phải tìm kiếm OID bằng tay, vìRegClassBộ chuyển đổi đầu vào của loại dữ liệu sẽ thực hiện công việc cho bạn. Chỉ cần viết tên bảng được đặt trong kèo bóng đá euro trích dẫn đơn để nó trông giống như một hằng số theo nghĩa đen.SQLTên, chuỗi sẽ được chuyển đổi thành chữ thường trừ khi nó chứa dấu ngoặc kép xung quanh tên bảng.
Nếu OID không đại diện cho một đối tượng hiện có được truyền làm đối số cho một trong kèo bóng đá euro hàm trên, NULL được trả về.
kèo bóng đá euro hàm được hiển thị trongBảng 9-84Hỗ trợ xác định kèo bóng đá euro tệp đĩa cụ thể được liên kết với kèo bóng đá euro đối tượng cơ sở dữ liệu.
Bảng 9-84. Chức năng vị trí đối tượng cơ sở dữ kèo bóng đá euro
| tên | Return Type | Mô tả |
|---|---|---|
pg_relation_filenode (Mối quan hệ RegClass) |
oid | FILENODE Số kèo bóng đá euro quan hệ được chỉ định |
pg_relation_filepath (Mối quan hệ RegClass) |
Text | Tên đường dẫn tệp kèo bóng đá euro quan hệ được chỉ định |
pg_filenode_relation (không gian bảng oid,FILENODE oid) |
RegClass | Tìm mối quan hệ được liên kết với một không gian bảng và FILENode đã cho |
pg_relation_filenodeChấp nhận OID hoặc tên kèo bóng đá euro bảng, chỉ mục, trình tự hoặc bảng bánh mì nướng và trả về"Filenode"Số hiện được gán cho nó. FILENODE là thành phần cơ sở của (kèo bóng đá euro) tên tệp được sử dụng cho quan hệ (xemPhần 65.1Để biết thêm thông tin). Đối với hầu hết kèo bóng đá euro bảng, kết quả giống nhưPG_Class.relfilenode, nhưng đối với kèo bóng đá euro danh mục hệ thống nhất địnhrelfilenodebằng 0 và hàm này phải được sử dụng để có được giá trị chính xác. Hàm trả về null nếu được thông qua một mối quan hệ không có lưu trữ, chẳng hạn như chế độ xem.
PG_RELATION_FILEPATHgiống vớiPG_RELATION_FILENODE, nhưng nó trả về toàn bộ tên đường dẫn tệp (liên quan đến thư mục dữ kèo bóng đá euro của cụm cơ sở dữ kèo bóng đá euroPGDATA) kèo bóng đá euro mối quan hệ.
pg_filenode_relationlà mặt trái kèo bóng đá euroPG_RELATION_FILENODE. Cho a"Không gian bảng"OID và A"Filenode", nó trả về oid quan hệ liên quan. Đối với một bảng trong không gian bảng mặc định của cơ sở dữ kèo bóng đá euro, không gian bảng có thể được chỉ định là 0.
Bảng 9-85Hiển thị kèo bóng đá euro chức năng có sẵn cho kèo bóng đá euro tác vụ bảo trì chỉ mục. kèo bóng đá euro chức năng này không thể được thực hiện trong quá trình phục hồi.
Bảng 9-85. Chức kèo bóng đá euro bảo trì chỉ mục
| tên | Return Type | Mô tả |
|---|---|---|
brin_summarize_new_values (index RegClass) |
Số nguyên | Tóm tắt kèo bóng đá euro phạm vi trang chưa được tóm tắt |
gin_clean_pending_list (index RegClass) |
Bigint | Di chuyển kèo bóng đá euro mục nhập danh sách đang chờ của Gin vào cấu trúc chỉ mục chính |
brin_summarize_new_valuesChấp nhận OID hoặc tên của chỉ mục Brin và kiểm tra chỉ mục để tìm phạm vi trang trong bảng cơ sở hiện không được chỉ mục tóm tắt; Đối với bất kỳ phạm vi nào như vậy, nó tạo ra một bản tóm tắt mới bằng cách quét kèo bóng đá euro trang bảng.
Gin_Clean_Pending_ListChấp nhận OID hoặc tên của chỉ mục GIN và làm sạch danh sách chờ xử lý của chỉ mục được chỉ định bằng cách di chuyển kèo bóng đá euro mục trong đó vào cấu trúc dữ liệu GIN chính với số lượng lớn. Nó trả về số lượng kèo bóng đá euro trang bị xóa khỏi danh sách đang chờ xử lý.FastupDateTùy chọn bị vô hiệu hóa, không làm sạch xảy ra và giá trị trả về là 0, vì chỉ mục không có danh sách đang chờ xử lý. Vui lòng xemPhần 63.4.1vàPhần 63.5Để biết chi tiết về danh sách đang chờ xử lý vàFastupdateTùy chọn.
kèo bóng đá euro chức năng được hiển thị trongBảng 9-86Cung cấp quyền truy cập gốc vào kèo bóng đá euro tệp trên máy lưu trữ máy chủ. Chỉ kèo bóng đá euro tệp trong thư mục cụm cơ sở dữ liệu vàlog_directoryCó thể truy cập. Sử dụng đường dẫn tương đối cho kèo bóng đá euro tệp trong thư mục cụm và đường dẫn khớp vớilog_directoryCài đặt cấu hình cho kèo bóng đá euro tệp nhật ký. Việc sử dụng kèo bóng đá euro chức năng này bị hạn chế đối với siêu người dùng.
Bảng 9-86. Chức kèo bóng đá euro truy cập tệp chung
| tên | Return Type | Mô tả |
|---|---|---|
PG_LS_DIR (dirname Text[,mất tích_ok Boolean,bao gồm_dot_dirs Boolean]) |
Setof Text | Liệt kê nội dung kèo bóng đá euro thư mục. |
PG_READ_FILE (FileName Text[,Offset Bigint,LEGN BIGINT[,mất tích_ok Boolean]]) |
Text | Trả về nội dung kèo bóng đá euro tệp văn bản. |
PG_READ_BINARY_FILE (FileName Text[,Offset Bigint,length Bigint[,mất tích_ok Boolean]]) |
bytea | Trả về nội dung kèo bóng đá euro tệp. |
pg_stat_file (FileName Text[,mất tích_ok Boolean]) |
Record | Trả về thông tin về một tệp. |
Tất cả kèo bóng đá euro chức năng này đều có tùy chọnmất tích_oktham số, chỉ định hành vi khi tệp hoặc thư mục không tồn tại. Nếu nhưTRUE, hàm trả về null (ngoại trừPG_LS_DIR, trả về một tập kết quả trống). Nếu nhưSai, một lỗi được nêu ra. Mặc định làSai.
PG_LS_DIRTrả về tên của tất cả kèo bóng đá euro tệp (và thư mục và kèo bóng đá euro tệp đặc biệt khác) trong thư mục được chỉ định. Thebao gồm_dot_dirsCho biết kèo bóng đá euro"."và".."được bao gồm trong tập kết quả. Mặc định là loại trừ chúng (Sai), nhưng bao gồm chúng có thể hữu ích khimất tích_oklàTRUE, để phân biệt một thư mục trống với thư mục không tồn tại.
PG_READ_FILETrả về một phần kèo bóng đá euro tệp văn bản, bắt đầu từ đã choOffset, trở lại nhiều nhấtlengthbyte (ít hơn nếu kết thúc kèo bóng đá euro tệp trước tiên). Nếu nhưOffsetlà âm, nó liên quan đến phần cuối kèo bóng đá euro tệp. Nếu nhưOffsetvàlengthbị bỏ qua, toàn bộ tệp được trả về. kèo bóng đá euro byte được đọc từ tệp được hiểu là một chuỗi trong mã hóa máy chủ;
PG_READ_BINARY_FILEgiống vớiPG_READ_FILE, ngoại trừ kết quả là AbyteaGiá trị; Theo đó, không có kiểm tra mã hóa được thực hiện.convert_fromHàm, chức kèo bóng đá euro này có thể được sử dụng để đọc một tệp trong một mã hóa được chỉ định:
Chọn Convert_From (pg_read_binary_file ('file_in_utf8.txt'), 'utf8');
PG_STAT_FILE66935_67138BooleanCho biết đó có phải là thư mục không. kèo bóng đá euro cách sử dụng điển hình bao gồm:
Chọn * từ pg_stat_file ('tên tệp');kèo bóng đá euro chức năng được hiển thị trongBảng 9-87Quản lý khóa tư vấn. Để biết chi tiết về việc sử dụng đúng kèo bóng đá euro chức năng này, xemPhần 13.3.5.
Bảng 9-87. Chức kèo bóng đá euro khóa tư vấn
| tên | Return Type | Mô tả |
|---|---|---|
pg_advisory_lock (Key Bigint) |
void | Có được khóa tư vấn cấp phiên độc quyền |
pg_advisory_lock (KEY1 int,key2 int) |
void | Nhận khóa tư vấn cấp phiên độc quyền |
pg_advisory_lock_shared (Key Bigint) |
void | Có được khóa tư vấn cấp phiên chia sẻ |
pg_advisory_lock_shared (KEY1 int,key2 int) |
void | Có được khóa tư vấn cấp phiên chia sẻ |
pg_advisory_unlock (Key Bigint) |
Boolean | Phát hành khóa tư vấn cấp phiên độc quyền |
pg_advisory_unlock (key1 int,key2 int) |
Boolean | Phát hành khóa tư vấn cấp phiên độc quyền |
pg_advisory_unlock_all () |
void | Phát hành tất cả kèo bóng đá euro khóa tư vấn cấp phiên được tổ chức bởi phiên hiện tại |
pg_advisory_unlock_shared (Key Bigint) |
Boolean | Phát hành khóa tư vấn cấp phiên chia sẻ |
pg_advisory_unlock_shared (key1 int,key2 int) |
Boolean | Phát hành khóa tư vấn cấp phiên chia sẻ |
pg_advisory_xact_lock (Key Bigint) |
void | có được khóa tư vấn cấp độ giao dịch độc quyền |
pg_advisory_xact_lock (Key1 int,key2 int) |
void | có được khóa tư vấn cấp giao dịch độc quyền |
pg_advisory_xact_lock_shared (Key Bigint) |
void | Có được khóa tư vấn cấp giao dịch được chia sẻ |
pg_advisory_xact_lock_shared (key1 int,key2 int) |
void | Có được khóa tư vấn cấp giao dịch được chia sẻ |
pg_try_advisory_lock (Key BIGINT) |
Boolean | có được khóa tư vấn cấp phiên độc quyền nếu có |
pg_try_advisory_lock (key1 int,key2 int) |
Boolean | có được khóa tư vấn cấp phiên độc quyền nếu có sẵn |
pg_try_advisory_lock_shared (Key Bigint) |
Boolean | Có được khóa tư vấn cấp phiên chia sẻ nếu có sẵn |
pg_try_advisory_lock_shared (key1 int,key2 int) |
Boolean | có được khóa tư vấn cấp phiên chia sẻ nếu có sẵn |
pg_try_advisory_xact_lock (Key Bigint) |
Boolean | có được khóa tư vấn cấp giao dịch độc quyền nếu có sẵn |
pg_try_advisory_xact_lock (KEY1 int,key2 int) |
Boolean | có được khóa tư vấn cấp giao dịch độc quyền nếu có sẵn |
pg_try_advisory_xact_lock_shared (Key Bigint) |
Boolean | có được khóa tư vấn cấp giao dịch chia sẻ nếu có sẵn |
pg_try_advisory_xact_lock_shared (key1 int,key2 int) |
Boolean | có được khóa tư vấn cấp giao dịch chia sẻ nếu có sẵn |
pg_advisory_lockKhóa tài nguyên do ứng dụng xác định, có thể được xác định bằng một giá trị khóa 64 bit duy nhất hoặc hai giá trị khóa 32 bit (lưu ý rằng hai không gian khóa này không trùng nhau). Nếu một phiên khác đã giữ khóa trên cùng một định danh tài nguyên, chức kèo bóng đá euro này sẽ đợi cho đến khi tài nguyên có sẵn.
pg_advisory_lock_sharedhoạt động giống nhưpg_advisory_lock, ngoại trừ khóa có thể được chia sẻ với kèo bóng đá euro phiên khác yêu cầu khóa chia sẻ. Chỉ có kèo bóng đá euro tủ khóa độc quyền sẽ bị khóa.
pg_try_advisory_locktương tự nhưpg_advisory_lock, ngoại trừ chức kèo bóng đá euro sẽ không chờ khóa có sẵn. Nó sẽ có được khóa ngay lập tức và trả vềTRUEhoặc trả lạiSaiNếu khóa không thể có được ngay lập tức.
pg_try_advisory_lock_sharedhoạt động giống nhưpg_try_advisory_lock, ngoại trừ nó cố gắng có được một khóa được chia sẻ thay vì khóa độc quyền.
pg_advisory_unlocksẽ phát hành khóa tư vấn cấp phiên độc quyền trước đó. Nó trả vềTRUENếu khóa được phát hành thành công. Nếu khóa không được giữ, nó sẽ trở lạiSai, và ngoài ra, cảnh báo SQL sẽ được báo cáo bởi máy chủ.
pg_advisory_unlock_sharedhoạt động giống nhưpg_advisory_unlock, ngoại trừ nó phát hành khóa tư vấn cấp phiên chia sẻ.
pg_advisory_unlock_allsẽ phát hành tất cả kèo bóng đá euro khóa tư vấn cấp phiên được tổ chức bởi phiên hiện tại. .
pg_advisory_xact_lockhoạt động giống nhưpg_advisory_lock, ngoại trừ khóa được tự động phát hành kèo bóng đá euroo cuối giao dịch hiện tại và không thể được phát hành một cách rõ ràng.
pg_advisory_xact_lock_sharedhoạt động giống nhưpg_advisory_lock_shared, ngoại trừ khóa được tự động phát hành kèo bóng đá euroo cuối giao dịch hiện tại và không thể được phát hành một cách rõ ràng.
pg_try_advisory_xact_lockhoạt động giống nhưpg_try_advisory_lock, Ngoại trừ khóa, nếu có được, được tự động phát hành kèo bóng đá euroo cuối giao dịch hiện tại và không thể được phát hành rõ ràng.
pg_try_advisory_xact_lock_sharedhoạt động giống nhưpg_try_advisory_lock_shared, ngoại trừ khóa, nếu có được, được tự động phát hành kèo bóng đá euroo cuối giao dịch hiện tại và không thể được phát hành rõ ràng.
| 77443_77449 | Trang chủ | Tiếp theo |
| Hàm thông tin kèo bóng đá euro | UP | Chức kèo bóng đá euro kích hoạt |