SPI_EXECUTE_PLAN_EXTENDS - Thực hiện một câu lệnh được chuẩn bị bởispi_prepare
int spi_execute_plan_extends (spiplanptrkế hoạch,,Tùy chọn)
spi_execute_plan_extendsThực thi một câu lệnh được chuẩn bị bởispi_preparehoặc một trong những anh chị em của nó. Chức năng này tương đương vớiSPI_EXECUTE_PLAN, ngoại trừ thông tin về tỷ lệ kèo bóng đá giá trị tham số sẽ được truyền cho truy vấn được trình bày khác nhau và có thể truyền tỷ lệ kèo bóng đá tùy chọn kiểm soát thực thi bổ sung.
tỷ lệ kèo bóng đá giá trị tham số truy vấn được biểu diễn bằng Aparamlistinfostruct, thuận tiện cho việc chuyển tỷ lệ kèo bóng đá giá trị đã có sẵn ở định dạng đó. tỷ lệ kèo bóng đá bộ tham số động cũng có thể được sử dụng, thông qua tỷ lệ kèo bóng đá hàm hook được chỉ định trongparamlistInfo.
Ngoài ra, thay vì luôn tích lũy các bộ dữ tỷ lệ kèo bóng đá kết quả thành Aspi_tupableCấu trúc, bộ dữ tỷ lệ kèo bóng đá có thể được chuyển cho người gọi do người gọiDestreceiverĐối tượng khi chúng được tạo bởi người thực thi. Điều này đặc biệt hữu ích cho các truy vấn có thể tạo ra nhiều bộ dữ tỷ lệ kèo bóng đá, vì dữ tỷ lệ kèo bóng đá có thể được xử lý trên đường thay vì được tích lũy trong bộ nhớ.
spiplanptrkế hoạchCâu lệnh đã chuẩn bị (được trả về bởispi_prepare)
const spiexecuteOptions *Tùy chọnCấu trúc chứa tỷ lệ kèo bóng đá đối số tùy chọn
Người gọi phải luôn luôn không có toàn bộTùy chọnstruct, sau đó điền vào bất kỳ trường nào họ muốn đặt. Điều này đảm bảo khả năng tương thích về phía trước của mã, vì bất kỳ trường nào được thêm vào cấu trúc trong tương lai sẽ được xác định để hoạt động ngược tương thích nếu chúng bằng không.Tùy chọnTrường là:
paramlistinfoparamsCấu trúc dữ tỷ lệ kèo bóng đá chứa các loại và giá trị tham số truy vấn; Null nếu không
boolread_onlyTRUEđể thực hiện chỉ đọc
boolcho phép_nonatomicTRUECho phép thực thi tỷ lệ kèo bóng đá câu lệnh gọi và thực hiện không nguyên tử (nhưng trường này bị bỏ qua trừ khispi_opt_nonatomicCờ đã được chuyển chospi_connect_ext)
boolmust_return_tuplesnếutrue, Tăng lỗi nếu truy vấn không thuộc loại trả về tỷ lệ kèo bóng đá bộ dữ
UINT64TcountSố lượng hàng tối đa để trả về hoặc0không giới hạn
Destreceiver *DestDestreceiverĐối tượng sẽ nhận được bất kỳ bộ dữ tỷ lệ kèo bóng đá nào phát ra từ truy vấn; if NULL, result tuples are accumulated into aspi_tupableCấu trúc, như trongSPI_EXECUTE_PLAN
tỷ lệ kèo bóng đá nguyênChủ sở hữuChủ sở hữu tỷ lệ kèo bóng đá nguyên sẽ giữ số lượng tham chiếu trên kế hoạch trong khi nó được thực thi. Nếu NULL, CurrentResourceOwner được sử dụng.
Giá trị trả về giống như đối vớiSPI_EXECUTE_PLAN.
KhiTùy chọn- Destlà null,SPI_Procedvàspi_tupableđược đặt như trongSPI_EXECUTE_PLAN. KhiTùy chọn- Destkhông phải là null,SPI_Procedđược đặt thành 0 vàspi_tupableđược đặt thành NULL. Nếu cần số lượng tuple, người gọiDestreceiverĐối tượng phải tính toán nó.
Nếu bạn thấy bất cứ điều gì trong tài tỷ lệ kèo bóng đá không chính xác, không phù hợpMẫu nàyĐể báo cáo vấn đề tài tỷ lệ kèo bóng đá.