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, tỷ lệ kèo bóng đá tối nay nhật hoặc xóa) bởi lệnh hoặc 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ết11790_11800Để dừng một lầnnHàng đã được truy xuất, giống như truy vấn bao gồm Agiới hạnmệnh đề. Nếu nhưnbằng không, truy vấn được chạy để hoàn thành, giống như khi-Countbị 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ếu-ArrayTù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ênMạnh.tupno, Trừ khi tên đó được sử dụng làm tên cột trong kết quả.

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 truy 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"

Sẽ đặt biến TCL$ 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, đó 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ả truy vấn. (loop-body13663_13707Chọ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 phần tử mảng trước mỗi lần lặp. Ví dụ:

13907_13997

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ả truy vấn là null, biến mục tiêu cho nó làunsetthay vì được đặt.

Chuẩn bị và lưu gói truy 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.

Truy 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 thi. Trong chuỗi truy vấn, tham khảo các tham số bằng các ký hiệu$ 1...$n. Nếu truy 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 truy vấn được sử dụng trong các cuộc gọi tiếp theo đếnSPI_EXECP. Nhìn thấySPI_EXECPVí dụ.

Thực hiện một truy vấn được chuẩn bị trước đó vớispi_prepare. QueryIDID có được trả về bởispi_prepare. Nếu các tham chiếu truy 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 truy 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ị. Nếu nó không được cung cấp, tất cả các giá trị tham số đều không phải là không.

Ngoại trừ cách chỉ định truy 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 tỷ lệ kèo bóng đá tối 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 truy vấn được trao chospi_prepareĐể đảm bảo rằng$nĐiểm đánh dấu sẽ được truyền quaspi_prepareas-is và không được thay thế bằng thay thế biến TCL.

Tập lệnh TCL chứa 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 42.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:

19788_19815

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' như Ret

có thể được hình thành trong tỷ lệ kèo bóng đá tối nay bằng cách sử dụng:

20172_20208

Một lợi thế củaSPI_EXECP20280_20414

phát ra thông báo nhật ký hoặc lỗi. Các cấp độ có thể làDEBUG, log, INFO, Thông báo, cảnh báo, ERRORvàFatal. ERROR21041_21275ERRORlệ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 42.8Để biết thêm thông tin.