Mô tả

Copydi chuyển dữ kèo bóng đá pháp giữaPostgreSQLBảng và tệp hệ thống tệp tiêu chuẩn.kèo bóng đá pháp vàokèo bóng đá pháp nội dung của bảngđếnmột tệp, trong khikèo bóng đá pháp từBản kèo bóng đá pháp dữ liệutừMột tệp vào bảng (nối dữ kèo bóng đá pháp vào bất cứ thứ gì trong bảng rồi).kèo bóng đá pháp vàocũng có thể kèo bóng đá pháp kết quả của AChọnTruy vấn.

Nếu một danh sách cột được chỉ định,kèo bóng đá pháp vàoChỉ kèo bóng đá pháp dữ liệu trong các cột được chỉ định vào tệp. Vìkèo bóng đá pháp từ, mỗi trường trong tệp được chèn, theo thứ tự, vào cột được chỉ định. kèo bóng đá pháp cột bảng không được chỉ định trongkèo bóng đá pháp từDanh sách cột sẽ nhận được kèo bóng đá pháp giá trị mặc định của họ.

CopyVới tên tệp hướng dẫnPostgreSQLMáy chủ để đọc trực tiếp hoặc ghi vào một tệp. Tệp phải được truy cập bởiPostgreSQLNgười dùng (ID người dùng mà máy chủ chạy như) và tên phải được chỉ định từ quan điểm của máy chủ. KhiChương trìnhđược chỉ định, máy chủ thực thi lệnh đã cho và đọc từ đầu ra tiêu chuẩn của chương trình hoặc ghi vào đầu vào tiêu chuẩn của chương trình. Lệnh phải được chỉ định từ quan điểm của máy chủ và được thực thi bởiPostgreSQLNgười dùng. Khistdinhoặcstdoutđược chỉ định, dữ kèo bóng đá pháp được truyền qua kết nối giữa máy khách và máy chủ.

mỗi phụ trợ chạyCopysẽ báo cáo tiến trình của nó trongPG_STAT_PROTERS_COPYXem. Nhìn thấyPhần 27.4.3Để biết chi tiết.

Theo mặc định,Copysẽ thất bại nếu nó gặp lỗi trong quá trình xử lý. Đối với kèo bóng đá pháp trường hợp sử dụng trong đó nỗ lực tốt nhất trong việc tải toàn bộ tệp làon_errormệnh đề có thể được sử dụng để chỉ định một số hành vi khác.

tham số

đầu ra

Khi hoàn thành thành công, ACopylệnh trả về thẻ lệnh của biểu mẫu

CopyĐếm

TheĐếmlà số lượng hàng được kèo bóng đá pháp.

ghi chú

kèo bóng đá pháp vàoChỉ có thể được sử dụng với các bảng đơn giản, không phải chế độ xem và không kèo bóng đá pháp các hàng từ bảng con hoặc phân vùng con. Ví dụ,CopyBảngđếnkèo bóng đá pháp các hàng giống nhưChọn * chỉ từBảng. Cú phápkèo bóng đá pháp (chọn * từBảng) đến ...Có thể được sử dụng để đổ tất cả kèo bóng đá pháp hàng trong hệ thống phân cấp kế thừa, bảng được phân vùng hoặc xem.

kèo bóng đá pháp từcó thể được sử dụng với kèo bóng đá pháp bảng đơn giản, nước ngoài hoặc phân vùng hoặc với kèo bóng đá pháp chế độ xem cóThay vì chènTriggers.

Bạn phải chọn đặc quyền trên bảng có giá trị được đọc bởikèo bóng đá pháp vàovà chèn đặc quyền vào bảng vào đó kèo bóng đá pháp giá trị được chèn bởikèo bóng đá pháp từ. Nó là đủ để có kèo bóng đá pháp đặc quyền cột trên (kèo bóng đá pháp) cột được liệt kê trong lệnh.

Nếu bảo mật cấp hàng được bật cho bảng, có liên quanChọnChính sách sẽ áp dụng choCopyBảngđếnCâu lệnh. Hiện nay,kèo bóng đá pháp từKhông được hỗ trợ cho kèo bóng đá pháp bảng có bảo mật cấp hàng. Sử dụng tương đươngChènCâu lệnh thay thế.

Tệp có tên trong ACopyLệnh được đọc hoặc viết trực tiếp bởi máy chủ, không phải bởi ứng dụng máy khách. Do đó, họ phải cư trú hoặc có thể truy cập vào máy chủ cơ sở dữ kèo bóng đá pháp chứ không phải máy khách. Chúng phải có thể truy cập và có thể đọc được hoặc có thể ghi bởiPostgreSQLNgười dùng (ID người dùng mà máy chủ chạy như), không phải máy khách. Tương tự, lệnh được chỉ định vớiChương trìnhđược thực hiện trực tiếp bởi máy chủ, không phải bởi ứng dụng máy khách, phải được thực thi bởiPostgreSQLNgười dùng.CopyĐặt tên cho một tệp hoặc lệnh chỉ được phép cho kèo bóng đá pháp siêu người dùng hoặc người dùng được cấp một trong kèo bóng đá pháp vai tròPG_READ_SERVER_FILES, pg_write_server_fileshoặcPG_EXECUTE_SERVER_PROGRAM, vì nó cho phép đọc hoặc viết bất kỳ tệp nào hoặc chạy chương trình mà máy chủ có đặc quyền truy cập.

Không nhầm lẫnCopyvớiPSQLHướng dẫn\ Copy. \ CopyGọikèo bóng đá pháp từ Stdinhoặckèo bóng đá pháp vào stdout, và sau đó tìm nạp/lưu trữ dữ kèo bóng đá pháp trong một tệp có thể truy cập vàoPSQLKhách hàng. Do đó, khả năng truy cập tệp và quyền truy cập phụ thuộc vào máy khách thay vì máy chủ khi\ Copyđược sử dụng.

khuyến nghị rằng tên tệp được sử dụng trongCopyLuôn luôn được chỉ định là một đường dẫn tuyệt đối. Điều này được thực thi bởi máy chủ trong trường hợpkèo bóng đá pháp vào, nhưng chokèo bóng đá pháp từBạn có tùy chọn đọc từ một tệp được chỉ định bởi một đường dẫn tương đối. Đường dẫn sẽ được giải thích liên quan đến thư mục làm việc của quy trình máy chủ (thông thường là thư mục dữ kèo bóng đá pháp của cụm), không phải thư mục làm việc của khách hàng.

Thực hiện lệnh vớiChương trìnhCó thể bị hạn chế bởi kèo bóng đá pháp cơ chế kiểm soát truy cập của hệ điều hành, chẳng hạn như Selinux.

kèo bóng đá pháp từSẽ gọi bất kỳ trình kích hoạt nào và kiểm tra kèo bóng đá pháp ràng buộc trên bảng đích. Tuy nhiên, nó sẽ không gọi kèo bóng đá pháp quy tắc.

cho kèo bóng đá pháp cột nhận dạng,kèo bóng đá pháp từLệnh sẽ luôn ghi các giá trị cột được cung cấp trong dữ kèo bóng đá pháp đầu vào, nhưChènTùy chọnGiá trị hệ thống ghi đè.

CopyĐầu vào và đầu ra bị ảnh hưởng bởiDatestyle. Để đảm bảo tính di động cho người khácPOSTGRESQLCài đặt có thể sử dụng không mặc địnhDatestyleCài đặt,Datestylenên được đặt thànhISOTrước khi sử dụngkèo bóng đá pháp vào. Đó cũng là một ý tưởng tốt để tránh việc bán dữ kèo bóng đá pháp vớiIntervalStyleĐặt thànhSQL_STANDARD, Vì kèo bóng đá pháp giá trị khoảng thời gian âm có thể bị hiểu sai bởi một máy chủ có cài đặt khác choIntervalStyle.

Dữ kèo bóng đá pháp đầu vào được giải thích theomã hóaTùy chọn hoặc mã hóa máy khách hiện tại và dữ kèo bóng đá pháp đầu ra được mã hóa trongmã hóahoặc mã hóa máy khách hiện tại, ngay cả khi dữ kèo bóng đá pháp không truyền qua máy khách nhưng được đọc từ hoặc ghi vào tệp trực tiếp bởi máy chủ.

Thekèo bóng đá pháp từLệnh chèn vật lý các hàng đầu vào vào bảng khi nó tiến triển. Nếu lệnh không thành công, các hàng này bị bỏ lại ở trạng thái bị xóa; Những hàng này sẽ không thể nhìn thấy, nhưng vẫn chiếm không gian đĩa. Điều này có thể lên tới không gian đĩa bị lãng phí đáng kể nếu sự thất bại xảy ra tốt trong một hoạt động kèo bóng đá pháp lớn.VACUUMnên được sử dụng để khôi phục không gian lãng phí.

Force_NullvàForce_not_Nullcó thể được sử dụng đồng thời trên cùng một cột. Điều này dẫn đến việc chuyển đổi kèo bóng đá pháp chuỗi null được trích dẫn thành kèo bóng đá pháp giá trị null và kèo bóng đá pháp chuỗi null chưa được trích xuất thành kèo bóng đá pháp chuỗi trống.

Định dạng tệp

ví dụ

Ví dụ sau đây kèo bóng đá pháp bảng cho máy khách bằng thanh dọc (|) là dấu phân cách trường:

kèo bóng đá pháp quốc gia vào stdout (Delimiter '|');

Để kèo bóng đá pháp dữ liệu từ tệp vàoQuốc giaBảng:

kèo bóng đá pháp quốc gia từ '/usr1/proj/bray/sql/country_data';

Để kèo bóng đá pháp vào một tệp chỉ các quốc gia có tên bắt đầu bằng 'A':

kèo bóng đá pháp (chọn * từ quốc gia nơi quốc gia_name thích 'a%') đến '/usr1

Để kèo bóng đá pháp vào tệp nén, bạn có thể ống đầu ra thông qua chương trình nén bên ngoài:

kèo bóng đá pháp quốc gia vào chương trình 'gzip /usr1/proj/bray/sql/country_data.gz';

Đây là một mẫu dữ liệu phù hợp để kèo bóng đá pháp vào bảng từstdin:

AF Afghanistan
Al Albania
DZ Algeria
ZM Zambia
ZW Zimbabwe

Lưu ý rằng khoảng trắng trên mỗi dòng thực sự là một ký tự tab.

Sau đây là cùng một dữ kèo bóng đá pháp, đầu ra ở định dạng nhị phân. Dữ kèo bóng đá pháp được hiển thị sau khi lọc qua tiện ích UNIXOD -C. Bảng có ba cột; đầu tiên có loạichar (2), thứ hai có loạiTextvà thứ ba có loạiSố nguyên. Tất cả kèo bóng đá pháp hàng có giá trị null trong cột thứ ba.

0000000 p g c o p y \ n 377 \ r \ n \ 0 \ 0 \ 0 \ 0 \ 0 \ 0
0000020 \ 0 \ 0 \ 0 \ 0 003 \ 0 \ 0 \ 0 002 A F \ 0 \ 0 \ 0 013 A
0000040 f g h a n i s t a n 377 377 377 377 \ 0 003
0000060 \ 0 \ 0 \ 0 002 A L \ 0 \ 0 \ 0 007 A L B A N I I
0000100 A 377 377 377 377 \ 0 003 \ 0 \ 0 \ 0 002 D Z \ 0 \ 0 \ 0
0000120 007 A L G E R I A 377 377 377 377 \ 0 003 \ 0 \ 0
0000140 \ 0 002 Z M \ 0 \ 0 \ 0 006 Z A M B I A 377 377
0000160 377 377 \ 0 003 \ 0 \ 0 \ 0 002 Z W \ 0 \ 0 \ 0 \ B Z I I
0000200 M B A B W E 377 377 377 377 377 377

Tương thích

Không cóCopyCâu lệnh trong tiêu chuẩn SQL.

Cú pháp sau đã được sử dụng trướcPostgreSQLPhiên bản 9.0 và vẫn được hỗ trợ:

CopyTable_Name[(Cột_name[, ...])]]
    TỪ  'FileName' | Stdin
    [ [ VỚI ]
          [Nhị phân]
          [Delimiter [as] 'Delimiter_Character' ]
          [Null [as] 'NULL_STRING' ]
          [CSV [Tiêu đề]
                [Trích dẫn [như] 'quote_character' ]
                [Escape [as] 'Escape_character' ]
                [Lực lượng không nullCột_name[, ...]]]]]]

kèo bóng đá phápTable_Name[(Cột_name[, ...])] | (Truy vấn)
    ĐẾN  'FileName' | Stdout
    [ [ VỚI ]
          [Nhị phân]
          [Delimiter [as] 'Delimiter_Character' ]
          [Null [as] 'NULL_STRING' ]
          [CSV [Tiêu đề]
                [Trích dẫn [như] 'quote_character' ]
                [Escape [as] 'Escape_character' ]
                [Lực lượng báo giáCột_name[, ...] | *]]]]

Lưu ý rằng trong cú pháp này,nhị phânvàCSVđược coi là từ khóa độc lập, không phải là đối số của AĐịnh dạngTùy chọn.

Cú pháp sau đã được sử dụng trướcPostgreSQLPhiên bản 7.3 và vẫn được hỗ trợ:

kèo bóng đá pháp [nhị phân]Table_Nametừ 'FileName' | Stdin
    [[Sử dụng] Delimiters 'Delimiter_Character' ]
    [Với null là 'NULL_STRING' ]

kèo bóng đá pháp [nhị phân]Table_Nameđến '56453_56463' | Stdout
    [[Sử dụng] Delimiters 'Delimiter_Character' ]
    [Với null là 'NULL_STRING' ]

Xem thêm