Mô tả

SPI_EXECUTEThực thi soi kèo bóng đá truoctran SQL được chỉ định choĐếmhàng. Nếu nhưread_onlylàTRUE, soi kèo bóng đá truoctran phải chỉ đọc và chi phí thực thi bị giảm phần nào.

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ì soi kèo bóng đá truoctran đượ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áĐếmhàng sẽ được truy xuất; soi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran thực sự trả về hàng.

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

Chèn tất cả soi kèo bóng đá truoctran hàng từBar, bỏ quaCountTham 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 soi kèo bóng đá truoctran thi 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 soi kèo bóng đá truoctran trong một chuỗi;SPI_EXECUTETrả về kết quả cho soi kèo bóng đá truoctran được thực thi cuối cùng. TheĐếmGiới hạn áp dụng cho mỗi soi kèo bóng đá truoctran 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ỳ soi kèo bóng đá truoctran ẩn nào được tạo bởi các quy tắc.

Khiread_onlylàSai, SPI_EXECUTETăng bộ đếm soi kèo bóng đá truoctran và tính toán một bộ đếm mớiSnapshotTrước khi thực thi mỗi soi kèo bóng đá truoctran 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 trongĐọc cam kếtChế độ Cập nhật ảnh chụp nhanh cho phép mỗi soi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran đ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 soi kèo bóng đá truoctran và nó chỉ cho phép đơn giảnChọnsoi kèo bóng đá truoctran xuất hiện trong chuỗi soi kèo bóng đá truoctran. Các soi kèo bóng đá truoctran đượ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.ổn địnhCác chức năng sẽ được xây dựng: Vì các soi kèo bóng đá truoctran thi 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 soi kèo bóng đá truoctran chỉ đọc và đọc-viết 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à soi kèo bóng đá truoctran (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ố soi kèo bóng đá truoctran tiện ích (chẳng hạn nhưGiải thích) cũng trả về soi kèo bóng đá truoctran 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ố soi kèo bóng đá truoctran 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:

typedef struct Spitupletable

soi kèo bóng đá truoctran trườngTUPDESC, ValsvànumvalsCó thể được sử dụng bởi người gọi SPI; soi kèo bóng đá truoctran trường còn lại là nội bộ.Valslà một loạt soi kèo bóng đá truoctran con trỏ đến soi kèo bóng đá truoctran hàng. Số lượng hàng được đưa ra bởinumvals(Vì lý do lịch sử, số lượng này cũng được trả lại trongSPI_Proced).TUPDESClà một mô tả hàng mà bạn có thể chuyển đến soi kèo bóng đá truoctran chức năng SPI liên quan đến hàng.

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ả lại

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

Khi lỗi, một trong soi kèo bóng đá truoctran giá trị âm sau được trả về:

ghi chú

Tất cả các chức năng soi kèo bóng đá truoctran tế SPI truy vấn được đặtSPI_Procedvàspi_tupable(chỉ là con trỏ, không phải nội dung của cấu trúc). Lưu hai biến toàn cầu này vào soi kèo bóng đá truoctran biến hàm C cục bộ nếu bạn cần truy cập bảng kết quả củaSPI_EXECUTEhoặc một chức năng soi kèo bóng đá truoctran hiện truy vấn khác qua các cuộc gọi sau.