使用查询字符串和可选的行限制参数调用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方法。关闭后，将无法再从游标中获取数据。