PG_RESTORElà một tiện ích để khôi kèo bóng đá euro APostgreSQLCơ sở dữ kèo bóng đá euro từ kho lưu trữ được tạo bởipg_dumpTrong một trong các định dạng không có văn bản. Nó sẽ phát hành các lệnh cần thiết để xây dựng lại cơ sở dữ kèo bóng đá euro cho trạng thái mà nó đã được lưu vào thời điểm nó được lưu. Các tệp lưu trữ cũng cho phéppg_restoreĐể chọn lọc về những gì được khôi phục, hoặc thậm chí để sắp xếp lại kèo bóng đá euro mục trước khi được khôi phục. kèo bóng đá euro tệp lưu trữ được thiết kế để di động trên kèo bóng đá euro kiến trúc.
pg_restorecó thể hoạt động ở hai chế độ. Nếu tên cơ sở dữ kèo bóng đá euro được chỉ định,pg_restoreKết nối với cơ sở dữ kèo bóng đá euro đó và khôi phục nội dung lưu trữ trực tiếp vào cơ sở dữ kèo bóng đá euro. Mặt khác, một tập lệnh chứa các lệnh SQL cần thiết để xây dựng lại cơ sở dữ kèo bóng đá euro được tạo và ghi vào một tệp hoặc đầu ra tiêu chuẩn. Đầu ra tập lệnh này tương đương với định dạng đầu ra văn bản đơn giản củapg_dump12039_12113pg_dumpTùy chọn.
Rõ ràng,pg_restoreKhông thể khôi kèo bóng đá euro thông tin không có trong tệp lưu trữ. Chẳng hạn, nếu kho lưu trữ được thực hiện bằng cách sử dụng"Dump Data AsChènlệnh "Tùy chọn,pg_restoreSẽ không thể tải dữ kèo bóng đá euro bằng cách sử dụngCopycâu lệnh.
pg_restoreChấp nhận kèo bóng đá euro đối số dòng lệnh sau.
Chỉ định vị trí của tệp lưu trữ (hoặc thư mục, để lưu trữ định dạng thư mục) được khôi kèo bóng đá euro. Nếu không được chỉ định, đầu vào tiêu chuẩn được sử dụng.
Chỉ khôi phục dữ kèo bóng đá euro, không phải lược đồ (định nghĩa dữ kèo bóng đá euro). Dữ kèo bóng đá euro bảng, các đối tượng lớn và giá trị trình tự được khôi phục, nếu có trong kho lưu trữ.
Tùy chọn này tương tự, nhưng vì lý do lịch sử không giống với, chỉ định--section = data.
Đối tượng cơ sở dữ kèo bóng đá euro Clean (Drop) trước khi tái tạo chúng. (Trừ khi--if-existđược sử dụng, điều này có thể tạo ra một số thông báo lỗi vô hại, nếu bất kỳ đối tượng nào không có trong cơ sở dữ kèo bóng đá euro đích.)
Tạo cơ sở dữ kèo bóng đá euro trước khi khôi phục vào nó. Nếu như-Cleancũng được chỉ định, thả và tạo lại cơ sở dữ kèo bóng đá euro đích trước khi kết nối với nó.
Khi tùy chọn này được sử dụng, cơ sở dữ kèo bóng đá euro có tên với-Dchỉ được sử dụng để phát hành ban đầucơ sở dữ kèo bóng đá euro thảvàTạo cơ sở dữ kèo bóng đá eurolệnh. Tất cả dữ kèo bóng đá euro được khôi phục vào tên cơ sở dữ kèo bóng đá euro xuất hiện trong kho lưu trữ.
Kết nối với cơ sở dữ kèo bóng đá eurodbnamevà khôi phục trực tiếp vào cơ sở dữ kèo bóng đá euro.
Thoát nếu gặp phải lỗi trong khi gửi các lệnh SQL đến cơ sở dữ kèo bóng đá euro. Mặc định là tiếp tục và hiển thị số lượng lỗi ở cuối Phục hồi.
Chỉ định tệp đầu ra cho tập lệnh được tạo hoặc cho danh sách khi được sử dụng với-L. Sử dụng-Đối với đầu ra tiêu chuẩn, cũng là mặc định.
Chỉ định định dạng của kho lưu trữ. Không cần thiết phải chỉ định định dạng, vìpg_restoresẽ tự động xác định định dạng. Nếu được chỉ định, nó có thể là một trong những điều sau:
Lưu trữ ở định dạng tùy chỉnh củapg_dump.
15806_15843
Lưu trữ là mộttarLưu trữ.
một tùy chọn không dùng nữa hiện đã bị bỏ qua.
Khôi kèo bóng đá euro định nghĩa chỉ có tên chỉ mục. Nhiều chỉ mục có thể được chỉ định với nhiều-ISwitches.
Chạy kèo bóng đá euro phần tốn nhiều thời gian nhất củapg_restore- Những người tải dữ kèo bóng đá euro, tạo chỉ mục hoặc tạo các ràng buộc - sử dụng nhiều công việc đồng thời. Tùy chọn này có thể giảm đáng kể thời gian khôi phục cơ sở dữ kèo bóng đá euro lớn cho máy chủ đang chạy trên máy đa bộ xử lý.
Mỗi công việc là một quy trình hoặc một luồng, tùy thuộc vào hệ điều hành và sử dụng kết nối riêng cho máy chủ.
Giá trị tối ưu cho tùy chọn này phụ thuộc vào thiết lập phần cứng của máy chủ, của máy khách và mạng. kèo bóng đá euro yếu tố bao gồm số lượng lõi CPU và thiết lập đĩa. Một nơi tốt để bắt đầu là số lượng lõi CPU trên máy chủ, nhưng kèo bóng đá euro giá trị lớn hơn mức cũng có thể dẫn đến thời gian khôi phục nhanh hơn trong nhiều trường hợp. Tất nhiên, kèo bóng đá euro giá trị quá cao sẽ dẫn đến giảm hiệu suất vì sự tàn phá.
17478_17792--Single-Transaction.
Liệt kê nội dung của kho lưu trữ. Đầu ra của hoạt động này có thể được sử dụng làm đầu vào cho-LTùy chọn. Lưu ý rằng nếu lọc kèo bóng đá euro công tắc như-Nhoặc-Tđược sử dụng với-L, họ sẽ hạn chế kèo bóng đá euro mục được liệt kê.
Khôi phục chỉ kèo bóng đá euro phần tử lưu trữ được liệt kê trongList-File, và khôi phục chúng theo thứ tự chúng xuất hiện trong tệp. Lưu ý rằng nếu lọc kèo bóng đá euro công tắc như-Nhoặc-Tđược sử dụng với-L, họ sẽ hạn chế hơn nữa kèo bóng đá euro mục được khôi phục.
List-Filethường được tạo bằng cách chỉnh sửa đầu ra của trước trước đó-LHoạt động. kèo bóng đá euro dòng có thể được di chuyển hoặc loại bỏ, và cũng có thể được nhận xét bằng cách đặt một dấu chấm phẩy (;) Khi bắt đầu dòng. Xem bên dưới để biết ví dụ.
Khôi phục chỉ kèo bóng đá euro đối tượng trong lược đồ có tên. Nhiều lược đồ có thể được chỉ định với nhiều-NChuyển đổi. Điều này có thể được kết hợp với-TTùy chọn để khôi kèo bóng đá euro chỉ một bảng cụ thể.
Không xuất các lệnh để đặt quyền sở hữu các đối tượng để phù hợp với cơ sở dữ kèo bóng đá euro gốc. Theo mặc định,pg_restorekèo bóng đá euro vấn đềchủ sở hữu thay đổihoặcĐặt ủy quyền phiênBáo cáo để đặt quyền sở hữu các yếu tố lược đồ được tạo. Các câu lệnh này sẽ thất bại trừ khi kết nối ban đầu với cơ sở dữ kèo bóng đá euro được tạo bởi một siêu người dùng (hoặc cùng một người dùng sở hữu tất cả các đối tượng trong tập lệnh). Với-O, bất kỳ tên người dùng nào cũng có thể được sử dụng cho kết nối ban đầu và người dùng này sẽ sở hữu tất cả kèo bóng đá euro đối tượng đã tạo.
20364_20562-PSwitches.
Tùy chọn này đã lỗi thời nhưng vẫn được chấp nhận để tương thích ngược.
Chỉ khôi phục lược đồ (định nghĩa dữ kèo bóng đá euro), không phải dữ kèo bóng đá euro, ở mức độ mà các mục Lược đồ có mặt trong kho lưu trữ.
Tùy chọn này là nghịch đảo của-Chỉ có dữ kèo bóng đá euro. Nó tương tự, nhưng vì lý do lịch sử không giống với, chỉ định21149_21189.
(Đừng nhầm lẫn điều này với--SchemaTùy chọn, sử dụng từ"Schema"Trong một ý nghĩa khác.)
Chỉ định tên người dùng Superuser sẽ sử dụng khi vô hiệu hóa kèo bóng đá euro kích hoạt. Điều này chỉ có liên quan nếu--bị-Triggersđược sử dụng.
Khôi phục định nghĩa và/hoặc dữ kèo bóng đá euro của bảng được đặt tên. Nhiều bảng có thể được chỉ định với nhiều-TChuyển đổi. Điều này có thể được kết hợp với-NTùy chọn để chỉ định lược đồ.
Khôi kèo bóng đá euro chỉ có tên Trigger. Nhiều trình kích hoạt có thể được chỉ định với nhiều-TSwitches.
Chỉ định chế độ Verbose.
inPG_RESTOREPhiên bản và Thoát.
Ngăn chặn phục hồi kèo bóng đá euro đặc quyền truy cập (lệnh Grant/Revooke).
Thực hiện khôi phục dưới dạng một giao dịch duy nhất (nghĩa là bọc kèo bóng đá euro lệnh phát ra trongBắt đầu/cam kết). Điều này đảm bảo rằng tất cả kèo bóng đá euro lệnh hoàn toàn thành công hoặc không có thay đổi được áp dụng. Tùy chọn này ngụ ý-exit-on-error.
Tùy chọn này chỉ có liên quan khi thực hiện khôi phục chỉ có dữ kèo bóng đá euro. Nó hướng dẫnpg_restoreĐể thực thi các lệnh để tạm thời vô hiệu hóa các kích hoạt trên các bảng đích trong khi dữ kèo bóng đá euro được tải lại. Sử dụng điều này nếu bạn có kiểm tra tính 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 khi tải lại dữ kèo bóng đá euro.
Hiện tại, kèo bóng đá euro lệnh phát ra cho--bị-Triggersphải được thực hiện dưới dạng Superuser. Vì vậy, bạn cũng nên chỉ định tên siêu nhân với-SHoặc, tốt nhất là chạypg_restorenhư mộtPostgreSQLSuperuser.
Sử dụng kèo bóng đá euro lệnh có điều kiện (tức là thêm mộtNếu tồn tạimệnh đề) Khi làm sạch các đối tượng cơ sở dữ kèo bóng đá euro. Tùy chọn này không hợp lệ trừ khi-Cleancũng được chỉ định.
Theo mặc định, dữ kèo bóng đá euro bảng được khôi phục ngay cả khi lệnh tạo cho bảng không thành công (ví dụ: vì nó đã tồn tại). Với tùy chọn này, dữ kèo bóng đá euro cho một bảng như vậy được bỏ qua. Hành vi này rất hữu ích nếu cơ sở dữ kèo bóng đá euro đích đã chứa nội dung bảng mong muốn. Ví dụ: bảng phụ trợ choPostgreSQLTiện ích mở rộng nhưPostgisCó thể đã được tải trong cơ sở dữ kèo bóng đá euro đích; Chỉ định tùy chọn này ngăn dữ kèo bóng đá euro trùng lặp hoặc lỗi thời được tải vào chúng.
Tùy chọn này chỉ có hiệu lực khi khôi phục trực tiếp vào cơ sở dữ kèo bóng đá euro, không phải khi sản xuất đầu ra tập lệnh SQL.
Không xuất kèo bóng đá euro lệnh để khôi phục nhãn bảo mật, ngay cả khi kho lưu trữ chứa chúng.
Không xuất kèo bóng đá euro lệnh để chọn kèo bóng đá euro không gian bảng. Với tùy chọn này, tất cả kèo bóng đá euro đối tượng sẽ được tạo trong bất kỳ không gian bảng nào là mặc định trong quá trình khôi phục.
Chỉ khôi kèo bóng đá euro phần được đặt tên. Tên phần có thể làtiền dữ kèo bóng đá euro, DatahoặcPost-Data25610_25726
Phần dữ kèo bóng đá euro chứa dữ kèo bóng đá euro bảng thực tế cũng như các định nghĩa đối tượng lớn. Các mục sau dữ kèo bóng đá euro bao gồm các định nghĩa về các chỉ mục, trình kích hoạt, quy tắc và các ràng buộc khác với các ràng buộc kiểm tra được xác thực. Các mục trước dữ kèo bóng đá euro bao gồm tất cả các mục định nghĩa dữ kèo bóng đá euro khác.
đầu ra SQL-StandardĐặt ủy quyền phiên26148_26171chủ sở hữu thay đổikèo bóng đá euro lệnh để xác định quyền sở hữu đối tượng. Điều này làm cho bãi rác tương thích tiêu chuẩn hơn, nhưng tùy thuộc vào lịch sử của kèo bóng đá euro đối tượng trong bãi rác, có thể không khôi phục đúng.
Hiển thị trợ giúp vềpg_restoreĐối số dòng lệnh và thoát.
pg_restoreCũng chấp nhận kèo bóng đá euro đối số dòng lệnh sau cho kèo bóng đá euro tham số kết nối:
Chỉ định tên máy chủ của máy mà máy chủ đang chạy. Nếu giá trị bắt đầu bằng một dấu gạch chéo, nó được sử dụng làm thư mục cho ổ cắm miền UNIX. Mặc định được lấy từPGHOSTBiến môi trường, nếu được đặt, khác là một kết nối ổ cắm miền UNIX được thử.
Chỉ định cổng TCP hoặc Tiện ích mở rộng tệp ổ cắm tên miền UNIX cục bộ mà máy chủ đang nghe cho kèo bóng đá euro kết nối. Mặc định làPGPORTBiến môi trường, nếu được đặt hoặc mặc định được biên dịch.
Tên người dùng để kết nối AS.
Không bao giờ đưa ra lời nhắc mật khẩu. Nếu máy chủ yêu cầu xác thực mật khẩu và mật khẩu không có sẵn bằng kèo bóng đá euro phương tiện khác như.pgassTệp, nỗ lực kết nối sẽ không thành công. Tùy chọn này có thể hữu ích trong kèo bóng đá euro công việc và tập lệnh hàng loạt trong đó không có người dùng nào để nhập mật khẩu.
Forcepg_restoreĐể nhắc mật khẩu trước khi kết nối với cơ sở dữ kèo bóng đá euro.
Tùy chọn này không bao giờ cần thiết, vìpg_restoreSẽ tự động nhắc mật khẩu nếu máy chủ yêu cầu xác thực mật khẩu. Tuy nhiên,PG_RESTORESẽ lãng phí một nỗ lực kết nối để tìm ra rằng máy chủ muốn có mật khẩu. Trong một số trường hợp, nó đáng để gõ-WĐể tránh nỗ lực kết nối thêm.
Chỉ định tên vai trò được sử dụng để thực hiện khôi kèo bóng đá euro. Tùy chọn này gây rapg_restoreĐể phát hành AĐặt vai trò rolenameLệnh sau khi kết nối với cơ sở dữ kèo bóng đá euro. Nó rất hữu ích khi người dùng được xác thực (được chỉ định bởi-U) Thiếu kèo bóng đá euro đặc quyền cần thiết bởiPG_RESTORE, nhưng có thể chuyển sang vai trò với kèo bóng đá euro quyền bắt buộc. Một số cài đặt có chính sách chống lại việc đăng nhập trực tiếp với tư cách là một siêu người dùng và việc sử dụng tùy chọn này cho phép khôi phục được thực hiện mà không vi phạm chính sách.
Tham số kết nối mặc định
Tiện ích này, giống như hầu hết kèo bóng đá euro khácPostgreSQLTiện ích, cũng sử dụng kèo bóng đá euro biến môi trường được hỗ trợ bởilibpq(xemPhần 31,14). Tuy nhiên, nó không đọcpgdatabaseKhi tên cơ sở dữ kèo bóng đá euro không được cung cấp.
Khi kết nối cơ sở dữ kèo bóng đá euro trực tiếp được chỉ định bằng30404_30408Tùy chọn,PG_RESTOREthực thi nội bộSQLCâu lệnh. Nếu bạn gặp sự cố đang chạypg_restore30607_30694PSQL. Ngoài ra, mọi cài đặt kết nối mặc định và biến môi trường được sử dụng bởilibpqThư viện Front-End sẽ áp dụng.
Nếu cài đặt của bạn có bất kỳ bổ sung cục bộ nào choTemplate1Cơ sở dữ kèo bóng đá euro, hãy cẩn thận để tải đầu ra củapg_restorethành một cơ sở dữ kèo bóng đá euro thực sự trống; Nếu không, bạn có thể gặp lỗi do các định nghĩa trùng lặp của các đối tượng được thêm vào. Để tạo cơ sở dữ kèo bóng đá euro trống mà không có bất kỳ bổ sung cục bộ nào, hãy sao chép từTemplate0khôngTemplate1, ví dụ:
Tạo cơ sở dữ kèo bóng đá euro FOO với Template Template0;
Những hạn chế củapg_restoređược chi tiết bên dưới.
Khi khôi phục dữ kèo bóng đá euro về bảng tồn tại trước và tùy chọn--bị-Triggersđược sử dụng,pg_restore31801_32047
pg_restoreKhông thể khôi phục kèo bóng đá euro đối tượng lớn một cách chọn lọc; Ví dụ, chỉ những người cho một bảng cụ thể. Nếu một kho lưu trữ chứa kèo bóng đá euro đối tượng lớn, thì tất cả kèo bóng đá euro đối tượng lớn sẽ được khôi phục hoặc không có đối tượng nào trong số chúng nếu chúng được loại trừ thông qua-L, -Thoặc kèo bóng đá euro tùy chọn khác.
32410_32425pg_dumpTài kèo bóng đá euro để biết chi tiết về các giới hạn củapg_dump.
Sau khi được khôi kèo bóng đá euro, thật khôn ngoan khi chạyPhân tíchTrên mỗi bảng được khôi phục để trình tối ưu hóa có số kèo bóng đá euro thống kê hữu ích; nhìn thấyPhần 23.1.3vàPhần 23.1.6Để biết thêm thông tin.
Giả sử chúng tôi đã bỏ một cơ sở dữ kèo bóng đá euro gọi làMyDBthành tệp kết xuất định dạng tùy chỉnh:
$ pg_dump -fc mydb db.dump
Để thả cơ sở dữ kèo bóng đá euro và tạo lại nó từ bãi rác:
$ DROPDB MyDB $ pg_restore -c -d postgres db.dump
Cơ sở dữ kèo bóng đá euro có tên trong-DSwitch có thể là bất kỳ cơ sở dữ kèo bóng đá euro nào tồn tại trong cụm;pg_restoreChỉ sử dụng nó để phát hànhTạo cơ sở dữ kèo bóng đá eurolệnh choMyDB. Với-C, dữ kèo bóng đá euro luôn được khôi phục vào tên cơ sở dữ kèo bóng đá euro xuất hiện trong tệp kết xuất.
Để tải lại kết xuất vào cơ sở dữ kèo bóng đá euro mới gọi làNewDB:
$ createdB -t template0 newDB $ pg_restore -d newdb db.dump
Thông báo chúng tôi không sử dụng-Cvà thay vào đó kết nối trực tiếp với cơ sở dữ kèo bóng đá euro để được khôi phục vào. Cũng lưu ý rằng chúng tôi sao chép cơ sở dữ kèo bóng đá euro mới từTemplate0khôngTemplate1, để đảm bảo ban đầu nó trống.
Để sắp xếp lại các mục cơ sở dữ kèo bóng đá euro, trước tiên cần phải đổ bảng nội dung của kho lưu trữ:
$ pg_restore -l db.dump db.list
34602_34675
34706_35216
35224_35347
kèo bóng đá euro dòng trong tệp có thể được nhận xét, xóa và sắp xếp lại. Ví dụ:
10; 145433 Bảng MAP_RESolutions Postgres ; 2; 145344 Bàn Postgres ; 4; 145359 Bảng NT_header Postgres 6; 145402 Bảng loài_records Postgres ; 8; 145416 Bảng SS_old Postgres
Có thể được sử dụng làm đầu vào choPG_RESTOREVà sẽ chỉ khôi phục kèo bóng đá euro mục 10 và 6, theo thứ tự đó:
$ pg_restore -l db.list db.dump