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 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
Tài tỷ lệ kèo bóng đá này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng một trang chohiện tạiPhiên bản hoặc một trong tỷ lệ kèo bóng đá phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

tỷ lệ kèo bóng đápg_restore

tên

pg_restore-Khôi phục Atỷ lệ kèo bóng đáCơ sở dữ tỷ lệ kèo bóng đá từ tệp lưu trữ được tạo bởi pg_dump

Synopsis

pg_restore[Tùy chọn...]

Mô tả

pg_restorelà một tiện ích cho Khôi phục Atỷ lệ kèo bóng đáCơ sở dữ tỷ lệ kèo bóng đá Từ một kho lưu trữ được tạo bởipg_dumpỞ một trong các định dạng không có văn bản. Nó sẽ ban hành các lệnh cần thiết để tái tạo tất cả các loại, chức năng do người dùng xác định bảng, chỉ mục, tập hợp và toán tử, cũng như dữ tỷ lệ kèo bóng đá trong các bảng.

tỷ lệ kèo bóng đá tệp lưu trữ chứa thông tin chopg_restoreĐể xây dựng lại cơ sở dữ tỷ lệ kèo bóng đá, nhưng cũng cho phéppg_restoređược chọn lọc về những gì được khôi phục, hoặc thậm chí để sắp xếp lại tỷ lệ kèo bóng đá mục trước được khôi phục. tỷ lệ kèo bóng đá tệp lưu trữ được thiết kế để di động trên khắp tỷ lệ kèo bóng đá kiến ​​trúc.

pg_restorecó thể hoạt động làm hai Chế độ: Nếu tên cơ sở dữ tỷ lệ kèo bóng đá được chỉ định, kho lưu trữ được khôi phục trực tiếp vào cơ sở dữ tỷ lệ kèo bóng đá. Nếu không, một kịch bản chứa Các lệnh SQL cần thiết để xây dựng lại cơ sở dữ tỷ lệ kèo bóng đá được tạo (và được ghi vào một tệp hoặc đầu ra tiêu chuẩn), tương tự như các tệp được tạo bởipg_dumpĐồng bằng Định dạng văn bản. Một số tùy chọn kiểm soát đầu ra tập lệnh do đó tương tự nhưpg_dumpTùy chọn.

Rõ ràng,pg_restoreKhông thể Khôi phục thông tin không có trong tệp lưu trữ; vì ví dụ, nếu kho lưu trữ được thực hiện bằng cách sử dụng"Dump Data AsChènS "Tùy chọn,PG_RESTOREsẽ không có thể tải dữ tỷ lệ kèo bóng đá bằng cách sử dụngCopycâu lệnh.

Tùy chọn

PG_RESTOREChấp nhận như sau Đối số dòng lệnh. (tỷ lệ kèo bóng đá biểu mẫu tùy chọn dài chỉ có sẵn trên một số nền tảng.)

Lưu trữ tên

Chỉ định vị trí của tệp lưu trữ để được khôi phục. Nếu không được chỉ định, đầu vào tiêu chuẩn được sử dụng.

-A
-Chỉ có dữ tỷ lệ kèo bóng đá

Chỉ khôi phục dữ tỷ lệ kèo bóng đá, không có lược đồ (định nghĩa).

-C
-Clean

Clean (Drop) Đối tượng cơ sở dữ tỷ lệ kèo bóng đá trước khi tái tạo lại họ.

-C
--Create

Tạo cơ sở dữ tỷ lệ kèo bóng đá trước khi khôi phục vào nó. (Khi điều này Switch xuất hiện, cơ sở dữ tỷ lệ kèo bóng đá được đặt tên với-Dchỉ được sử dụng để phát hành ban đầuTạo cơ sở dữ tỷ lệ kèo bóng đálệnh. Tất cả dữ tỷ lệ kèo bóng đá được khôi phục vào tên cơ sở dữ tỷ lệ kèo bóng đá xuất hiện trong lưu trữ.)

-Ddbname
--dbname =dbname

Kết nối với cơ sở dữ tỷ lệ kèo bóng đádbnamevà khôi phục trực tiếp vào cơ sở dữ tỷ lệ kèo bóng đá. Các đối tượng lớn chỉ có thể được khôi phục bằng cách sử dụng Kết nối cơ sở dữ tỷ lệ kèo bóng đá trực tiếp.

-fFileName
--file =14450_14460

Chỉ định tệp đầu ra cho tập lệnh được tạo hoặc cho Liệt kê khi được sử dụng với-L. Mặc định là đầu ra tiêu chuẩn.

-fĐịnh dạng
-format =Định dạng

Chỉ định định dạng của kho lưu trữ. Nó không cần thiết để Chỉ định định dạng, vìpg_restoresẽ xác định định dạng tự động. Nếu được chỉ định, nó có thể là một trong những tiếp theo:

T

Lưu trữ là mộttarLưu trữ. Sử dụng định dạng lưu trữ này cho phép sắp xếp lại và/hoặc loại trừ các yếu tố lược đồ tại thời điểm Cơ sở dữ tỷ lệ kèo bóng đá được khôi phục. Nó cũng có thể hạn chế Dữ tỷ lệ kèo bóng đá nào được tải lại vào thời điểm khôi phục.

C

Lưu trữ ở định dạng tùy chỉnh củapg_dump. Đây là nhiều nhất Định dạng linh hoạt ở chỗ nó cho phép sắp xếp lại dữ tỷ lệ kèo bóng đá tải cũng như các yếu tố lược đồ. Định dạng này cũng là được nén theo mặc định.

-I

Bỏ qua kiểm tra phiên bản cơ sở dữ tỷ lệ kèo bóng đá.

-Iindex
--index =index

Khôi phục định nghĩa cho được đặt tênindexchỉ.

-L
--List

Liệt kê nội dung của kho lưu trữ. Đầu ra của cái này lệnh có thể được sử dụng với-LTùy chọn hạn chế và sắp xếp lại tỷ lệ kèo bóng đá mục là được khôi phục.

-LList-File
-sử dụng list =List-File

Khôi phục tỷ lệ kèo bóng đá phần tử trongList-FileChỉ và theo thứ tự họ xuất hiện trong tập tin. tỷ lệ kèo bóng đá dòng có thể được di chuyển và cũng có thể là đã nhận xét bằng cách đặt một;AT sự khởi đầu của dòng.

-N
-Orig-Order

Khôi phục tỷ lệ kèo bóng đá mục theo thứ tự kết xuất ban đầu. Theo mặc địnhpg_dumpSẽ đổ tỷ lệ kèo bóng đá mục vào một đơn đặt hàng thuận tiện chopg_dump, sau đó lưu kho lưu trữ trong a thứ tự OID sửa đổi. Tùy chọn này ghi đè OID đặt hàng.

-O
--Lorder

Khôi phục tỷ lệ kèo bóng đá mục theo thứ tự OID. Theo mặc địnhpg_dumpSẽ đổ tỷ lệ kèo bóng đá mục theo thứ tự thuận tiện chopg_dump,, Sau đó lưu kho lưu trữ theo thứ tự OID sửa đổi. Tùy chọn này thực thi thứ tự oid nghiêm ngặt.

-O
--no-own

Ngăn chặn mọi nỗ lực khôi phục đối tượng gốc quyền sở hữu. Các đối tượng sẽ được sở hữu bởi tên người dùng được sử dụng để đính kèm vào cơ sở dữ tỷ lệ kèo bóng đá.

-Ptên chức năng (argtype [,, ...])
--function =tên chức năng (argtype [,, ...])

Chỉ định quy trình hoặc chức năng được khôi phục.

-R
-rearrange

Khôi phục tỷ lệ kèo bóng đá mục theo thứ tự OID sửa đổi. Theo mặc địnhpg_dumpSẽ đổ tỷ lệ kèo bóng đá mục vào một đơn đặt hàng thuận tiện chopg_dump, sau đó lưu kho lưu trữ trong a thứ tự OID sửa đổi. Hầu hết tỷ lệ kèo bóng đá đối tượng sẽ được khôi phục trong oid đặt hàng, nhưng một số điều (ví dụ: tỷ lệ kèo bóng đá quy tắc và chỉ mục) sẽ là được khôi phục vào cuối quá trình không phân biệt Oids. Tùy chọn này là mặc định.

-R
-không kết nối lại

Trong khi khôi phục lưu trữ,pg_restoreThông thường phải kết nối lại đến cơ sở dữ tỷ lệ kèo bóng đá nhiều lần với các tên người dùng khác nhau Đặt quyền sở hữu chính xác của các đối tượng được tạo. Nếu điều này là không mong muốn (ví dụ: vì tương tác thủ công (Mật khẩu) sẽ là cần thiết cho mỗi lần kết nối lại), cái này Tùy chọn ngăn chặnpg_restoreTừ việc đưa ra bất kỳ yêu cầu kết nối lại. (Một kết nối yêu cầu trong khi ở chế độ văn bản đơn giản, không được kết nối với cơ sở dữ tỷ lệ kèo bóng đá, được thực hiện bằng cách đưa raPSQL \ ConnectLệnh.) Tuy nhiên, điều này Tùy chọn là một công cụ khá cùn vì nó tạo rapg_restoreMất tất cả đối tượng Thông tin sở hữu,trừ khiBạn sử dụng-x sử dụng-set-session-authorizationTùy chọn.

-S
-chỉ dành riêng cho

Khôi phục lược đồ (định nghĩa), không có dữ tỷ lệ kèo bóng đá. Sự liên tiếp Các giá trị sẽ được đặt lại.

-Stên người dùng
-superuser =tên người dùng

Chỉ đị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--Disable-Triggersđược sử dụng.

-TBảng
--TABLE =Bảng

Khôi phục lược đồ/dữ tỷ lệ kèo bóng đá choBảngchỉ.

-TTrigger
--Trigger =Trigger

Khôi phục định nghĩa của21744_21753chỉ.

-V
--Verbose

Chỉ định chế độ Verbose.

-x
--no-privileges
--no-acl

Ngăn chặn phục hồi tỷ lệ kèo bóng đá đặc quyền truy cập (Grant/Revoke lệnh).

-x sử dụng-set-session-authorization

Thông thường, nếu khôi phục kho lưu trữ yêu cầu thay đổi Người dùng cơ sở dữ tỷ lệ kèo bóng đá hiện tại (ví dụ: để đặt đối tượng chính xác Sở hữu), một kết nối mới với cơ sở dữ tỷ lệ kèo bóng đá phải đã mở, 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_restore22796_22828Đặt phiên Ủy quyềnlệnh. Điều này có cùng tác dụng, nhưng nó yêu cầu người dùng khôi phục kho lưu trữ là cơ sở dữ tỷ lệ kèo bóng đá Superuser. Tùy chọn này ghi đè hiệu quả-RTùy chọn.

-x vô hiệu hóa máy tính

Tùy chọn này chỉ có liên quan khi thực hiện chỉ có dữ tỷ lệ kèo bóng đá khôi phục. Nó hướng dẫn23426_23438Để thực thi các lệnh đến tạm thời vô hiệu hóa các bộ kích hoạt trên các bảng mục tiêu trong khi Dữ tỷ lệ kèo bóng đá được tải lại. Sử dụng điều này nếu bạn có tham chiếu Kiểm tra tính toàn vẹn 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ữ tỷ lệ kèo bóng đá.

Hiện tại, tỷ lệ kèo bóng đá lệnh phát ra cho--bị-Triggersphả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-S23941_23975và chạypg_restorenhư a Superuser tỷ lệ kèo bóng đá.

PG_RESTOREcũng chấp nhận những điều sau đây Đối số dòng lệnh cho tỷ lệ kèo bóng đá tham số kết nối:

-Hhost
--host =host

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ổng

24924_25132PGPORTBiến môi trường (nếu đặt).

-Utên người dùng

Kết nối với tư cách là người dùng đã cho

-W

25445_25568

Môi trường

PGHOST
PGPORT
PGUSER

25888_25920

Chẩn đoán

Kết nối với cơ sở dữ tỷ lệ kèo bóng đá '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_restoreKhông thể đính kèm đến quy trình máy chủ tỷ lệ kèo bóng đá trên máy chủ được chỉ định và Cổng. Nếu bạn thấy tin nhắn này, hãy đảm bảo rằng máy chủ là chạy trên máy chủ thích hợp và bạn đã chỉ định Cổng thích hợp. Nếu trang web của bạn sử dụng một hệ thống xác thực, đảm bảo rằng bạn đã đạt được xác thực cần thiết Thông tin đăng nhập.

Lưu ý:Khi kết nối cơ sở dữ tỷ lệ kèo bóng đá trực tiếp được chỉ định bằng tùy chọn -D,PG_RESTOREThực thi nội bộ SQL tuyên bố. 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ữ tỷ lệ kèo bóng đá bằng cách sử dụng, ví dụ,PSQL.

ghi chú

Nếu cài đặt của bạn có bất kỳ bổ sung cục bộ nào choTemplate1Cơ sở dữ tỷ lệ kèo bóng đá, hãy cẩn thận để tải đầu ra củapg_restorevào một thực sự trống rỗng cơ sở dữ tỷ lệ kèo bó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ữ tỷ lệ kèo bóng đá 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ữ tỷ lệ kèo bóng đá 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ữ tỷ lệ kèo bóng đá về bảng đã tồn tại trước,PG_RESTOREphát ra các truy vấn để vô hiệu hóa kích hoạt trên bảng người dùng trước khi chèn dữ tỷ lệ kèo bóng đá sau đó phát ra Các truy vấn để kích hoạt lại chúng sau khi dữ tỷ lệ 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_restoreSẽ không Khôi phục tỷ lệ kèo bóng đá đối tượng lớn cho một bảng duy nhất. Nếu một kho lưu trữ chứa tỷ lệ kèo bóng đá đối tượng lớn, sau đó tất cả tỷ lệ kèo bóng đá đối tượng lớn sẽ được khôi phục.

Xem thêmpg_dumpTài tỷ lệ kèo bóng đá để biết chi tiết về các giới hạn củapg_dump.

Ví dụ

Để đổ cơ sở dữ tỷ lệ kèo bóng đá:

$ pg_dump mydb db.out

Để tải lại cơ sở dữ tỷ lệ kèo bóng đá này:

$ cơ sở dữ tỷ lệ kèo bóng đá PSQL -D -f db.out

Để đổ cơ sở dữ tỷ lệ kèo bóng đá được gọi làMyDBĐiều đó chứa tỷ lệ kèo bóng đá đối tượng lớn đếntarFILE:

$ pg_dump -ft -b mydb db.tar

29620_29700NewDB:

$ pg_restore -d newdb db.tar

Để sắp xếp lại các mục cơ sở dữ tỷ lệ kèo bóng đá, trước tiên cần phải đổ Mục lục của kho lưu trữ:

$ 

Tệp danh sách bao gồm một tiêu đề và một dòng cho mỗi Mục, ví dụ:

;
; Lưu trữ được tạo ra vào ngày thứ Sáu 28 22:28:36 2000
;     DBNAME: Chim
;     Mục nhập TOC: 74
;     Nén: 0
;     Phiên bản kết xuất: 1.4-0
;     Định dạng: Tùy chỉnh
;
;
; tỷ lệ kèo bóng đá mục nhập TOC đã chọn:
;
2; 145344 Bàn Postgres
3; 145344 loài ACL
4; 145359 Bảng NT_header Postgres
5; 145359 ACL NT_HEADER
6; 145402 Bảng loài_records Postgres
7; 145402 ACL loài_records
8; 145416 Bảng SS_old Postgres
9; 145416 ACL SS_OLD
10; 145433 Bảng MAP_RESolutions Postgres
11; 145433 ACL MAP_RESolutions
12; 145443 Bảng HS_old Postgres
13; 145443 acl hs_old

30775_30910

tỷ lệ 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

có thể được sử dụng làm đầu vào chopg_restoreVà sẽ chỉ khôi phục tỷ lệ kèo bóng đá mục 10 và 6, theo thứ tự đó.

$ 

Lịch sử

Thepg_restoreTiện ích đầu tiên xuất hiện trong tỷ lệ kèo bóng đá 7.1.

Xem thêm

pg_dump, PG_DUMPALL, PSQL, Hướng dẫn của Quản trị viên tỷ lệ kèo bóng đá