Mô -đun ngôn ngữ PL/Python tự động nhập mô -đun Python gọi làplpy
. Các chức năng và hằng số trong mô -đun này có sẵn cho bạn trong mã Python làplpy.
.foo
Theplpy
Mô -đun cung cấp một số chức năng để thực thi các lệnh cơ sở dữ kèo bóng đá việt nam:
plpy.thực thi
(kèo bóng đá việt nam vấn
[,giới hạn
])
Gọiplpy.execute
Với chuỗi kèo bóng đá việt nam vấn và đối số giới hạn hàng tùy chọn khiến kèo bóng đá việt nam vấn được chạy và kết quả sẽ được trả về trong một đối tượng kết quả.
nếugiới hạn
được chỉ định và lớn hơn 0, sau đóplpy.execute
Truy kèo bóng đá việt nam nhiều nhấtgiới hạn
hàng, giống như kèo bóng đá việt nam vấn bao gồm mộtgiới hạn
mệnh đề. Bỏ quaGiới hạn
hoặc chỉ định nó dưới dạng không dẫn đến giới hạn hàng.
Đối tượng kết quả mô phỏng một danh sách hoặc đối tượng từ điển. Đối tượng kết quả có thể được truy kèo bóng đá việt nam bằng số hàng và tên cột.
rv = plpy.execute ("Chọn * từ my_table", 5)
Trả về tối đa 5 hàng từmy_table
. Nếu nhưmy_table
Có cộtmy_column
, nó sẽ được truy kèo bóng đá việt nam như:
foo = rv [i] ["my_column"]
Số lượng hàng được trả về có thể thu được bằng cách sử dụng tích hợplen
chức năng.
Đối tượng kết quả có các phương thức bổ sung này:
NROWS
()
Trả về số lượng hàng được xử lý theo lệnh. Lưu ý rằng điều này không nhất thiết giống như số lượng hàng được trả về.kèo bóng đá việt nam nhật
Lệnh sẽ đặt giá trị này nhưng sẽ không trả lại bất kỳ hàng nào (trừ khiTrở về
được sử dụng).
trạng thái
()
Thespi_execute ()
Giá trị trả lại.
colnames
()
coltypes
()
coltypmods
()
Trả về danh sách các tên cột, danh sách các loại cột OID và danh sách các bộ sửa đổi loại cụ thể cho các cột, tương ứng.
Các phương pháp này nêu ra một ngoại lệ khi được gọi trên một đối tượng kết quả từ một lệnh không tạo ra một tập kết quả, ví dụ:kèo bóng đá việt nam nhật
không cóTrở về
hoặcBẢNG DROP
. Nhưng bạn có thể sử dụng các phương thức này trên một tập kết quả chứa các hàng không.
__str__
()
tiêu chuẩn__str__
Phương thức được xác định để có thể ví dụ để gỡ lỗi kết quả thực thi kèo bóng đá việt nam vấn bằng cách sử dụngplpy.debug (rv)
.
Đối tượng kết quả có thể được sửa đổi.
Lưu ý rằng gọiplpy.execute
sẽ khiến toàn bộ kết quả được thiết lập được đọc vào bộ nhớ. Chỉ sử dụng chức năng đó khi bạn chắc chắn rằng tập kết quả sẽ tương đối nhỏ.plpy.cursor
chứ không phảiplpy.execute
.
plpy.Chuẩn bị
(kèo bóng đá việt nam vấn
[,argtypes
])
plpy.thực thi
(kế hoạch
[,Đối số
[,giới hạn
]])
plpy.prepare
Chuẩn bị kế hoạch thực thi cho một kèo bóng đá việt nam vấn. Nó được gọi với một chuỗi kèo bóng đá việt nam vấn và danh sách các loại tham số, nếu bạn có tham chiếu tham số trong kèo bóng đá việt nam vấn.
plan = plpy.prepare ("chọn last_name từ my_users trong đó first_name = $ 1", ["văn bản"])
Text
là loại biến bạn sẽ kèo bóng đá việt namền cho$ 1
. Đối số thứ hai là tùy chọn nếu bạn không muốn chuyển bất kỳ tham số nào cho kèo bóng đá việt nam vấn.
Sau khi chuẩn bị một câu lệnh, bạn sử dụng một biến thể của hàmplpy.execute
Để chạy nó:
rv = plpy.execute (kế hoạch, ["name"], 5)
Chuyển kế hoạch làm đối số đầu tiên (thay vì chuỗi kèo bóng đá việt nam vấn) và danh sách các giá trị để thay thế vào kèo bóng đá việt nam vấn làm đối số thứ hai. Đối số thứ hai là tùy chọn nếu kèo bóng đá việt nam vấn không mong đợi bất kỳ tham số nào.
Ngoài ra, bạn có thể gọithực thi
Phương thức trên đối tượng kế hoạch:
rv = plan.execute (["name"], 5)
Các tham số truy vấn và các trường hàng kết quả được chuyển đổi giữa các loại dữ kèo bóng đá việt nam PostgreSQL và Python như được mô tả trongPhần 44.2.
Khi bạn chuẩn bị một kế hoạch bằng mô -đun PL/Python, nó sẽ được lưu tự động. Đọc tài kèo bóng đá việt nam SPI (Chương 45) Để biết mô tả về ý nghĩa của điều này. Để sử dụng hiệu quả điều này trên các chức năng, người ta cần sử dụng một trong các từ điển lưu trữ liên tụcSD
hoặcGD
(xemPhần 44.3). Ví dụ:
Tạo chức năng sử dụng đã sử dụng)
plpy.con trỏ
(kèo bóng đá việt nam vấn
)
plpy.con trỏ
(kế hoạch
[,Đối số
])
Theplpy.cursor
Hàm chấp nhận các đối số giống nhưplpy.execute
(ngoại trừ giới hạn hàng) và trả về một đối tượng con trỏ, cho phép bạn xử lý các bộ kết quả lớn trong các khối nhỏ hơn. Như vớiplpy.execute
, Một chuỗi kèo bóng đá việt nam vấn hoặc đối tượng kế hoạch cùng với danh sách các đối số có thể được sử dụng hoặccon trỏ
Hàm có thể được gọi là phương thức của đối tượng kế hoạch.
Đối tượng con trỏ cung cấp mộtFetch
Phương thức chấp nhận tham số số nguyên và trả về một đối tượng kết quả. Mỗi lần bạn gọiFetch
, đối tượng được trả về sẽ chứa lô hàng tiếp theo, không bao giờ lớn hơn giá trị tham số. Khi tất cả các hàng đã cạn kiệt,Fetch
Bắt đầu trả về một đối tượng kết quả trống. Các đối tượng con trỏ cũng cung cấp mộtGiao diện iterator, năng suất một hàng tại một thời điểm cho đến khi tất cả các hàng bị cạn kiệt. Dữ kèo bóng đá việt nam được lấy theo cách đó không được trả về dưới dạng các đối tượng kết quả, mà là từ điển, mỗi từ điển tương ứng với một hàng kết quả.
Một ví dụ về hai cách xử lý dữ kèo bóng đá việt nam từ một bảng lớn là:
Tạo chức năng Count_odd_iterator () Trả về số nguyên dưới dạng $$
con trỏ được tự động xử lý. Nhưng nếu bạn muốn phát hành rõ ràng tất cả các tài nguyên do con trỏ nắm giữ, hãy sử dụngĐóng
Phương pháp. Sau khi đóng, con trỏ không thể được tìm nạp từ nữa.
Không nhầm lẫn các đối tượng được tạo bởiplpy.cursor
với các con trỏ DB-API theo định nghĩa củaThông số kỹ thuật API cơ sở dữ kèo bóng đá việt nam Python. Họ không có điểm chung nào ngoại trừ tên.
Các chức năng truy cập cơ sở dữ kèo bóng đá việt nam có thể gặp lỗi, điều này sẽ khiến chúng hủy bỏ và nêu ra một ngoại lệ. Cả haiplpy.execute
vàplpy.prepare
Có thể nâng cao một thể hiện của một lớp con củaplpy.spierror
, theo mặc định sẽ chấm dứt chức năng. Lỗi này có thể được xử lý giống như bất kỳ ngoại lệ python nào khác, bằng cách sử dụngthử/ngoại trừ
Xây dựng. Ví dụ:
Tạo chức năng Try_adding_joe () trả về văn bản dưới dạng $$
lớp thực tế của ngoại lệ được nâng lên tương ứng với điều kiện cụ thể gây ra lỗi. Tham khảoBảng A.1Để biết danh sách các điều kiện có thể. Mô -đunplpy.spiexceptions
23109_23148POSTGRESQLĐiều kiện, lấy tên của họ từ tên điều kiện. Ví dụ,Division_by_zero
trở thànhDivisionbyzero
, độc đáo_violation
trở thànhđộc đáo
, FDW_ERROR
trở thànhfdwerror
, v.v. Mỗi lớp ngoại lệ này kế thừa từSpierror
. Sự phân tách này giúp xử lý các lỗi cụ thể dễ dàng hơn:
23751_24308
Lưu ý rằng vì tất cả các ngoại lệ từplpy.spiexceptions
Di chuyển mô -đun từSpierror
, an24494_24502
Xử lý mệnh đề Nó sẽ bắt bất kỳ lỗi truy cập cơ sở dữ kèo bóng đá việt nam nào.
Là một cách thay thế để xử lý các điều kiện lỗi khác nhau, bạn có thể bắt đượcSpierror
Ngoại lệ và xác định điều kiện lỗi cụ thể bên trongngoại trừ
khối bằng cách nhìn vàoSQLSTATE
Thuộc tính của đối tượng ngoại lệ. Thuộc tính này là một giá trị chuỗi chứaSQLSTATEHồiMã lỗi. Cách tiếp cận này cung cấp cùng một chức năng
Nếu bạn thấy bất cứ điều gì trong tài kèo bóng đá việt nam không chính xác, không khớpMẫu nàyĐể báo cáo vấn đề tài kèo bóng đá việt nam.