使用查询字符串和一个可选的行限制参数调用 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)

查询参数和结果行字段在 PostgreSQL 和 Python 数据类型之间转换，如第 44.2 节中所述。

当您使用 PL/Python 模块准备计划时，它会自动保存。 阅读 SPI 文档（第 45 章）以了解这意味着什么。 为了在函数调用中有效地利用此功能，需要使用持久存储字典 SD 或 GD 之一（请参阅第 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 方法。 关闭后，游标将不再可以从中获取数据。