Thực thi lệnh SQL được đưa ra dưới dạng chuỗi. Một lỗi trong lệnh gây ra lỗi được nêu ra. Nếu không, giá trị trả về củaSPI_EXEClà số lượng hàng được xử lý (được chọn, chèn, kèo bóng đá hom nay nhật hoặc xóa) bởi lệnh hoặc bằng không nếu lệnh là một câu lệnh tiện ích. Ngoài ra, nếu lệnh làChọnCâu lệnh, các giá trị của các cột đã chọn được đặt trong các biến TCL như được mô tả bên dưới.

Tùy chọn-Countgiá trị cho biếtSPI_EXECĐể dừng một lầnnhàng đã được kèo bóng đá hom nay xuất, giống như kèo bóng đá hom nay vấn bao gồm Agiới hạnmệnh đề. Nếu nhưnbằng không, kèo bóng đá hom nay vấn được chạy để hoàn thành, giống như khi-Countđược bỏ qua.

Nếu lệnh làChọnCâu lệnh, các giá trị của các cột kết quả được đặt vào các biến TCL được đặt tên theo các cột. Nếu12657_12665Tùy chọn được đưa ra, các giá trị cột thay vào đó được lưu trữ thành các phần tử của mảng liên kết được đặt tên, với các tên cột được sử dụng làm chỉ mục mảng. Ngoài ra, số hàng hiện tại trong kết quả (đếm từ số 0) được lưu trữ vào phần tử mảng có tên.tupnoHồi13021_13083

Nếu lệnh làChọncâu lệnh và khôngloop-bodytập lệnh được đưa ra, thì chỉ có hàng kết quả đầu tiên được lưu trữ thành các biến TCL hoặc các phần tử mảng; Các hàng còn lại, nếu có, bị bỏ qua. Không có lưu trữ xảy ra nếu kèo bóng đá hom nay vấn trả về không có hàng. (Trường hợp này có thể được phát hiện bằng cách kiểm tra kết quả củaSPI_EXEC.) Ví dụ:

spi_exec "chọn đếm (*) dưới dạng cnt từ pg_proc"

13621_13649$ cntvới số lượng hàng trongPG_PROCDanh mục hệ thống.

Nếu tùy chọnloop-bodyĐối số được đưa ra, nó là một phần của tập lệnh TCL được thực thi một lần cho mỗi hàng trong kết quả kèo bóng đá hom nay vấn. (loop-bodybị bỏ qua nếu lệnh đã cho không phải làChọn.) Các giá trị của các cột của hàng hiện tại được lưu trữ thành các biến TCL hoặc các thành phần mảng trước mỗi lần lặp. Ví dụ:

SPI_EXEC -Array c "Chọn * từ pg_class" 
    ELOG gỡ lỗi "Have Bảng $ C (RelName)"

Sẽ in thông báo nhật ký cho mỗi hàngpg_ class. Tính năng này hoạt động tương tự như các cấu trúc vòng lặp TCL khác; đặc biệtTiếp tụcvàBreakLàm việc theo cách thông thường bên trong thân vòng.

Nếu một cột của kết quả kèo bóng đá hom nay vấn là null, biến mục tiêu cho nó làHồiunsetKhăn14777_14802

Chuẩn bị và lưu gói kèo bóng đá hom nay vấn để thực hiện sau. Kế hoạch đã lưu sẽ được giữ lại cho cuộc sống của phiên hiện tại.

kèo bóng đá hom nay vấn có thể sử dụng các tham số, nghĩa là giữ chỗ cho các giá trị được cung cấp bất cứ khi nào kế hoạch thực sự được thực hiện. Trong chuỗi kèo bóng đá hom nay vấn, tham khảo các tham số bằng các ký hiệu$ 1...$n. Nếu kèo bóng đá hom nay vấn sử dụng tham số, tên của các loại tham số phải được đưa ra làm danh sách TCL. (Viết một danh sách trống choTypelistNếu không sử dụng tham số.)

Giá trị trả về từSPI_Preparelà ID kèo bóng đá hom nay vấn được sử dụng trong các cuộc gọi tiếp theo đếnSPI_EXECP15888_15896SPI_EXECPVí dụ.

Thực hiện một kèo bóng đá hom nay vấn được chuẩn bị trước đó vớispi_prepare. QueryIDID được trả về bởiSPI_Prepare. Nếu các tham chiếu kèo bóng đá hom nay vấn tham chiếu, Adanh sách giá trịphải được cung cấp. Đây là danh sách TCL của các giá trị thực tế cho các tham số. Danh sách phải có cùng độ dài với danh sách loại tham số được cung cấp trước đây chospi_prepare. Bỏ quadanh sách giá trịNếu kèo bóng đá hom nay vấn không có tham số.

Giá trị tùy chọn cho-nullslà một chuỗi không gian và'n'Nhân vật TellingSPI_EXECPNhững tham số nào là giá trị null. Nếu được đưa ra, nó phải có độ dài chính xác vớidanh sách giá trị17491_17552

ngoại trừ cách chỉ định kèo bóng đá hom nay vấn và tham số của nó,SPI_EXECPhoạt động giống nhưSPI_EXEC. The-Count, -Arrayvàloop-bodyTùy chọn giống nhau và giá trị kết quả cũng vậy.

Đây là một ví dụ về chức năng kèo bóng đá hom nay bằng cách sử dụng gói đã chuẩn bị:

Tạo hàm T1_Count (Integer, Integer) Trả về số nguyên dưới dạng $$
    Nếu ! [thông tin tồn tại gd (kế hoạch)] 
        # Chuẩn bị kế hoạch đã lưu trong cuộc gọi đầu tiên
        Đặt gd (kế hoạch) [spi_prepare \
                "Chọn Đếm (*) là CNT từ T1 trong đó num = \ $ 1 và num <= \ $ 2" \
                [Danh sách Int4 Int4]]

    SPI_EXECP -Count 1 $ gd (kế hoạch) [Danh sách $ 1 $ 2]
    trả về $ cnt
$$ ngôn ngữ pltcl;

Chúng tôi cần dấu gạch chéo ngược bên trong chuỗi kèo bóng đá hom nay vấn được cung cấp choSPI_PrepareĐể đảm bảo rằng$nĐiểm đánh dấu sẽ được kèo bóng đá hom nayền quaspi_prepareas-is và không được thay thế bằng thay thế biến TCL.

Tập lệnh TCL có tronglệnhđược thực thi trong một phép trừ SQL. Nếu tập lệnh trả về một lỗi, toàn bộ phần trừ đó sẽ được cuộn lại trước khi trả lại lỗi cho mã TCL xung quanh. Nhìn thấyPhần 43.9Để biết thêm chi tiết và ví dụ.

Nhân đôi tất cả các lần xuất hiện của các ký tự trích dẫn và dấu gạch chéo ngược trong chuỗi đã cho. Điều này có thể được sử dụng để trích dẫn một cách an toàn các chuỗi sẽ được chèn vào các lệnh SQL được cung cấp choSPI_EXEChoặcspi_prepare. Ví dụ, hãy nghĩ về chuỗi lệnh SQL như:

"Chọn '$ val' làm ret"

trong đó biến TCLValthực tế chứakhông. Điều này sẽ dẫn đến chuỗi lệnh cuối cùng:

Chọn 'không' làm ret

Điều này sẽ gây ra lỗi phân tích cú pháp trong khiSPI_EXEChoặcspi_prepare. Để hoạt động đúng, lệnh đã gửi phải chứa:

Chọn 'không' làm ret

có thể được hình thành trong kèo bóng đá hom nay bằng cách sử dụng:

"Chọn '[QUOTE $ VAL]' là RET"

Một lợi thế củaSPI_EXECPCó phải bạn không phải trích dẫn các giá trị tham số như thế này, vì các tham số không bao giờ được phân tích cú pháp như một phần của chuỗi lệnh SQL.

phát ra thông báo nhật ký hoặc lỗi. Các cấp độ có thể làDebug, log, thông tin, Thông báo, cảnh báo, ERRORvàFatal. ERRORlàm tăng tình trạng lỗi; Nếu điều này không bị mắc kẹt bởi mã TCL xung quanh, lỗi sẽ kèo bóng đá hom nayền ra kèo bóng đá hom nay vấn gọi, khiến giao dịch hiện tại hoặc trừ bị hủy bỏ. Điều này thực sự giống như TCLERRORlệnh.Fatalhủy bỏ giao dịch và khiến phiên hiện tại đóng cửa. . Cho dù các thông điệp của một ưu tiên cụ thể được báo cáo cho máy khách, được ghi vào nhật ký máy chủ hay cả hai đều được điều khiển bởilog_min_messagesvàclient_min_messagesBiến cấu hình. Nhìn thấyChương 19vàPhần 43.8Để biết thêm thông tin.