This tutorial shows you how to work with MySQL BLOB data in Python, with examples of updating and reading BLOB data.
The authors
table has a column named photo
whose data type is BLOB. We will read data from a picture file and update to the photo column.
Updating BLOB data in Python
First, we develop a function named read_file()
that reads a file and returns the file’s content:
1
2
3
4
|
def read_file(filename):
with open(filename, 'rb') as f:
photo = f.read()
return photo
|
Second, we create a new function named update_blob()
that updates photo for an author specified by author_id
.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
from mysql.connector import MySQLConnection, Error
from python_mysql_dbconfig import read_db_config
def update_blob(author_id, filename):
# read file
data = read_file(filename)
# prepare update query and data
query = "UPDATE authors "
"SET photo = %s "
"WHERE id = %s"
args = (data, author_id)
db_config = read_db_config()
try:
conn = MySQLConnection(**db_config)
cursor = conn.cursor()
cursor.execute(query, args)
conn.commit()
except Error as e:
print(e)
finally:
cursor.close()
conn.close()
|
Let’s examine the code in detail:
- First, we call the
read_file()
function to read data from a file and return it. - Second, we compose an UPDATE statement that updates photo column for an author specified by
author_id
. Theargs
variable is a tuple that contains file data andauthor_id
. We will pass this variable to theexecute()
method together with thequery
. - Third, inside the
try except
block, we connect to the database, instantiate a cursor, and execute the query withargs
. To make the change effective, we callcommit()
method of the MySQLConnection object. - Fourth, we close the cursor and database connection in the
finally
block.
Notice that we imported MySQLConnection and Error objects from the MySQL Connector/Python package and read_db_config()
function from the python_mysql_dbconfig
module that we developed in the previous tutorial.
Let’s test the update_blob()
function.
1
2
3
4
5
|
def main():
update_blob(144, "picturesgarth_stein.jpg")
if __name__ == '__main__':
main()
|
Notice that you can use the following photo and put it into the pictures folder for testing.
Inside the main function, we call the update_blob()
function to update the photo column for the author with id 144. To verify the result, we select data from the authors
table.
1
2
|
SELECT * FROM authors
WHERE id = 144;
|
It works as expected.
Reading BLOB data in Python
In this example, we select BLOB data from the authors
table and write it into a file.
First, we develop a write_file()
function that write a binary data into a file as follows:
1
2
3
|
def write_file(data, filename):
with open(filename, 'wb') as f:
f.write(data)
|
Second, we create a new function named read_blob()
as below:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
def read_blob(author_id, filename):
# select photo column of a specific author
query = "SELECT photo FROM authors WHERE id = %s"
# read database configuration
db_config = read_db_config()
try:
# query blob data form the authors table
conn = MySQLConnection(**db_config)
cursor = conn.cursor()
cursor.execute(query, (author_id,))
photo = cursor.fetchone()[0]
# write blob data into a file
write_file(photo, filename)
except Error as e:
print(e)
finally:
cursor.close()
conn.close()
|
The read_blob()
function reads BLOB data from the authors
table and write it into a file specified by the filename
parameter.
The code is straightforward:
- First, we compose a SELECT statement that retrieves photo of a specific author.
- Second, we get the database configuration by calling the
read_db_config()
function. - Third, inside the
try except
block, we connect to the database, instantiate cursor, and execute the query. Once we got the BLOB data, we use thewrite_file()
function to write it into a file specified by thefilename
. - Fourth, in the finally block, we close the cursor and database connection.
Now, let’s test the read_blob()
function.
1
2
3
4
5
|
def main():
read_blob(144,"outputgarth_stein.jpg")
if __name__ == '__main__':
main()
|
If you open the output folder in the project and see a picture there, it means that you have successfully read the blob from the database.