spi_prepare - Chuẩn bị một câu kèo bóng đá hôm nay và ngày mai, mà không cần thực hiện nó
spiplanptr spi_prepare (const char *kèo bóng đá hôm nay và ngày mai, intNARGS, oid *argtypes)
spi_prepareTạo và trả về một câu kèo bóng đá hôm nay và ngày mai đã chuẩn bị cho kèo bóng đá hôm nay và ngày mai được chỉ định, nhưng không thực thi kèo bóng đá hôm nay và ngày mai. Câu kèo bóng đá hôm nay và ngày mai đã chuẩn bị sau đó có thể được thực thi nhiều lần bằng cách sử dụngSPI_EXECUTE_PLAN.
Khi cùng một kèo bóng đá hôm nay và ngày mai hoặc một kèo bóng đá hôm nay và ngày mai tương tự sẽ được thực thi nhiều lần, nói chung, việc thực hiện phân tích phân tích chỉ một lần là có lợi cho việc sử dụng lại kế hoạch thực thi cho kèo bóng đá hôm nay và ngày mai.spi_prepareChuyển đổi một chuỗi kèo bóng đá hôm nay và ngày mai thành một câu kèo bóng đá hôm nay và ngày mai đã 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 một nơi để lưu trữ kế hoạch thực thi nếu thấy rằng việc tạo ra một kế hoạch tùy chỉnh cho mỗi lần thực thi là không hữu ích.
Một kèo bóng đá hôm nay và ngày mai đã 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 một kèo bóng đá hôm nay và ngày mai 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 bóng đá hôm nay và ngày mai đã 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 bóng đá hôm nay và ngày mai được trả về bởispi_prepareChỉ có thể được sử dụng trong kèo bóng đá hôm nay và ngày mai gọi hiện tại của hàm C, vìspi_finishBộ nhớ giải phóng được phân bổ cho một tuyên bố như vậy. Nhưng câu kèo bóng đá hôm nay và ngày mai có thể được lưu lâu hơn bằng cách sử dụng các chức năngspi_keepplanhoặcspi_saveplan.
const char *kèo bóng đá hôm nay và ngày maichuỗi kèo bóng đá hôm nay và ngày mai
intNARGSSố lượng tham số đầu kèo bóng đá hôm nay và ngày maio ($ 1, $ 2, v.v.)
oid *argtypesCon trỏ tới kèo bóng đá hôm nay và ngày mai mảng chứaoidS của các loại dữ liệu của các tham số
spi_prepareTrả về kèo bóng đá hôm nay và ngày mai con trỏ không null chospiplan, là một cấu trúc mờ biểu thị một câu kèo bóng đá hôm nay và ngày mai đã chuẩn bị. Trên lỗi,nullsẽ được trả về vàspi_resultsẽ được đặt thành kèo bóng đá hôm nay và ngày mai trong cùng kèo bóng đá hôm nay và ngày mai mã lỗi được sử dụng bởiSPI_EXECUTE, ngoại trừ nó được đặt thànhspi_error_argumentnếukèo bóng đá hôm nay và ngày mailànullhoặc nếuNARGSnhỏ hơn 0 hoặc nếuNARGSlớn hơn 0 vàargtypeslànull.
Nếu không có tham số nào được xác định, kèo bóng đá hôm nay và ngày mai 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 bóng đá hôm nay và ngày mai vài lần sử dụng đầu tiên củaSPI_EXECUTE_PLANsẽ 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 một câu kèo bóng đá hôm nay và ngày mai đã chuẩn bị,SPI_EXECUTE_PLANsẽ xây dựng kèo bóng đá hôm nay và ngày mai 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 quacursor_opt_generic_planhoặccon trỏ_opt_custom_plancờ đế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 bóng đá hôm nay và ngày mai đã 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 bóng đá hôm nay và ngày mai,PostgreSQLsẽ buộc phân tích lại và lập kế hoạch lại câu kèo bóng đá hôm nay và ngày mai trước khi sử dụng nó bất cứ khi nào các đối tượng cơ sở dữ liệu được sử dụng trong câu kèo bóng đá hôm nay và ngày mai đã trải qua các thay đổi xác định (DDL) kể từ khi sử dụng câu kèo bóng đá hôm nay và ngày mai đã chuẩn bị trước đó. Ngoài ra, nếu giá trị củasearch_pathThay đổi từ sử dụng này sang cách tiếp theo, câu kèo bóng đá hôm nay và ngày mai sẽ được phân loại 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 bóng đá hôm nay và ngày mai đượ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 bóng đá hôm nay và ngày mai con trỏ tới kèo bóng đá hôm nay và ngày mai 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 kèo bóng đá hôm nay và ngày maio 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ênspiplanptrcó phần lịch sử, vì cấu trúc dữ liệu không còn nhất thiết phải chứa kèo bóng đá hôm nay và ngày mai kế hoạch thực thi.
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 phù hợpMẫu nàyĐể báo cáo vấn đề tài liệu.