pg_restore10708_10712tùy cách đọc kèo bóng đá kết nối...] [Tùy cách đọc kèo bóng đá...] [FileName]
PG_RESTORElà một tiện ích để khôi phục APostgreSQLCơ sở dữ cách đọc kèo bóng đá từ kho lưu trữ được tạo bởipg_dump11170_11354pg_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 cách đọc kèo bóng đá mục trước khi được khôi phục. cách đọc kèo bóng đá tệp lưu trữ được thiết kế để di động trên cách đọc kèo bóng đá kiến trúc.
pg_restorecó thể hoạt động ở hai chế độ. Nếu tên cơ sở dữ cách đọc kèo bóng đá được chỉ định,pg_restoreKết nối với cơ sở dữ cách đọc kèo bóng đá đó và khôi phục nội dung lưu trữ trực tiếp vào cơ sở dữ cách đọc kèo bóng đá. 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ữ cách đọc kèo bóng đá đượ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_dump. Do đó, một số tùy cách đọc kèo bóng đá kiểm soát đầu ra tương tự nhưpg_dumpTùy cách đọc kèo bóng đá.
Rõ ràng,pg_restoreKhông thể khôi phục 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 cách đọc kèo bóng đá,pg_restoreSẽ không thể tải dữ cách đọc kèo bóng đá bằng cách sử dụngCopycâu lệnh.
pg_restoreChấp nhận cách đọc kèo bóng đá đố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 phục. Nếu không được chỉ định, đầu vào tiêu chuẩn được sử dụng.
Chỉ khôi phục dữ cách đọc kèo bóng đá, không phải lược đồ (định nghĩa dữ cách đọc kèo bóng đá). Dữ cách đọc kèo bóng đá 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 cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá đích.)
Tạo cơ sở dữ cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá đí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ữ cách đọc kèo bóng đá có tên với-Dchỉ được sử dụng để phát hành ban đầucơ sở dữ cách đọc kèo bóng đá thảvàTạo cơ sở dữ cách đọc kèo bóng đálệnh. Tất cả dữ cách đọc kèo bóng đá được khôi phục vào tên cơ sở dữ cách đọc kèo bóng đá xuất hiện trong kho lưu trữ.
Kết nối với cơ sở dữ cách đọc kèo bóng đádbnamevà khôi phục trực tiếp vào cơ sở dữ cách đọc kèo bóng đá. Thedbnamecó thể là mộtchuỗi kết nối. Nếu vậy, cách đọc kèo bóng đá tham số chuỗi kết nối sẽ ghi đè bất kỳ tùy chọn dòng lệnh xung đột nào.
Thoát nếu gặp phải lỗi trong khi gửi các lệnh SQL đến cơ sở dữ cách đọc kèo bóng đá. 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.
Lưu trữ là Lưu trữ thư mục.
Lưu trữ là mộttarLưu trữ.
Khôi phục đị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.
16692_16731PG_RESTORE- Những người tải dữ cách đọc kèo bóng đá, 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ữ cách đọc kèo bóng đá 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. cách đọc kèo bóng đá 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 cách đọc kèo bóng đá 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, cách đọc kèo bóng đá giá trị quá cao sẽ dẫn đến giảm hiệu suất vì sự tàn phá.
Chỉ các định dạng lưu trữ thư mục và tùy chỉnh mới được hỗ trợ với tùy chọn này. Đầu vào phải là một tệp hoặc thư mục thông thường (ví dụ, không phải là một đường ống). Tùy chọn này bị bỏ qua khi phát ra tập lệnh thay vì kết nối trực tiếp với máy chủ cơ sở dữ cách đọc kèo bóng đá. Ngoài ra, nhiều công việc không thể được sử dụng cùng với tùy chọn--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 cách đọc kèo bóng đá công tắc như-Nhoặc-Tđược sử dụng với-L, họ sẽ hạn chế cách đọc kèo bóng đá mục được liệt kê.
Khôi phục chỉ cách đọc kèo bóng đá 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 cách đọc kèo bóng đá công tắc như-Nhoặc-Tđược sử dụng với-L, họ sẽ hạn chế hơn nữa cách đọc kèo bóng đá mục được khôi phục.
List-File18862_18921-LHoạt động. cách đọc kèo bóng đá 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ỉ cách đọc kèo bóng đá đố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 cách đọc kèo bóng đá để khôi phục 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ữ cách đọc kèo bóng đá gốc. Theo mặc định,pg_restorecách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá đượ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ả cách đọc kèo bóng đá đối tượng đã tạo.
Khôi phục chức năng được đặt tên. Hãy cẩn thận để đánh vần tên chức năng và cách đọc kèo bóng đá đối số chính xác khi chúng xuất hiện trong bảng nội dung của tệp kết xuất. Nhiều chức năng có thể được chỉ định với nhiều-PSwitches.
Tùy cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá), không phải dữ cách đọc kèo bóng đá, ở mức độ mà các mục Lược đồ có trong kho lưu trữ.
Tùy cách đọc kèo bóng đá này là nghịch đảo của-Chỉ có dữ cách đọc kèo bóng đá. Nó tương tự, nhưng vì lý do lịch sử không giống với, chỉ định21216_21256.
(Đừng nhầm lẫn điều này với--SchemaTùy cách đọc kèo bóng đá, sử dụng từ"lược đồ"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 cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá 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 cách đọc kèo bóng đá để chỉ định lược đồ.
Chỉ khôi phục kích hoạt có tên. Nhiều trình kích hoạt có thể được chỉ định với nhiều-TSwitches.
Chỉ định chế độ Verbose.
In Thepg_restorePhiên bản và Thoát.
Ngăn chặn phục hồi cách đọc kèo bóng đá đặ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à bao bọc cách đọc kèo bóng đá lệnh phát ra trongbắt đầu/cam kết). Điều này đảm bảo rằng tất cả cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá. 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ữ cách đọc kèo bóng đá đượ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ữ cách đọc kèo bóng đá.
Hiện tại, cách đọc kèo bóng đá lệnh phát ra cho--Disable-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.
Tùy cách đọc kèo bóng đá này chỉ có liên quan khi khôi phục nội dung của bảng có bảo mật hàng. Theo mặc định,pg_restoresẽ đặtRow_SecurityTẮT, để đảm bảo rằng tất cả dữ cách đọc kèo bóng đá được khôi phục vào bảng. Nếu người dùng không có đủ các đặc quyền để bỏ qua bảo mật hàng, thì một lỗi sẽ được ném. Tham số này hướng dẫnpg_restoređể đặtRow_SecurityThay vào đó, cho phép người dùng cố gắng khôi phục nội dung của bảng với bảo mật hàng được bật. Điều này vẫn có thể thất bại nếu người dùng không có quyền chèn cách đọc kèo bóng đá hàng từ bãi vào bảng.
Lưu ý rằng tùy cách đọc kèo bóng đá này hiện cũng yêu cầu kết xuất trongChènĐịnh dạng, nhưSao chép từKhông hỗ trợ bảo mật hàng.
Sử dụng cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá. Tùy chọn này không hợp lệ trừ khi-Cleancũng được chỉ định.
Theo mặc định, dữ cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá đí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ữ cách đọc kèo bóng đá đích; Chỉ định tùy chọn này ngăn dữ cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá, không phải khi sản xuất đầu ra tập lệnh SQL.
Không xuất cách đọc kèo bóng đá 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 cách đọc kèo bóng đá lệnh để chọn cách đọc kèo bóng đá không gian bảng. Với tùy chọn này, tất cả cách đọc kèo bóng đá đố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 phục phần được đặt tên. Tên phần có thể làtiền dữ cách đọc kèo bóng đá, DatahoặcPost-Data. Tùy chọn này có thể được chỉ định nhiều lần để chọn nhiều phần. Mặc định là khôi phục tất cả cách đọc kèo bóng đá phần.
Phần dữ cách đọc kèo bóng đá chứa dữ cách đọc kèo bóng đá bảng thực tế cũng như các định nghĩa đối tượng lớn. Các mục sau dữ cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá bao gồm tất cả các mục định nghĩa dữ cách đọc kèo bóng đá khác.
đầu ra SQL-StandardĐặt ủy quyền phiênlệnh thay vìchủ sở hữu thay đổicách đọc kèo bóng đá 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 cách đọc kèo bóng đá đố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 cách đọc kèo bóng đá đối số dòng lệnh sau cho cách đọc kèo bóng đá 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 phần mở rộng tệp ổ cắm tên miền UNIX cục bộ mà máy chủ đang nghe cho cách đọc kèo bóng đá 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 cách đọc kèo bóng đá 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 cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá.
Tùy cách đọc kèo bóng đá 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 phục. Tùy cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá. Nó rất hữu ích khi người dùng được xác thực (được chỉ định bởi-U) Thiếu cách đọc kèo bóng đá đặc quyền cần thiết bởipg_restore, nhưng có thể chuyển sang vai trò với cách đọc kèo bóng đá 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à Superuser 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 cách đọc kèo bóng đá khácPostgreSQLTiện ích, cũng sử dụng cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá không được cung cấp.
Khi kết nối cơ sở dữ cách đọc kèo bóng đá trực tiếp được chỉ định bằng-DTùy cách đọc kèo bóng đá,pg_restorethực thi nội bộSQLCâu lệnh. Nếu bạn gặp sự cố đang chạyPG_RESTORE, Đảm bảo bạn có thể chọn thông tin từ cơ sở dữ cách đọc kèo bóng đá bằng cách sử dụng, ví dụ,PSQL. 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ữ cách đọc kèo bóng đá, hãy cẩn thận để tải đầu ra củapg_restorethành một cơ sở dữ cách đọc kèo bóng đá 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ữ cách đọc kèo bóng đá trống mà không có bất kỳ bổ sung cục bộ nào, hãy sao chép từTemplate0khôngTemplate1Ví dụ:
Tạo cơ sở dữ cách đọc kèo bóng đá foo với TemplateS0;
Những hạn chế củapg_restoređược chi tiết bên dưới.
Khi khôi phục dữ cách đọc kèo bóng đá về bảng đã tồn tại trước và tùy chọn32791_32811được sử dụng,pg_restorephát ra các lệnh để vô hiệu hóa các kích hoạt trên các bảng người dùng trước khi chèn dữ cách đọc kèo bóng đá, sau đó phát ra các lệnh để kích hoạt lại chúng sau khi dữ cách đọc kèo bóng đá được chèn. Nếu khôi phục được dừng ở giữa, các danh mục hệ thống có thể bị bỏ lại ở trạng thái sai.
PG_RESTOREKhông thể khôi phục cách đọc kèo bóng đá đố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 cách đọc kèo bóng đá đối tượng lớn, thì tất cả cách đọc kèo bóng đá đố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 cách đọc kèo bóng đá tùy chọn khác.
Xem thêmpg_dumpTài cách đọc kèo bóng đá để biết chi tiết về các hạn chế củapg_dump.
Sau khi được khôi phục, 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ố cách đọc kèo bóng đá 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.
34036_34078MyDBthành tệp kết xuất định dạng tùy chỉnh:
$ pg_dump -fc mydb db.dump
Để thả cơ sở dữ cách đọc kèo bóng đá và tạo lại nó từ bãi rác:
$ DROPDB MyDB $ pg_restore -c -d postgres db.dump
Cơ sở dữ cách đọc kèo bóng đá có tên trong-DSwitch có thể là bất kỳ cơ sở dữ cách đọc kèo bóng đá nào tồn tại trong cụm;pg_restoreChỉ sử dụng nó để phát hànhTạo cơ sở dữ cách đọc kèo bóng đá34724_34739MyDB34766_34775-C, dữ cách đọc kèo bóng đá luôn được khôi phục vào tên cơ sở dữ cách đọc kèo bóng đá xuất hiện trong tệp kết xuất.
Để tải lại kết xuất vào cơ sở dữ cách đọc kèo bóng đá mới được 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ữ cách đọc kèo bóng đá để được khôi phục vào. Cũng lưu ý rằng chúng tôi sao chép cơ sở dữ cách đọc kèo bóng đá mới từTemplate0khôngTemplate1, để đảm bảo nó trống ban đầu.
Để sắp xếp lại các mục cơ sở dữ cách đọc kèo bóng đá, 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
35668_35741
35772_36282
Semicolons bắt đầu nhận xét và cách đọc kèo bóng đá số ở đầu dòng tham khảo ID lưu trữ nội bộ được gán cho mỗi mục.
cách đọc kèo bóng đá 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
36723_36751PG_RESTOREVà sẽ chỉ khôi phục cách đọc kèo bóng đá mục 10 và 6, theo thứ tự đó:
$ 36924_36955