| PostgreSQL: kèo bóng đá hôm nay và ngày mai liệu: | |||
|---|---|---|---|
| Prev | UP | Chương 32.libpq- C Thư viện | Tiếp theo |
TheCopylệnh trongPostgreSQLCó các tùy chọn để đọc hoặc ghi vào kèo bóng đá việt nam nối mạng được sử dụng bởilibpq. kèo bóng đá việt nam 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.
Quá trình tổng thể là ứng dụng đầu tiên phát hành SQLCopylệnh quaPQEXEChoặc một trong kèo bóng đá việt nam 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 kèo bóng đá việt nam của phần này để nhận hoặc truyền các hàng dữ liệu.PGRESULTĐố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, kèo bóng đá việt nam 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 đá việt nam nối trong khiCopyHoạ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 đá việt nam 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 đá việt nam quả củaPGRES_COPY_OUThoặcPGRES_COPY_INtừPQEXEChoặcPQGetResult.
132PostgreSQL: Tài liệu: 9.6: kèo bóng đá việt nam liên kết với lệnh sao chép47pgresultĐối tượng mang một trong kèo bóng đá việt nam giá trị trạng thái này mang một số dữ liệu 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 đá việt nam quả truy vấn:
PQNFieldsTrả về số lượng cột (trường) sẽ được sao chép.
pqbinarytuples0 Cho biết định dạng bản sao tổng thể là văn bản (kèo bóng đá việt nam hàng được phân tách bằng kèo bóng đá việt nam cột, kèo bóng đá việt nam cột được phân tách bởi kèo bóng đá việt nam ký tự phân cách, v.v.). 1 Cho biết định dạng bản sao tổng thể là nhị phân.CopyĐể 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 đá việt nam 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.Copy, chỉ kèo bóng đá việt nam cột nhị phân xuất hiện trong một bản sao nhị phân; Vì vậy, kèo bóng đá việt nam đị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.)
Lưu ý:Các giá trị dữ liệu bổ sung này chỉ khả dụng khi sử dụng Giao thức 3.0. Khi sử dụng Giao thức 2.0, tất cả kèo bóng đá việt nam này sẽ trả về 0.
kèo bóng đá việt nam 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 đá việt nam nối không ởcopy_inBang.
pqputcopydataGửi dữ liệu đến máy chủ trong thời giancopy_inBang.
int pqputcopydata (pgconn *Conn,
TruyềnCopyDữ liệu trong được chỉ địnhbộ đệm, của độ dàinbyte, đến máy chủ. kèo bóng đá việt nam 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.pqerrormessageĐể 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ữ liệu 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.CopyLệnh; nhìn thấyCopyĐể biết chi tiết.
pqputcopyendGửi chỉ số cuối dữ liệu đến máy chủ trong thời giancopy_inState.
int pqputcopyend (pgconn *Conn,
kèo bóng đá việt nam 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, kèo bóng đá việt nam chuỗi được trỏ bởierrormsgĐược sử dụng làm thông báo lỗi. (Tuy nhiên, người ta không nên cho rằng thông báo lỗi chính xác này sẽ quay lại từ máy chủ, vì máy chủ có thể đã thất bạiCopyvì lý do riêng của nó. Cũng lưu ý rằng tùy chọn buộc lỗi không hoạt động khi sử dụng kèo bóng đá việt nam nối Pre-3.0-giao thức.)
kèo bóng đá việt nam 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ề số 0.) 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.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 đá việt nam quả cuối cùng củaCopylệnh. Người ta có thể chờ kèo bóng đá việt nam quả này có sẵn theo cách thông thường.
kèo bóng đá việt nam này được sử dụng để nhận dữ liệu trong thời gianSao chép vào stdout. Họ sẽ thất bại nếu được gọi khi kèo bóng đá việt nam nối không ởcopy_outBang.
PQGetCopydataNhận dữ liệu từ máy chủ trongcopy_outBang.
int PQGetCopydata (PGConn *Conn,
cố gắng lấy một hàng dữ liệu khác từ máy chủ trong thời gianCopy. Dữ liệu luôn được trả về một hàng dữ liệu tại một thời điểm;bộ đệmtham số phải khôngnull.*bộ đệmđược đặt để trỏ đến bộ nhớ được phân bổ hoặc đếnnullTrong trường hợp không có bộ đệm nào được trả lại. Không phảinullBộ đệm kèo bóng đá việt nam quả nên đượ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ữ liệu 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ảnsao chép. kèo bóng đá việt nam 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 đá việt nam quả của -1 chỉ ra rằngCopyđược thực hiện. kèo bóng đá việt nam 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ờ đầu vào; 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ữ liệu 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 đá việt nam quả cuối cùng củaCopylệnh. Người ta có thể chờ kèo bóng đá việt nam quả này có sẵn theo cách thông thường.
kèo bóng đá việt nam 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 đá việt nam 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 đá việt nam 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,
Hàm này sao chép lênlength-1 ký tự thành bộ đệm và chuyển đổi kèo bóng đá việt nam thúc dòng mới 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 việc chấm dứt dòng mới 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ự\., cho biết máy chủ đã hoàn thành việc gửi kèo bóng đá việt nam quả củaCopyLệnh. Nếu ứng dụng có thể nhận kèo bóng đá việt nam dòng nhiều hơnLEGN-1 ký tự dài, cần quan tâm để chắc chắn rằng nó nhận ra\.dòng chính xác (và không, ví dụ, nhầm lẫn cuối dòng dữ liệu dài cho dòng Terminator).
PQGetLineAsyncĐọc một hàngCopyDữ liệu (được truyền bởi máy chủ) vào bộ đệm mà không chặn.
int PQGetLineAnyNC (PGConn *Conn,
Hàm này tương tự nhưPQGetLine, nhưng nó có thể được sử dụng bởi kèo bóng đá việt nam ứng dụng phải đọcCopyDữ liệu không đồng bộ, nghĩa là không chặn. Đã phát hànhCopyLệnh và nhận đượcPGRES_COPY_OUTPhản hồi, ứng dụng nên gọiPQConsumeInputvàPQGetLineAsynccho đến khi phát hiện tín hiệu cuối cùng của dữ liệu.
Không giống nhưPQGetLine, chức năng này chịu trách nhiệm phát hiện kèo bóng đá việt nam thúc dữ liệu.
trên mỗi cuộc gọi,PQGetLineAsyncSẽ trả về dữ liệu nếu có sẵn hàng dữ liệu hoàn chỉnh tronglibpqbộ đệm đầu vào. Mặt khác, không có dữ liệu nào được trả về cho đến khi phần còn lại của hàng đến.pqendcopy, và sau đó trở lại xử lý bình thường.
Dữ liệu được trả về sẽ không vượt ra ngoài ranh giới hàng dữ liệu. Nếu có thể một hàng toàn bộ sẽ được trả lại cùng một lúc.\ 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ữ liệu 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 đá việt nam 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,
TheCopyluồng dữ liệu được gửi bởi một loạt kèo bóng đá việt nam cuộc gọi đếnpqputlinecó cùng định dạng như được trả về bởiPQGetLineAsync, ngoại trừ kèo bóng đá việt nam ứng dụng không có nghĩa vụ gửi chính xác một hàng dữ liệu trên 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.
Lưu ý:trướcPostgreSQLGiao thức 3.0, ứng dụng cần phải gửi rõ ràng hai ký tự\.Là một dòng cuối cùng để chỉ ra cho máy chủ rằng nó đã hoàn thành việc gửiCopyDữ liệu. 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ọi
pqendcopySau khi gửi dữ liệu thực tế.
pqputnbytesGửi chuỗi không kèo bóng đá việt nam 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,
Điều này giống hệtpqputline, ngoại trừ bộ đệm dữ liệu không cần phải kèo bóng đá việt nam thúc vì số lượng byte gửi được chỉ định trực tiếp. Sử dụng quy trình này khi gửi dữ liệu nhị phân.
PQENDCOPYĐồng bộ hóa kèo bóng đá việt nam 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 được"Out of Sync"Với máy khách. Khi trở về từ chức kèo bóng đá việt nam này, máy chủ đã sẵn sàng nhận lệnh SQL tiếp theo.pqerrormessageĐể truy xuất 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 đá việt nam quả bằng cách thực thiPQGetLineLặp đi lặp lại, 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ự APGRES_COPY_INkèo bóng đá việt nam 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ạtSQLkèo bóng đá việt nam lệnh sẽ được thực thi chính xác.
kèo bóng đá việt nam ứng dụng cũ có khả năng gửi ACopyViaPQEXECvà 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.