Python SQLite - Cursor Object



The sqlite3.Cursor class is an instance using which you can invoke methods that execute SQLite statements, fetch data from the result sets of the queries. You can create Cursor object using the cursor() method of the Connection object/class.

Example

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

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

Methods

Following are the various methods provided by the Cursor class/object.

Method Description
execute()

This routine executes an SQL statement. The SQL statement may be parameterized (i.e., placeholders instead of SQL literals). The psycopg2 module supports placeholder using %s sign

For example:cursor.execute("insert into people values (%s, %s)", (who, age))

executemany()

This routine executes an SQL command against all parameter sequences or mappings found in the sequence sql.

fetchone()

This method fetches the next row of a query result set, returning a single sequence, or None when no more data is available.

fetchmany()

This routine fetches the next set of rows of a query result, returning a list. An empty list is returned when no more rows are available. The method tries to fetch as many rows as indicated by the size parameter.

fetchall()

This routine fetches all (remaining) rows of a query result, returning a list. An empty list is returned when no rows are available.

Properties

Following are the properties of the Cursor class −

Method Description
arraySize

This is a read/write property you can set the number of rows returned by the fetchmany() method.

description

This is a read only property which returns the list containing the description of columns in a result-set.

lastrowid

This is a read only property, if there are any auto-incremented columns in the table, this returns the value generated for that column in the last INSERT or, UPDATE operation.

rowcount

This returns the number of rows returned/updated in case of SELECT and UPDATE operations.

connection

This read-only attribute provides the SQLite database Connection used by the Cursor object.

Advertisements