Python SQLite cursor.fetchone() Function

The Pythoncursor.fetchone() function retrieves data from the next query, this function returns a single sequence or None when there is no data is available.

This function can be used as an iterator, and thisfetechone() can also be called fetchall() and fetchmany(). It is particularly useful when we expect a query to return a single row or when we want to process rows one at a time.

Syntax

Following is the syntax for thecursor.fetchone() function.

row = cursor.fetchone()

Parameters

This function doesn't take any parameters.

Return Value

If a single row is available, then this function returns the next row as a tuple.

Example

Consider the following EMPLOYEES table which stores employees ID, Name, Age, Salary, City and Country −

Example 1

Here's an example using thecursor.fetchone() function to retrieve the first row from the table.

import sqlite3conn = sqlite3.connect('res.db')cursor = conn.cursor()cursor.execute("SELECT * FROM employees")row = cursor.fetchone()print(row)

Output

We will get the result as follows −

Example 2

In the example below, we are going to delete the first row from the table using thecursor.fetchone(), then this function will return the second row from the database.

import sqlite3conn = sqlite3.connect('res.db')cursor = conn.cursor()cursor.execute("DELETE FROM employees WHERE ID = 1")conn.commit()cursor.execute("SELECT  * FROM employees")print(cursor.fetchone())conn.close()

Output

The result is obtained as follows −

Example 3

Now, we are updating the first row in the database. Using thecursor.fetchone() function, it will then return the updated first row from the database.

import sqlite3conn = sqlite3.connect('res.db')cursor = conn.cursor()cursor.execute("UPDATE employees SET Salary = 5500.00 WHERE ID = 1")cursor.commit()cursor.execute("SELECT * FROM employees WHERE ID = 1")print(cursor.fetechone())conn.close()

Output

The output is obtained as follows −