CopylệnhTheCopylệnh trong12067_12079Có các tùy chọn để đọc hoặc ghi vào kèo bóng đá euro nối mạng được sử dụng bởilibpq. kèo bóng đá euro mô tả trong phần này cho phép các ứng dụng tận dụng khả năng này bằng cách cung cấp hoặc tiêu thụ dữ liệu được sao chép.
Quy trình tổng thể là ứng dụng đầu tiên phát hành SQLCopylệnh thông quaPQEXEChoặc một trong các chức kèo bóng đá euro tương đương. Phản hồi cho điều này (nếu không có lỗi trong lệnh) sẽ làpgresultĐối tượng mang mã trạng thái củaPGRES_COPY_OUThoặcPGRES_COPY_IN(tùy thuộc vào hướng sao chép được chỉ định). Sau đó, ứng dụng nên sử dụng các chức kèo bóng đá euro của phần này để nhận hoặc truyền các hàng dữ liệu. Khi truyền dữ liệu hoàn tất, một người khácpgresultĐối tượng được trả về để biểu thị thành công hoặc thất bại của việc chuyển nhượng. Trạng thái của nó sẽ làPGRES_COMMAND_OKđể thành công hoặcpgres_fatal_errorNếu gặp một số vấn đề. Tại thời điểm này, các lệnh SQL có thể được cấp quaPQEXEC. (Không thể thực thi các lệnh SQL khác bằng cùng một kèo bóng đá euro nối trong khi13517_13523Hoạt động đang được tiến hành.)
Nếu ACopylệnh được cấp quaPQEXECTrong một chuỗi có thể chứa các lệnh bổ sung, ứng dụng phải tiếp tục tìm nạp kèo bóng đá euro quả quaPQGetResultSau khi hoàn thànhCopyTrình tự. Chỉ khiPQGetResultreturnnullCó chắc chắn rằngPQEXECChuỗi lệnh được thực hiện và an toàn khi đưa ra nhiều lệnh hơn.
Các chức năng của phần này chỉ được thực thi sau khi có được trạng thái kèo bóng đá euro quả củapgres_copy_outhoặcPGRES_COPY_INtừPQEXEChoặcPQGetResult.
ApgresultĐối tượng mang một trong các giá trị trạng thái này mang một số dữ kèo bóng đá euro bổ sung vềCopyHoạt động đang bắt đầu. Dữ liệu bổ sung này có sẵn bằng cách sử dụng các chức năng cũng được sử dụng liên quan đến kèo bóng đá euro quả truy vấn:
PQNFieldsTrả về số lượng cột (trường) sẽ được sao chép.
PQBinaryTuples15572_15751CopyĐể biết thêm thông tin.
PQFFormatTrả về mã định dạng (0 cho văn bản, 1 cho nhị phân) được liên kèo bóng đá euro với mỗi cột của hoạt động sao chép. Các mã định dạng trên mỗi cột sẽ luôn bằng không khi định dạng bản sao tổng thể là văn bản, nhưng định dạng nhị phân có thể hỗ trợ cả cột văn bản và nhị phân. (Tuy nhiên, kể từ khi triển khai hiện tạiCopy, chỉ các cột nhị phân xuất hiện trong một bản sao nhị phân; Vì vậy, các định dạng trên mỗi cột luôn phù hợp với định dạng tổng thể hiện tại.)
CopyDataCác chức kèo bóng đá euro này được sử dụng để gửi dữ liệu trongSao chép từ Stdin. Họ sẽ thất bại nếu được gọi khi kèo bóng đá euro nối không ởcopy_inState.
PQPutCopydataGửi dữ kèo bóng đá euro đến máy chủ trong khicopy_inBang.
int pqputcopydata (pgconn *Conn,
const char *bộ đệm,
int nbytes);
TruyềnCopyDữ kèo bóng đá euro trong được chỉ địnhbộ đệm, độ dàinbytes, đến máy chủ. kèo bóng đá euro quả là 1 nếu dữ liệu được xếp hàng, 0 nếu nó không được xếp hàng vì bộ đệm đầy đủ (điều này sẽ chỉ xảy ra ở chế độ không chặn) hoặc -1 nếu xảy ra lỗi. (Sử dụngpqerrormessageĐể truy xuất chi tiết nếu giá trị trả về là -1. Nếu giá trị bằng không, hãy đợi để viết sẵn và thử lại.)
Ứng dụng có thể chiaCopyluồng dữ kèo bóng đá euro thành tải bộ đệm của bất kỳ kích thước thuận tiện nào. Ranh giới tải bộ đệm không có ý nghĩa ngữ nghĩa khi gửi. Nội dung của luồng dữ kèo bóng đá euro phải khớp với định dạng dữ kèo bóng đá euro được dự kiến bởiCopylệnh; nhìn thấyCopyĐể biết chi tiết.
pqputcopyendGửi chỉ báo cuối cùng vào máy chủ trong thời giancopy_inBang.
18909_18983
kèo bóng đá euro thúccopy_inHoạt động thành công nếuerrormsglànull. Nếu nhưerrormsgkhông phảinullSau đóCopybị buộc phải thất bại, với chuỗi được trỏ bởierrormsg19391_19559Copyvì lý do riêng của nó.)
kèo bóng đá euro quả là 1 nếu thông báo chấm dứt được gửi; hoặc trong chế độ không chặn, điều này chỉ có thể chỉ ra rằng thông báo chấm dứt đã được xếp hàng thành công. .pqflush, lặp lại cho đến khi nó trả về 0.) Số không chỉ ra rằng hàm không thể xếp hàng thông báo chấm dứt vì bộ đệm đầy đủ; Điều này sẽ chỉ xảy ra trong chế độ không chặn. (Trong trường hợp này, hãy đợi để viết sẵn và thửpqputcopyendgọi lại.) Nếu xảy ra lỗi khó xảy ra, -1 được trả về; Bạn có thể sử dụngpqerrormessageĐể lấy chi tiết.
Sau khi gọi thành côngpqputcopyend, gọiPQGetResultĐể có được trạng thái kèo bóng đá euro quả cuối cùng củaCopylệnh. Người ta có thể chờ kèo bóng đá euro quả này có sẵn theo cách thông thường. Sau đó trở lại hoạt động bình thường.
CopyDataCác chức kèo bóng đá euro này được sử dụng để nhận dữ liệu trongSao chép vào stdout. Họ sẽ thất bại nếu được gọi khi kèo bóng đá euro nối không ởCopy_outBang.
PQGetCopydataNhận dữ kèo bóng đá euro từ máy chủ trong21800_21810Bang.
int PQGetCopydata (PGConn *Conn,
Char ** Buffer,
int async);
cố gắng lấy một hàng dữ kèo bóng đá euro khác từ máy chủ trong thời gianCopy. Dữ kèo bóng đá euro luôn được trả về một hàng dữ kèo bóng đá euro tại một thời điểm; Nếu chỉ có một hàng một phần có sẵn, nó không được trả lại. Trả về thành công của một hàng dữ kèo bóng đá euro liên quan đến việc phân bổ một khối bộ nhớ để giữ dữ kèo bóng đá euro. Thebộ đệmtham số phải khôngnull. *bộ đệmđược đặt để trỏ đến bộ nhớ được phân bổ hoặc thànhnullTrong trường hợp không trả lại bộ đệm. Không phảinullBộ đệm kèo bóng đá euro quả phải được giải phóng bằng cách sử dụngPQFreememKhi không cần thiết.
Khi một hàng được trả về thành công, giá trị trả về là số byte dữ kèo bóng đá euro trong hàng (điều này sẽ luôn lớn hơn 0). Chuỗi được trả về luôn được chấm dứt, mặc dù điều này có lẽ chỉ hữu ích cho văn bảnCopy. kèo bóng đá euro quả của 0 chỉ ra rằngCopyvẫn đang được tiến hành, nhưng chưa có hàng nào có sẵn (điều này chỉ có thể khiAsynclà đúng). kèo bóng đá euro quả của -1 chỉ ra rằngCopyđược thực hiện. kèo bóng đá euro quả của -2 chỉ ra rằng xảy ra lỗi (tham khảopqerrormessageVì lý do).
khiAsynclà đúng (không phải bằng không),PQGetCopydatasẽ không chặn chờ nhập; nó sẽ trả về 0 nếuCopyvẫn đang được tiến hành nhưng không có hàng hoàn chỉnh nào có sẵn. (Trong trường hợp này, hãy đợi sẵn sàng đọc và sau đó gọiPQConsumeInputTrước khi gọiPQGetCopydataMột lần nữa.) Khiasynclà sai (không),PQGetCopydataSẽ chặn cho đến khi dữ kèo bóng đá euro có sẵn hoặc hoạt động hoàn thành.
sauPQGetCopydatareturn -1, gọiPQGetResultĐể có được trạng thái kèo bóng đá euro quả cuối cùng củaCopylệnh. Người ta có thể chờ kèo bóng đá euro quả này có sẵn theo cách thông thường. Sau đó trở lại hoạt động bình thường.
CopyCác chức kèo bóng đá euro này đại diện cho các phương thức xử lý cũ hơnCopy. Mặc dù chúng vẫn hoạt động, nhưng chúng không được xử lý do xử lý lỗi kém, các phương pháp bất tiện trong việc phát hiện kèo bóng đá euro thúc dữ liệu và thiếu hỗ trợ cho việc chuyển nhượng nhị phân hoặc không chặn.
PQGetLineĐọc một dòng ký tự kèo bóng đá euro thúc mới (được truyền bởi máy chủ) vào một chuỗi bộ đệm có kích thướclength.
int PQGetLine (PGConn *Conn,
Char *bộ đệm,
int length);
Hàm này sao chép lênLEGN-1 ký tự thành bộ đệm và chuyển đổi dòng mới kèo bóng đá euro thúc thành một byte số 0.PQGetLinereturnEOFỞ cuối đầu vào, 0 nếu toàn bộ dòng đã được đọc và 1 nếu bộ đệm đầy đủ nhưng dòng mới kèo bóng đá euro thúc chưa được đọc.
Lưu ý rằng ứng dụng phải kiểm tra xem một dòng mới có bao gồm hai ký tự\., trong đó chỉ ra rằng máy chủ đã hoàn thành việc gửi kèo bóng đá euro quả củaCopy26601_26671LEGN-1 ký tự dài, cần quan tâm để chắc chắn rằng nó nhận ra\.26810_26915
PQGetLineAsyncĐọc một hàngCopyDữ kèo bóng đá euro (được truyền bởi máy chủ) vào bộ đệm mà không chặn.
27305_27407
Hàm này tương tựPQGetLine, nhưng nó có thể được sử dụng bởi các ứng dụng phải đọcCopyDữ kèo bóng đá euro không đồng bộ, nghĩa là không chặn. Đã phát hànhCopyLệnh và nhận đượcPGRES_COPY_OUT27801_27842PQConsumeInputvàPQGetLineAsynccho đến khi phát hiện tín hiệu cuối cùng của dữ kèo bóng đá euro.
Không giống nhưPQGetLine, Hàm này chịu trách nhiệm phát hiện kèo bóng đá euro thúc dữ liệu.
trên mỗi cuộc gọi,PQGetLineAsyncSẽ trả về dữ kèo bóng đá euro nếu có sẵn một hàng dữ kèo bóng đá euro hoàn chỉnh tronglibpqbộ đệm đầu vào. Mặt khác, không có dữ kèo bóng đá euro nào được trả về cho đến khi phần còn lại của hàng đến. Hàm trả về -1 nếu điểm đánh dấu dữ kèo bóng đá euro cuối sao đã được nhận dạng hoặc 0 nếu không có dữ kèo bóng đá euro hoặc một số dương đưa số byte dữ kèo bóng đá euro được trả về. Nếu -1 được trả về, người gọi phải gọi tiếp theoPQENDCOPY, và sau đó trở lại xử lý bình thường.
28980_29311\ nhoặc không. (Trong một nhị phânCopy, Phân tích cú pháp thực tế củaCopyĐịnh dạng dữ kèo bóng đá euro sẽ cần thiết để đưa ra quyết định tương đương.) Chuỗi được trả về không được chấm dứt. (Nếu bạn muốn thêm NULL chấm dứt, hãy chắc chắn vượt quaBufsizeMột nhỏ hơn phòng thực sự có sẵn.)
pqputlineGửi một chuỗi kèo bóng đá euro thúc null đến máy chủ. Trả về 0 nếu ok vàEOFNếu không thể gửi chuỗi.
int pqputline (PGConn *Conn,
const char *chuỗi);
TheCopyluồng dữ kèo bóng đá euro được gửi bởi một loạt các cuộc gọi đếnpqputlinecó cùng định dạng như được trả về bởiPQGetLineAsync, ngoại trừ các ứng dụng không bắt buộc phải gửi chính xác một hàng dữ kèo bóng đá euro cho mỗipqputlinecuộc gọi; Không sao khi gửi một dòng một phần hoặc nhiều dòng cho mỗi cuộc gọi.
trướcPOSTGRESQLGiao thức 3.0, cần thiết cho ứng dụng gửi rõ ràng hai ký tự\.Là một dòng cuối cùng để chỉ ra với máy chủ rằng nó đã hoàn thành việc gửiCopyDữ kèo bóng đá euro. Mặc dù điều này vẫn hoạt động, nó không được chấp nhận và ý nghĩa đặc biệt của\.có thể được loại bỏ trong một bản phát hành trong tương lai. Nó đủ để gọiPQENDCOPYSau khi gửi dữ kèo bóng đá euro thực tế.
pqputnbytesGửi một chuỗi không kèo bóng đá euro thúc không đến máy chủ. Trả về 0 nếu ok vàEOFNếu không thể gửi chuỗi.
int pqputnbytes (pgconn *Conn,
const char *bộ đệm,
int nbytes);
Điều này giống hệtpqputline32100_32261
PQENDCOPYĐồng bộ hóa với máy chủ.
int pqendcopy (pgconn *Conn);
Hàm này đợi cho đến khi máy chủ hoàn thành việc sao chép. Nó sẽ được cấp khi chuỗi cuối cùng được gửi đến máy chủ bằng cách sử dụngpqputlinehoặc khi chuỗi cuối cùng được nhận từ máy chủ bằng cách sử dụngPQGetLine. Nó phải được cấp hoặc máy chủ sẽ nhận đượcOut of SyncHồiVới máy khách. Khi trở về từ chức kèo bóng đá euro này, máy chủ đã sẵn sàng nhận lệnh SQL tiếp theo. Giá trị trả về là 0 khi hoàn thành thành công, khác không. (Sử dụngpqerrormessageĐể lấy chi tiết nếu giá trị trả về không khác.)
Khi sử dụngPQGetResult, Ứng dụng sẽ trả lờiPGRES_COPY_OUTkèo bóng đá euro quả bằng cách thực thiPQGetLineLiên tục, theo sau làPQENDCOPYSau khi thấy dòng Terminator được nhìn thấy. Sau đó nó sẽ trở lạiPQGetResultVòng lặp cho đếnPQGetResultTrả về một con trỏ null. Tương tự A34199_34214kèo bóng đá euro quả được xử lý bởi một loạtpqputlinecuộc gọi theo sau làPQENDCOPY, sau đó quay lạiPQGetResultVòng lặp. Sự sắp xếp này sẽ đảm bảo rằngCopyLệnh được nhúng trong một loạtSQLCác lệnh sẽ được thực thi chính xác.
Các ứng dụng cũ có khả kèo bóng đá euro gửiCopyViaPQEXECvà giả sử rằng giao dịch được thực hiện sauPQENDCOPY. Điều này sẽ chỉ hoạt động chính xác nếuCopylà duy nhấtSQLLệnh trong chuỗi lệnh.
Nếu bạn thấy bất cứ điều gì trong tài liệu không chính xác, không khớp Kinh nghiệm của bạn với tính kèo bóng đá euro cụ thể hoặc yêu cầu làm rõ thêm, Vui lòng sử dụngMẫu nàyĐể báo cáo vấn đề tài kèo bóng đá euro.