Mô tả

SPI_EXECUTEThực thi kèo bóng đá hom nay SQL được chỉ định choCounthàng. Nếu nhưread_onlylàtrue, kèo bóng đá hom nay phải chỉ đọc và chi phí thực thi bị giảm một chút.

Hàm này chỉ có thể được gọi từ hàm C được kết nối.

nếuĐếmbằng 0 thì kèo bóng đá hom nay được thực thi cho tất cả các hàng mà nó áp dụng. Nếu nhưĐếmlớn hơn 0, thì không quáCounthàng sẽ được truy xuất; kèo bóng đá hom nay hiện dừng khi đạt được số đếm, giống như thêm mộtgiới hạnmệnh đề cho truy vấn. Ví dụ,

spi_execute ("chọn * từ foo", true, 5);

sẽ lấy lại tối đa 5 hàng từ bảng. Lưu ý rằng giới hạn như vậy chỉ có hiệu lực khi kèo bóng đá hom nay thực sự trả về hàng. Ví dụ,

spi_execute ("chèn vào foo chọn * từ thanh", false, 5);

Chèn tất cả các hàng từBar, bỏ quaĐếmTham số. Tuy nhiên, với

spi_execute ("chèn vào foo chọn * từ thanh trả lại *", false, 5);

nhiều nhất là 5 hàng sẽ được chèn, vì việc kèo bóng đá hom nay sẽ dừng sau lần thứ nămTrở vềHàng kết quả được truy xuất.

Bạn có thể chuyển nhiều kèo bóng đá hom nay trong một chuỗi;SPI_EXECUTETrả về kết quả cho kèo bóng đá hom nay được thực thi cuối cùng. TheĐếmGiới hạn áp dụng cho mỗi kèo bóng đá hom nay riêng biệt (mặc dù chỉ có kết quả cuối cùng sẽ thực sự được trả về). Giới hạn không được áp dụng cho bất kỳ kèo bóng đá hom nay ẩn nào được tạo bởi các quy tắc.

Khiread_onlylàSai, SPI_EXECUTETăng bộ đếm kèo bóng đá hom nay và tính toán mớiSnapshotTrước khi thực thi mỗi kèo bóng đá hom nay trong chuỗi. Ảnh chụp không thực sự thay đổi nếu mức cách ly giao dịch hiện tại làserializablehoặcĐọc lặp lại, nhưng trong12828_12844Chế độ Cập nhật ảnh chụp nhanh cho phép mỗi kèo bóng đá hom nay xem kết quả của các giao dịch mới cam kết từ các phiên khác. Điều này rất cần thiết cho hành vi nhất quán khi các kèo bóng đá hom nay đang sửa đổi cơ sở dữ liệu.

Khiread_onlylàTRUE, SPI_EXECUTEKhông cập nhật ảnh chụp nhanh hoặc bộ đếm kèo bóng đá hom nay và nó chỉ cho phép đơn giảnChọnCác kèo bóng đá hom nay xuất hiện trong chuỗi kèo bóng đá hom nay. Các kèo bóng đá hom nay được thực thi bằng cách sử dụng ảnh chụp nhanh được thiết lập trước đó cho truy vấn xung quanh. Chế độ thực thi này nhanh hơn một chút so với chế độ đọc/ghi do loại bỏ chi phí trên mỗi kèo bóng đá hom nay. Nó cũng cho phép thực sựổn địnhCác chức năng sẽ được xây dựng: Vì các kèo bóng đá hom nay liên tiếp sẽ sử dụng cùng một ảnh chụp nhanh, sẽ không có thay đổi nào trong kết quả.

Nói chung là không khôn ngoan khi trộn các kèo bóng đá hom nay chỉ đọc và đọc-ghi trong một chức năng bằng SPI; Điều đó có thể dẫn đến hành vi rất khó hiểu, vì các truy vấn chỉ đọc sẽ không thấy kết quả của bất kỳ bản cập nhật cơ sở dữ liệu nào được thực hiện bởi các truy vấn đọc-ghi.

Số lượng hàng thực tế mà kèo bóng đá hom nay (cuối cùng) được thực thi được trả về trong biến toàn cầuSPI_Proced. Nếu giá trị trả về của hàm làspi_ok_select, spi_ok_insert_returning, spi_ok_delete_returninghoặcspi_ok_update_returning, thì bạn có thể sử dụng con trỏ toàn cầuSpitupletable *spi_tuptableĐể truy cập các hàng kết quả. Một số kèo bóng đá hom nay tiện ích (chẳng hạn nhưGiải thích) cũng trả về các bộ hàng vàSPI_TUPTABLEcũng sẽ chứa kết quả trong những trường hợp này. Một số kèo bóng đá hom nay tiện ích (Copy, Tạo bảng dưới dạng) Không trả lại một bộ hàng, vì vậySPI_TUPTABLElà null, nhưng chúng vẫn trả về số lượng hàng được xử lý trongSPI_Proced.

Cấu trúcSpitupletableđược xác định như vậy:

15120_15441

Valslà một loạt các con trỏ đến các hàng. (Số lượng mục hợp lệ được đưa ra bởiSPI_Proced.)TUPDESClà một bộ mô tả hàng mà bạn có thể chuyển đến các chức năng SPI liên quan đến các hàng.TUPTABCXT, được phân bổvàmiễn phíCác trường nội bộ không được sử dụng để sử dụng bởi người gọi SPI.

spi_finishGiải phóng tất cảSpitupletableS được phân bổ trong hàm c hiện tại. Bạn có thể giải phóng một bảng kết quả cụ thể trước đó, nếu bạn đã hoàn thành nó, bằng cách gọispi_freetupable.

Đối số

giá trị trả về

Nếu việc thực hiện kèo bóng đá hom nay thành công thì một trong các giá trị (không âm) sau đây sẽ được trả về:

19523_19584

ghi chú

21151_21196SPI_ProcedvàSPI_TUPTABLE21282_21446SPI_EXECUTEhoặc một chức năng kèo bóng đá hom nay hiện truy vấn khác qua các cuộc gọi sau.