以查询字符串和可选的行数限制参数调用 plpy.execute 会让该查询运行，并在一个结果 对象中返回结果。

如果指定了 limit 且大于 零，那么 plpy.execute 至多取回 limit 行，就像查询包含了 LIMIT 子句一样。省略 limit 或将其指定为 零则表示没有行数限制。

结果对象模拟列表或字典对象。 结果对象可以按行号和列名访问。例如：

rv = plpy.execute("SELECT * FROM my_table", 5)

会从 my_table 返回至多 5 行。如果 my_table 有列 my_column，可以这样访问：

foo = rv[i]["my_column"]

返回的行数可以用内建的 len 函数获得。

结果对象还有这些额外的方法：

结果对象可以被修改。

注意，调用 plpy.execute 会导致整个结果集被读入 内存。只有当您确定结果集相对较小时才使用该函数。如果不想在取回 大结果时冒内存使用过大的风险，请使用 plpy.cursor 而不是 plpy.execute。

plpy.prepare 为查询准备执行计划。 它以查询字符串和参数类型列表调用（如果查询中有参数引用）。 例如：

plan = plpy.prepare("SELECT last_name FROM my_users WHERE first_name = $1", ["text"])

text 是您将要为 $1 传入的 变量的类型。如果不想给查询传任何参数，第二个参数是可选的。

准备好语句之后，使用 plpy.execute 函数的 另一个变体来运行它：

rv = plpy.execute(plan, ["name"], 5)

把计划作为第一个参数传入（而不是查询字符串），把要替换进查询的 值的列表作为第二个参数。如果查询不期望任何参数，第二个参数是 可选的。第三个参数是可选的行数限制，与之前一样。

或者，您可以在计划对象上调用 execute 方法：

rv = plan.execute(["name"], 5)

查询参数和结果行字段按 Section 44.2 中所述在 PostgreSQL 与 Python 数据类型之间转换。

用 PL/Python 模块准备计划时，它会被自动保存。 这意味着什么请阅读 SPI 文档（Chapter 45）。 要在函数调用之间有效地利用这一点，需要使用持久存储字典 SD 或 GD（见 Section 44.3）。例如：

CREATE FUNCTION usesavedplan() RETURNS trigger AS $$
    if "plan" in SD:
        plan = SD["plan"]
    else:
        plan = plpy.prepare("SELECT 1")
        SD["plan"] = plan
    # rest of function
$$ LANGUAGE plpython3u;

plpy.cursor 函数接受与 plpy.execute 相同的参数（行数限制除外），并 返回一个游标对象，它允许您以更小的块处理大型结果集。 与 plpy.execute 一样，可以使用查询字符串或 计划对象加参数列表，也可以把 cursor 函数 作为计划对象的方法调用。

游标对象提供一个接受整型参数并返回结果对象的 fetch 方法。每次调用 fetch，返回的对象都会包含下一批行，绝不会 超过参数值。一旦所有行都被取完，fetch 就会 开始返回空结果对象。游标对象还提供 迭代器 接口，一次产出一行，直到所有行都取完。 这样取得的数据不是以结果对象的形式返回，而是以字典的形式返回， 每个字典对应一行结果。

以两种方式处理大表数据的示例如：

CREATE FUNCTION count_odd_iterator() RETURNS integer AS $$
odd = 0
for row in plpy.cursor("select num from largetable"):
    if row['num'] % 2:
         odd += 1
return odd
$$ LANGUAGE plpython3u;

CREATE FUNCTION count_odd_fetch(batch_size integer) RETURNS integer AS $$
odd = 0
cursor = plpy.cursor("select num from largetable")
while True:
    rows = cursor.fetch(batch_size)
    if not rows:
        break
    for row in rows:
        if row['num'] % 2:
            odd += 1
return odd
$$ LANGUAGE plpython3u;

CREATE FUNCTION count_odd_prepared() RETURNS integer AS $$
odd = 0
plan = plpy.prepare("select num from largetable where num % $1 <> 0", ["integer"])
rows = list(plpy.cursor(plan, [2]))  # or: = list(plan.cursor([2]))

return len(rows)
$$ LANGUAGE plpython3u;

游标会被自动释放。但如果想显式释放游标持有的所有资源，请使用 close 方法。一旦关闭，游标就不能再被 fetch 了。