Phiên bản được hỗ trợ:hiện tại(17)16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản không được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0

SPI_EXECUTE

spi_execute - tỷ lệ kèo bóng đá 88 lệnh

Synopsis

int spi_execute (const char *tỷ lệ kèo bóng đá 88, Boolread_only, dàiĐếm)

Mô tả

SPI_EXECUTEtỷ lệ kèo bóng đá 88 lệnh SQL được chỉ định choĐếmhàng. Nếu nhưread_onlytrue, lệnh phải chỉ đọc và chi phí tỷ lệ kèo bóng đá 88 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ì lệnh được tỷ lệ kèo bóng đá 88 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; tỷ lệ kèo bóng đá 88 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 lệnh tỷ lệ kèo bóng đá 88 sự trả về hàng.

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 tỷ lệ kèo bóng đá 88 sẽ dừng sau lần thứ nămTrở vềHàng kết quả được truy xuất.

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

khiread_onlySai, SPI_EXECUTETăng bộ đếm tỷ lệ kèo bóng đá 88 và tính toán mớiSnapshotTrước khi tỷ lệ kèo bóng đá 88 mỗi lệnh 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 tỷ lệ kèo bóng đá 88 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 tỷ lệ kèo bóng đá 88 đang sửa đổi cơ sở dữ liệu.

Khiread_onlyTRUE, SPI_EXECUTEKhông cập nhật ảnh chụp nhanh hoặc bộ đếm tỷ lệ kèo bóng đá 88 và nó chỉ cho phép đơn giảnChọnlệnh xuất hiện trong chuỗi lệnh. Các lệnh được tỷ lệ kèo bóng đá 88 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 tỷ lệ kèo bóng đá 88 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 lệnh 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 tỷ lệ kèo bóng đá 88 hiện bởi các truy vấn đọc-ghi.

Số lượng hàng thực tế mà lệnh (cuối cùng) được tỷ lệ kèo bóng đá 88 đượ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_returning, spi_ok_update_returninghoặcspi_ok_merge_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ố tỷ lệ kèo bóng đá 88 tiện ích (chẳng hạn nhưGiải thích) cũng trả về các bộ hàng vàspi_tupablecũng sẽ chứa kết quả trong những trường hợp này. Một số tỷ lệ kèo bóng đá 88 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_tupablelà 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

Các trườngTUPDESC, ValsnumvalsCó thể được sử dụng bởi người gọi SPI; các trường còn lại là nội bộ.Valslà một loạt các con trỏ đến các 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 các 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ố

const char *tỷ lệ kèo bóng đá 88

chuỗi chứa lệnh để tỷ lệ kèo bóng đá 88

boolread_only

TRUEđể tỷ lệ kèo bóng đá 88 hiện chỉ đọc

LongĐếm

Số lượng hàng tối đa để trả về hoặc0không giới hạn

giá trị trả về

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

spi_ok_select

Nếu AChọn(nhưng khôngChọn vào) đã được tỷ lệ kèo bóng đá 88

spi_ok_selinto

Nếu AChọn vàođã được tỷ lệ kèo bóng đá 88

spi_ok_insert

Nếu mộtChènđã được tỷ lệ kèo bóng đá 88

spi_ok_delete

Nếu AXóađã được tỷ lệ kèo bóng đá 88

spi_ok_update

Nếu mộtCập nhậtđã được tỷ lệ kèo bóng đá 88

spi_ok_merge

Nếu AHợp nhấtđã được tỷ lệ kèo bóng đá 88

spi_ok_insert_returning

Nếu mộtChèn trả lạiđã được tỷ lệ kèo bóng đá 88

spi_ok_delete_returning

Nếu AXóa trả vềđã được tỷ lệ kèo bóng đá 88

spi_ok_update_returning

Nếu mộtCập nhật trả vềđã được tỷ lệ kèo bóng đá 88 hiện

spi_ok_merge_returning

Nếu AHợp nhất trở lạiđã được tỷ lệ kèo bóng đá 88 hiện

spi_ok_utility

Nếu tỷ lệ kèo bóng đá 88 tiện ích (ví dụ:Tạo bảng) đã được tỷ lệ kèo bóng đá 88

spi_ok_rewritten

Nếu tỷ lệ kèo bóng đá 88 được viết lại thành một loại tỷ lệ kèo bóng đá 88 khác (ví dụ:Cập nhậtTrở thành mộtChèn) bởi Aquy tắc.

Khi lỗi, một trong các giá trị âm sau được trả về:

spi_error_argument

nếutỷ lệ kèo bóng đá 88nullhoặcĐếmnhỏ hơn 0

spi_error_copy

nếuSao chép vào stdouthoặcSao chép từ StdinĐã được cố gắng

spi_error_transaction

Nếu một tỷ lệ kèo bóng đá 88 thao tác giao dịch đã được thử (Bắt đầu, cam kết, rollback, SavePoint, Chuẩn bị giao dịch, cam kết đã chuẩn bị, Chuẩn bị rollbackhoặc bất kỳ biến thể nào của chúng)

spi_error_opunknown

Nếu loại tỷ lệ kèo bóng đá 88 không xác định (không nên xảy ra)

spi_error_unconnected

Nếu được gọi từ hàm C không kết nối

Ghi chú

Tất cả các chức năng tỷ lệ kèo bóng đá 88 tế SPI truy vấn được đặtSPI_Procedspi_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 các 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 tỷ lệ kèo bóng đá 88 hiện truy vấn khác qua các cuộc gọi sau.

Gửi hiệu chỉnh

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 khớpMẫu nàyĐể báo cáo vấn đề tài liệu.