spi_prepare - Chuẩn bị kèo tỷ số bóng đá euro hôm nay tuyên bố, mà không cần thực hiện nó
spiplanptr spi_prepare (const char *kèo tỷ số bóng đá euro hôm nay
, intNARGS
, oid *argtypes
)
spi_prepare
Tạo và trả về kèo tỷ số bóng đá euro hôm nay câu lệnh đã chuẩn bị cho lệnh được chỉ định, nhưng không thực thi lệnh. Câu lệnh đã chuẩn bị sau đó có thể được thực thi nhiều lần bằng cách sử dụngSPI_EXECUTE_PLAN
.
10944_11160spi_prepare
Chuyển đổi kèo tỷ số bóng đá euro hôm nay chuỗi lệnh thành kèo tỷ số bóng đá euro hôm nay câu lệnh đã chuẩn bị gói gọn kết quả phân tích phân tích. Tuyên bố đã chuẩn bị cũng cung cấp kèo tỷ số bóng đá euro hôm nay nơi để lưu trữ kế hoạch thực thi nếu thấy rằng việc tạo ra kèo tỷ số bóng đá euro hôm nay kế hoạch tùy chỉnh cho mỗi lần thực thi là không hữu ích.
kèo tỷ số bóng đá euro hôm nay lệnh đã chuẩn bị có thể được khái quát bằng cách ghi các tham số ($ 1
, $ 2
, v.v.) thay cho những gì sẽ là hằng số trong kèo tỷ số bóng đá euro hôm nay lệnh bình thường. Các giá trị thực của các tham số sau đó được chỉ định khiSPI_EXECUTE_PLAN
được gọi. Điều này cho phép kèo tỷ số bóng đá euro hôm nay đã chuẩn bị được sử dụng trong phạm vi các tình huống rộng hơn có thể mà không có tham số.
Câu kèo tỷ số bóng đá euro hôm nay được trả về bởispi_prepare
Chỉ có thể được sử dụng trong kèo tỷ số bóng đá euro hôm nay gọi hiện tại của hàm C, vìspi_finish
Giải phóng bộ nhớ được phân bổ cho kèo tỷ số bóng đá euro hôm nay tuyên bố như vậy. Nhưng câu lệnh có thể được lưu lâu hơn bằng cách sử dụng các chức năngspi_keepplan
hoặcspi_saveplan
.
const char *kèo tỷ số bóng đá euro hôm nay
chuỗi kèo tỷ số bóng đá euro hôm nay
intNARGS
Số lượng tham số đầu vào ($ 1
, $ 2
, v.v.)
oid *argtypes
Con trỏ tới kèo tỷ số bóng đá euro hôm nay mảng chứaoidS của các loại dữ liệu của các tham số
spi_prepare
Trả về kèo tỷ số bóng đá euro hôm nay con trỏ không null cho kèo tỷ số bóng đá euro hôm naySpiplan
, đó là kèo tỷ số bóng đá euro hôm nay cấu trúc mờ biểu thị kèo tỷ số bóng đá euro hôm nay câu lệnh đã chuẩn bị. Trên lỗi,null
sẽ được trả về vàspi_result
sẽ được đặt thành kèo tỷ số bóng đá euro hôm nay trong cùng kèo tỷ số bóng đá euro hôm nay mã lỗi được sử dụng bởiSPI_EXECUTE
, ngoại trừ nó được đặt thànhspi_error_argument
nếukèo tỷ số bóng đá euro hôm nay
lànull
hoặc nếuNARGS
nhỏ hơn 0 hoặc nếuNARGS
lớn hơn 0 vàargtypes
lànull
.
Nếu không có tham số nào được xác định, kèo tỷ số bóng đá euro hôm nay kế hoạch chung sẽ được tạo ở lần đầu tiên sử dụngSPI_EXECUTE_PLAN
, và được sử dụng cho tất cả các thực thi tiếp theo. Nếu có các tham số, kèo tỷ số bóng đá euro hôm nay vài lần sử dụng đầu tiên củaSPI_EXECUTE_PLAN
sẽ tạo các gói tùy chỉnh dành riêng cho các giá trị tham số được cung cấp. Sau khi sử dụng đủ của cùng kèo tỷ số bóng đá euro hôm nay câu lệnh đã chuẩn bị,SPI_EXECUTE_PLAN
sẽ xây dựng kèo tỷ số bóng đá euro hôm nay kế hoạch chung và nếu điều đó không quá đắt so với các kế hoạch tùy chỉnh, nó sẽ bắt đầu sử dụng kế hoạch chung thay vì lập kế hoạch lại mỗi lần. Nếu hành vi mặc định này không phù hợp, bạn có thể thay đổi nó bằng cách vượt quacon trỏ_opt_generic_plan
hoặccursor_opt_custom_plan
cờ đếnspi_prepare_cursor
, để buộc sử dụng các kế hoạch chung hoặc tùy chỉnh tương ứng.
Mặc dù điểm chính của câu kèo tỷ số bóng đá euro hôm nay đã chuẩn bị là để tránh phân tích phân tích và lập kế hoạch phân tích lặp đi lặp lại của câu kèo tỷ số bóng đá euro hôm nay,PostgreSQL15191_15428search_pathThay đổi từ sử dụng này sang cách tiếp theo, câu kèo tỷ số bóng đá euro hôm nay sẽ được sắp xếp lại bằng cách sử dụng mớisearch_path
. (Hành vi sau này là mới nhưPostgreSQL9.3.) XemChuẩn bịĐể biết thêm thông tin về hành vi của các câu kèo tỷ số bóng đá euro hôm nay được chuẩn bị.
Hàm này chỉ nên được gọi từ hàm C được kết nối.
spiplanptr
được khai báo là kèo tỷ số bóng đá euro hôm nay con trỏ tới kèo tỷ số bóng đá euro hôm nay loại cấu trúc mờ trongspi.h
. Không khôn ngoan khi cố gắng truy cập trực tiếp vào nội dung của nó, vì điều đó làm cho mã của bạn có nhiều khả năng phá vỡ các bản sửa đổi trong tương lai củaPostgreSQL.
Tênspiplanptr
Có phần lịch sử, vì cấu trúc dữ liệu không nhất thiết phải chứa kèo tỷ số bóng đá euro hôm nay kế hoạch thực thi.