pg_dumplà một tiện ích cho Tiết kiệm Asoi kèo bóng đá truoctranCơ sở dữ soi kèo bóng đá truoctran vào một tập lệnh hoặc một tập tin lưu trữ. Các tệp tập lệnh đang ở Định dạng văn bản đơn giản và chứa các lệnh SQL cần thiết để Tái cấu trúc cơ sở dữ soi kèo bóng đá truoctran về trạng thái vào thời điểm đó đã được lưu. Để khôi phục các tập lệnh này, hãy sử dụngPSQL. Họ có thể được sử dụng để xây dựng lại cơ sở dữ soi kèo bóng đá truoctran ngay cả trên các máy khác và các kiến trúc khác, với một số sửa đổi ngay cả trên Các sản phẩm cơ sở dữ soi kèo bóng đá truoctran SQL.
Hơn nữa, có soi kèo bóng đá truoctran định dạng tệp lưu trữ thay thế mà được sử dụng vớipg_restoreĐể xây dựng lại cơ sở dữ soi kèo bóng đá truoctran và Họ cũng cho phéppg_restorethành chọn lọc về những gì được khôi phục, hoặc thậm chí để sắp xếp lại soi kèo bóng đá truoctran mục trước khi được khôi phục. soi kèo bóng đá truoctran tệp lưu trữ cũng được thiết kế để có thể di động trên soi kèo bóng đá truoctran kiến trúc.
pg_dumpsẽ lưu thông tin cần thiết để tái tạo tất cả các loại do người dùng xác định, Các chức năng, bảng, chỉ mục, tập hợp và toán tử. TRONG Ngoài ra, tất cả các dữ soi kèo bóng đá truoctran được sao chép ở định dạng văn bản để nó có thể dễ dàng sao chép lại, cũng như được nhập vào các công cụ Để chỉnh sửa.
Khi được sử dụng với một trong soi kèo bóng đá truoctran định dạng tệp lưu trữ và kết hợp
vớipg_restore, pg_dumpCung cấp lưu trữ linh hoạt và
cơ chế chuyển giao.pg_dumpCó thể
được sử dụng để sao lưu toàn bộ cơ sở dữ soi kèo bóng đá truoctran, sau đópg_restorecó thể được sử dụng để kiểm tra
Lưu trữ và/hoặc chọn phần nào của cơ sở dữ soi kèo bóng đá truoctran
khôi phục. Định dạng tệp đầu ra linh hoạt nhất là"Tùy chỉnh"Định dạng (-fc). Nó cho phép lựa chọn và sắp xếp lại
Tất cả soi kèo bóng đá truoctran mục được lưu trữ, và được nén theo mặc định. Thetarđịnh dạng (-FT) IS
không được nén và không thể sắp xếp lại dữ soi kèo bóng đá truoctran khi
Tải, nhưng nó khác khá linh hoạt; Hơn nữa, nó có thể là
Thao tác với các công cụ khác nhưtar.
trong khi chạypg_dump, người ta nên Kiểm tra đầu ra cho bất kỳ cảnh báo nào (được in về lỗi tiêu chuẩn), đặc biệt là trong soi kèo bóng đá truoctran hạn chế được liệt kê dưới đây.
13151_13160Làm cho nhất quán sao lưu ngay cả khi cơ sở dữ soi kèo bóng đá truoctran đang được sử dụng đồng thời.pg_dumpKhông chặn người khác Người dùng truy cập cơ sở dữ soi kèo bóng đá truoctran (người đọc hoặc người viết).
soi kèo bóng đá truoctran tùy chọn dòng lệnh sau được sử dụng để kiểm soát Định dạng đầu ra.
Chỉ định tên của cơ sở dữ soi kèo bóng đá truoctran sẽ được bỏ. Nếu điều này không được chỉ định, biến môi trườngpgdatabaseđược sử dụng. Nếu điều đó chưa được đặt, Tên người dùng được chỉ định cho kết nối được sử dụng.
-A-Chỉ có dữ soi kèo bóng đá truoctranChỉ đổ dữ soi kèo bóng đá truoctran, không phải lược đồ (dữ soi kèo bóng đá truoctran Định nghĩa).
Tùy chọn này chỉ có ý nghĩa đối với văn bản đơn giản định dạng. Đối với soi kèo bóng đá truoctran định dạng khác, bạn có thể chỉ định tùy chọn Khi bạn gọiPG_RESTORE.
-B--blobsBao gồm soi kèo bóng đá truoctran đối tượng lớn trong Dump.
-C--CleanCác lệnh đầu ra để làm sạch (thả) đối tượng cơ sở dữ soi kèo bóng đá truoctran trước để (các lệnh cho) tạo chúng.
Tùy chọn này chỉ có ý nghĩa đối với văn bản đơn giản định dạng. Đối với soi kèo bóng đá truoctran định dạng khác, bạn có thể chỉ định tùy chọn Khi bạn gọiPG_RESTORE.
-C--CreateBắt đầu đầu ra bằng lệnh để tạo cơ sở dữ soi kèo bóng đá truoctran chính nó và kết nối lại với cơ sở dữ soi kèo bóng đá truoctran được tạo. (Với a tập lệnh của biểu mẫu này, bạn không quan trọng cơ sở dữ soi kèo bóng đá truoctran nào kết nối với trước khi chạy tập lệnh.)
Tùy chọn này chỉ có ý nghĩa đối với văn bản đơn giản định dạng. Đối với soi kèo bóng đá truoctran định dạng khác, bạn có thể chỉ định tùy chọn Khi bạn gọipg_restore.
-D--InsertsDữ soi kèo bóng đá truoctran kết xuất làChènlệnh (còn hơn làCopy). Điều này sẽ làm Phục hồi rất chậm, nhưng nó làm cho tài soi kèo bóng đá truoctran lưu trữ nhiều hơn di động cho các gói cơ sở dữ soi kèo bóng đá truoctran SQL khác.
-D-Cột tin cậy--Attribution-Inserts16020_16035Chènlệnh với tên cột rõ ràng (16130_16152Bảng(cột, ...) Giá trị ...). Cái này sẽ làm cho việc phục hồi rất chậm, nhưng nó là cần thiết nếu bạn mong muốn sắp xếp lại thứ tự cột.
-fFILE--file =FILEGửi đầu ra đến tệp được chỉ định. Nếu điều này bị bỏ qua, đầu ra tiêu chuẩn được sử dụng.
-fĐịnh dạng-format =Định dạngChọn định dạng của đầu ra.Định dạngcó thể là một trong những tiếp theo:
xuất ra một văn bản đơn giảnSQLTập tin tập lệnh (mặc định)
xuất ra AtarLưu trữ Thích hợp cho đầu vào thànhpg_restore17471_17717
xuất trình lưu trữ tùy chỉnh phù hợp cho đầu vào vàoPG_RESTORE. Đây là định dạng linh hoạt nhất ở chỗ nó cho phép sắp xếp lại của tải dữ soi kèo bóng đá truoctran cũng như các yếu tố lược đồ. Định dạng này cũng được nén theo mặc định.
-IBỏ qua phiên bản không phù hợp giữapg_dumpvà máy chủ cơ sở dữ soi kèo bóng đá truoctran.
pg_dump18447_18681pg_dumpSau đó thất bại, đừng nói rằng bạn không được cảnh báo).
-O--oidsĐịnh danh đối tượng Dump (OIDs) cho mỗi bảng. Sử dụng tùy chọn này Nếu ứng dụng của bạn tham khảo soi kèo bóng đá truoctran cột OID theo một cách nào đó (ví dụ: trong một ràng buộc khóa nước ngoài). Nếu không, tùy chọn này không nên được sử dụng.
-O--Không chủ sở hữuKhông xuất các lệnh để đặt quyền sở hữu đối tượng thành
khớp với cơ sở dữ soi kèo bóng đá truoctran ban đầu. Tiêu biểu,pg_dumpsoi kèo bóng đá truoctran vấn đề (PSQL-Specific)\ ConnectTuyên bố để đặt quyền sở hữu của
soi kèo bóng đá truoctran yếu tố lược đồ. Xem thêm dưới-Rvà-x
sử dụng-set-session-authorization. Lưu ý rằng-Okhông ngăn cản tất cả
kết nối lại với cơ sở dữ soi kèo bóng đá truoctran, chỉ những cái
Được sử dụng riêng để điều chỉnh quyền sở hữu.
19957_20097pg_restore.
-R-Không kết nối lạiCấmPG_DUMPTừ
xuất ra một tập lệnh yêu cầu kết nối lại cho
cơ sở dữ soi kèo bóng đá truoctran trong khi được khôi phục. Phục hồi trung bình
tập lệnh thường phải kết nối lại nhiều lần vì khác nhau
Người dùng để đặt sở hữu ban đầu của các đối tượng. Cái này
Tùy chọn là một công cụ khá cùn vì nó tạo raPG_DUMPMất cái này
Thông tin sở hữu,trừ khiBạn sử dụng-x
sử dụng-set-session-authorizationTùy chọn.
Một lý do có thể tại sao lại kết nối lại trong quá trình khôi phục Có thể không mong muốn là nếu quyền truy cập vào cơ sở dữ soi kèo bóng đá truoctran yêu cầu tương tác thủ công (ví dụ: mật khẩu).
Tùy chọn này chỉ có ý nghĩa đối với văn bản đơn giản định dạng. Đối với soi kèo bóng đá truoctran định dạng khác, bạn có thể chỉ định tùy chọn Khi bạn gọipg_restore.
-S--chỉ làChỉ kết xuất lược đồ (định nghĩa dữ soi kèo bóng đá truoctran), không có dữ soi kèo bóng đá truoctran.
-Stên người dùng-superuser =tên người dùngChỉ định tên người dùng Superuser sẽ sử dụng khi vô hiệu hóa
kích hoạt. Điều này chỉ có liên quan nếu--bị-Triggersđược sử dụng. (Thông thường, nó
Tốt hơn để chỉ định, và sau đó
Bắt đầu tập lệnh kết quả dưới dạng Superuser.)
-TBảng--TABLE =BảngDOMEP Dữ soi kèo bóng đá truoctran choBảngchỉ.
-V--VerboseChỉ định chế độ Verbose. Điều này sẽ gây rapg_dump22545_22601
-x-Không có đặc điểm--no-aclNgăn chặn việc bán phá giá soi kèo bóng đá truoctran đặc quyền truy cập (cấp/thu hồi lệnh).
-x
sử dụng-set-session-authorizationThông thường, nếu tập lệnh (chế độ văn bản đơn giản) được tạo bởipg_dumpPhải thay đổi
Người dùng cơ sở dữ soi kèo bóng đá truoctran hiện tại (ví dụ: để đặt đối tượng chính xác
sở hữu), nó sử dụngPSQL \ Connectlệnh. Lệnh này thực sự mở một kết nối mới,
có thể yêu cầu tương tác thủ công (ví dụ: mật khẩu).
Nếu bạn sử dụng-x
sử dụng-set-session-authorizationTùy chọn, sau đópg_dumpsẽ thay thế
đầu raĐặt phiên
Ủy quyềnlệnh. Điều này có tác dụng tương tự, nhưng
nó yêu cầu người dùng khôi phục cơ sở dữ soi kèo bóng đá truoctran từ
tập lệnh được tạo là một siêu người dùng cơ sở dữ soi kèo bóng đá truoctran. Tùy chọn này
ghi đè hiệu quả-RTùy chọn.
kể từĐặt phiên Ủy quyềnlà một lệnh SQL tiêu chuẩn, trong khi\ ConnectChỉ hoạt động trongPSQL, Tùy chọn này cũng tăng cường tính di động lý thuyết của đầu ra kịch bản.
Tùy chọn này chỉ có ý nghĩa đối với văn bản đơn giản định dạng. Đối với soi kèo bóng đá truoctran định dạng khác, bạn có thể chỉ định tùy chọn Khi bạn gọipg_restore.
-x vô hiệu hóa-Triggers24669_24689Tùy chọn này chỉ có liên quan khi tạo dữ soi kèo bóng đá truoctran chỉ bãi rác. Nó hướng dẫnpg_dumpĐể bao gồm các lệnh để vô hiệu hóa các kích hoạt tạm thời trên Bảng mục tiêu trong khi dữ soi kèo bóng đá truoctran được tải lại. Sử dụng cái này nếu bạn có kiểm tra toàn vẹn tham chiếu hoặc các kích hoạt khác trên các bảng mà bạn không muốn gọi trong dữ soi kèo bóng đá truoctran Tải lại.
Hiện tại, soi kèo bóng đá truoctran lệnh phát ra chophải được thực hiện như
Superuser. Vì vậy, bạn cũng nên chỉ định một tên siêu nhân
với-Shoặc tốt nhất là chỉ địnhvà sau đó cẩn thận để bắt đầu tập lệnh kết quả dưới dạng
Superuser. Nếu bạn không đưa ra tùy chọn, toàn bộ tập lệnh
Phải được chạy dưới dạng Superuser.
Tùy chọn này chỉ có ý nghĩa đối với văn bản đơn giản định dạng. Đối với soi kèo bóng đá truoctran định dạng khác, bạn có thể chỉ định tùy chọn Khi bạn gọipg_restore.
-z0..9--compress =0..926021_26184
Tùy chọn dòng lệnh sau đây kiểm soát cơ sở dữ soi kèo bóng đá truoctran tham số kết nối.
-Hmáy chủ--host =máy chủChỉ định tên máy chủ của máy Máy chủ đang chạy. Nếu máy chủ bắt đầu bằng một dấu gạch chéo, nó được sử dụng Là thư mục cho ổ cắm miền UNIX.
-PCổng--Port =CổngChỉ định cổng TCP/IP Internet hoặc miền UNIX cục bộ tiện ích mở rộng tệp ổ cắm mà máy chủ đang nghe kết nối. Số cổng mặc định là 5432 hoặc giá trị củaPGPORTBiến môi trường (nếu đặt).
-Utên người dùngKết nối với tư cách là người dùng đã cho
-WBuộc nhắc mật khẩu. Điều này sẽ xảy ra tự động nếu máy chủ yêu cầu mật khẩu xác thực.
Biểu mẫu tùy chọn dài chỉ có sẵn trên một số nền tảng.
Kết nối với cơ sở dữ soi kèo bóng đá truoctran 'Template1' không thành công.
ConnectDbStart () - Connect () không thành công: Không có tệp hoặc thư mục đó
Là người bưu điện đang chạy cục bộ
và chấp nhận các kết nối trên ổ cắm unix '/tmp/.s.pgsql.5432'?
pg_dumpKhông thể gắn vào Máy chủ soi kèo bóng đá truoctran trên máy chủ và cổng được chỉ định. Nếu bạn Xem thông báo này, đảm bảo rằng máy chủ đang chạy trên Máy chủ thích hợp và bạn đã chỉ định cổng thích hợp.
Lưu ý: pg_dumpthực thi nội bộChọnCâu lệnh. Nếu bạn gặp sự cố đang chạyPG_DUMP, đảm bảo bạn có thể Chọn thông tin từ cơ sở dữ soi kèo bóng đá truoctran bằng cách sử dụng, ví dụ,PSQL.
Nếu cài đặt của bạn có bất kỳ bổ sung cục bộ nào cho Template1 cơ sở dữ soi kèo bóng đá truoctran, hãy cẩn thận để khôi phục đầu ra củaPG_DUMPthành một cơ sở dữ soi kèo bóng đá truoctran thực sự trống; Nếu không, bạn có khả năng gặp lỗi do trùng lặp Định nghĩa của các đối tượng được thêm vào. Để tạo cơ sở dữ soi kèo bóng đá truoctran trống Không có bất kỳ bổ sung cục bộ nào, hãy sao chép từ Template0 không phải Template1, Ví dụ:
Tạo cơ sở dữ soi kèo bóng đá truoctran foo với TemplateS0;
PG_DUMPcó một số ít Hạn chế:
Khi bán một bảng hoặc là văn bản đơn giản,pg_dumpKhông xử lý soi kèo bóng đá truoctran đối tượng lớn. soi kèo bóng đá truoctran vật thể lớn phải được đổ toàn bộ bằng cách sử dụng một trong những soi kèo bóng đá truoctran định dạng lưu trữ nhị phân.
Khi chỉ thực hiện dữ soi kèo bóng đá truoctran,PG_DUMP30415_30673
Thành viên của Lưu trữ TAR được giới hạn ở kích thước dưới 8 GB. (Đây là một giới hạn vốn có của định dạng tệp tar.) Do đó, định dạng này không thể được sử dụng nếu văn bản Đại diện của một bảng vượt quá kích thước đó. Tổng kích thước của một Lưu trữ tar và bất kỳ định dạng đầu ra nào khác không bị giới hạn, ngoại trừ có thể bởi hệ điều hành.
Để đổ cơ sở dữ soi kèo bóng đá truoctran:
$ pg_dump mydb db.out
Để tải lại cơ sở dữ soi kèo bóng đá truoctran này:
$ cơ sở dữ soi kèo bóng đá truoctran PSQL -D -f db.out
Để đổ cơ sở dữ soi kèo bóng đá truoctran được gọi làMyDBĐiều đó chứa soi kèo bóng đá truoctran đối tượng lớn đếntarTệp:
$ pg_dump -ft -b mydb db.tar
Để tải lại cơ sở dữ soi kèo bóng đá truoctran này (với các đối tượng lớn) Cơ sở dữ soi kèo bóng đá truoctran được gọiNewDB:
$ pg_restore -d newdb db.tar