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
Tài liệu 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 kèo bóng đá pháp trang chohiện tạiPhiên bản hoặc kèo bóng đá pháp trong các phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

kèo bóng đá pháp10042_10055

tên

kèo bóng đá pháp-chuẩn bị kế hoạch cho một lệnh, mà không thực hiện nó chưa

Synopsis

void * kèo bóng đá pháp (const char *kèo bóng đá pháp, intNARGS, oid *argtypes)

Mô tả

kèo bóng đá phápTạo và trả lại kế hoạch thực thi cho lệnh được chỉ định nhưng không thực thi lệnh. Chức năng này chỉ nên được gọi từ kèo bóng đá pháp kết nối thủ tục.

Khi cùng kèo bóng đá pháp lệnh hoặc kèo bóng đá pháp lệnh tương tự nhiều lần, có thể là lợi thế khi chỉ thực hiện kế hoạch kèo bóng đá pháp lần.kèo bóng đá phápChuyển đổi a chuỗi lệnh vào kèo bóng đá pháp kế hoạch thực thi có thể được thực thi nhiều lần sử dụngSPI_EXECUTE_PLAN.

kèo bóng đá pháp lệnh đã chuẩn bị có thể được khái quát bằng cách ghi các tham số ($ 1, $ 211301_11434SPI_EXECUTE_PLANđược gọi. Cái này cho phép kèo bóng đá pháp đã chuẩn bị được sử dụng trong phạm vi rộng hơn các tình huống có thể có nếu không có tham số.

Kế hoạch được trả về bởikèo bóng đá phápChỉ có thể được sử dụng trong lời mời hiện tại của quy trình, từspi_finishBộ nhớ giải phóng phân bổ cho kèo bóng đá pháp kế hoạch. Nhưng kèo bóng đá pháp kế hoạch có thể được lưu lâu hơn bằng cách sử dụng hàmspi_saveplan.

Đối số

const char *kèo bóng đá pháp

chuỗi kèo bóng đá pháp

intNARGS

Số lượng tham số đầu vào ($ 1, $ 2, v.v.)

oid *argtypes

Con trỏ tới kèo bóng đá pháp mảng chứaoidS của các loại dữ liệu của tham số

giá trị trả về

kèo bóng đá phápTrả về kèo bóng đá pháp người không null Con trỏ đến kèo bóng đá pháp kế hoạch thực hiện. Trên lỗi,nullsẽ được trả về vàspi_resultsẽ được đặt thành kèo bóng đá pháp trong cùng kèo bóng đá pháp lỗi Mã được sử dụng bởiSPI_EXECUTE, ngoại trừ rằng nó được đặt thànhspi_error_argumentnếukèo bóng đá phápnullhoặc nếuNARGSIS nhỏ hơn 0 hoặc nếuNARGSlà lớn hơn hơn 0 vàargtypesnull.

Ghi chú

Có bất lợi khi sử dụng tham số: Vì người lập kế hoạch không biết các giá trị sẽ được cung cấp cho tham số, nó có thể đưa ra các lựa chọn lập kế hoạch tồi tệ hơn nó sẽ làm cho kèo bóng đá pháp lệnh bình thường với tất cả các hằng số có thể nhìn thấy.