Python Sqlite 简明教程

Python SQLite - Cursor Object

sqlite3.Cursor 类是一个实例,使用它可以调用执行 SQLite 语句、从查询结果集中获取数据的函数。可以使用 Connection 对象/类的 cursor() 方法创建 Cursor 对象。

Example

import sqlite3
#Connecting to sqlite
conn = sqlite3.connect('example.db')

#Creating a cursor object using the cursor() method
cursor = conn.cursor()

Methods

以下是 Cursor 类/对象提供的各种方法。

Method

Description

execute()

此例程执行一个 SQL 语句。该 SQL 语句可能带参数(即占位符,而不是 SQL 字面值)。psycopg2 模块使用占位符 %s,例如:cursor.execute("insert into people values (%s, %s)", (who, age))

executemany()

此例程对在序列 sql 中找到的所有参数序列或映射执行 SQL 命令。

fetchone()

此方法提取查询结果集的下一行,返回单个序列,或在没有更多数据可用时返回 None。

fetchmany()

此例程提取查询结果的下一组行,返回一个列表。如果没有更多行时,会返回一个空列表。此方法尝试提取尽可能多的行,如由大小参数指示。

fetchall()

此例程提取查询结果的所有(剩余)行,返回一个列表。如果没有行时,会返回一个空列表。

Properties

以下为 Cursor 类的属性:

Method

Description

arraySize

这是一个读/写属性,可以设置 fetchmany() 方法返回的行数。

description

这是一个只读属性,它返回一个包含结果集中列描述的列表。

lastrowid

这是一个只读属性,如果表中存在任何自动增量列,它将返回在最近的 INSERT 或 UPDATE 操作中为此列生成的值。

rowcount

在 SELECT 和 UPDATE 操作时,它将返回返回/更新的行数。

connection

此只读属性提供 Cursor 对象使用的 SQLite 数据库连接。