Python database access
2 likes240 views
The Python DB-API standard supports connecting to and interacting with many database servers like MySQL, PostgreSQL, and Oracle. To access a database, a Python module like MySQLdb must be installed. Code examples demonstrate how to connect to a MySQL database, create tables, insert/update/delete records, and handle errors according to the DB-API. Transactions ensure data integrity using atomicity, consistency, isolation, and durability properties.
![# Open database connection
db = MySQLdb.connect("localhost","testuser","test123","TESTDB" )
# prepare a cursor object using cursor() method
cursor = db.cursor()
# Prepare SQL query to INSERT a record into the database.
sql = "SELECT * FROM EMPLOYEE
WHERE INCOME > '%d'" % (1000)
try:
# Execute the SQL command
cursor.execute(sql)
# Fetch all the rows in a list of lists.
results = cursor.fetchall()
for row in results:
fname = row[0]
lname = row[1]
age = row[2]
sex = row[3]
income = row[4]
# Now print fetched result
print "fname=%s,lname=%s,age=%d,sex=%s,income=%d" %
(fname, lname, age, sex, income )
except:
print "Error: unable to fecth data"
# disconnect from server
db.close()
This willproduce the following result:
fname=Mac, lname=Mohan, age=20, sex=M, income=2000
Update Operation:
UPDATE Operationonany databasse means to update one or more records, whichare already available inthe
database. Following is the procedure to update allthe records having SEX as 'M'. Here, we willincrease AGE of
allthe males by one year.
Example:
#!/usr/bin/python
import MySQLdb
# Open database connection
db = MySQLdb.connect("localhost","testuser","test123","TESTDB" )
# prepare a cursor object using cursor() method
cursor = db.cursor()
# Prepare SQL query to UPDATE required records
sql = "UPDATE EMPLOYEE SET AGE = AGE + 1
WHERE SEX = '%c'" % ('M')
try:
# Execute the SQL command
cursor.execute(sql)
# Commit your changes in the database
db.commit()
except:
# Rollback in case there is any error
db.rollback()
# disconnect from server
db.close()
DELETE Operation:](https://image.slidesharecdn.com/pythondatabaseaccess-190712151151/85/Python-database-access-5-320.jpg)
Python database access
- 1. http://www.tutorialspoint.com/python/python_database_access.htm Copyright © tutorialspoint.com PYTHON MYSQL DATABASE ACCESS The Pythonstandard for database interfaces is the PythonDB-API. Most Pythondatabase interfaces adhere to this standard. Youcanchoose the right database for your application. PythonDatabase API supports a wide range of database servers: GadFly mSQL MySQL PostgreSQL Microsoft SQL Server 2000 Informix Interbase Oracle Sybase Here is the list of available Pythondatabase interfaces: PythonDatabase Interfaces and APIs .Youmust download a separate DB API module for eachdatabase youneed to access. For example, if youneed to access anOracle database as wellas a MySQL database, youmust download boththe Oracle and the MySQL database modules. The DB API provides a minimalstandard for working withdatabases using Pythonstructures and syntax wherever possible. This API includes the following: Importing the API module. Acquiring a connectionwiththe database. Issuing SQL statements and stored procedures. Closing the connection We would learnallthe concepts using MySQL, so let's talk about MySQLdb module only. What is MySQLdb? MySQLdb is aninterface for connecting to a MySQL database server fromPython. It implements the Python Database API v2.0 and is built ontop of the MySQL C API. How do I install the MySQLdb? Before proceeding, youmake sure youhave MySQLdb installed onyour machine. Just type the following inyour Pythonscript and execute it: #!/usr/bin/python import MySQLdb If it produces the following result, thenit means MySQLdb module is not installed: Traceback (most recent call last): File "test.py", line 3, in <module>
- 2. import MySQLdb ImportError: No module named MySQLdb To installMySQLdb module, download it fromMySQLdb Download page and proceed as follows: $ gunzip MySQL-python-1.2.2.tar.gz $ tar -xvf MySQL-python-1.2.2.tar $ cd MySQL-python-1.2.2 $ python setup.py build $ python setup.py install Note: Make sure youhave root privilege to installabove module. Database Connection: Before connecting to a MySQL database, make sure of the followings: Youhave created a database TESTDB. Youhave created a table EMPLOYEE inTESTDB. This table is having fields FIRST_NAME, LAST_NAME, AGE, SEX and INCOME. User ID "testuser" and password "test123" are set to access TESTDB. Pythonmodule MySQLdb is installed properly onyour machine. Youhave gone throughMySQL tutorialto understand MySQL Basics. Example: Following is the example of connecting withMySQL database "TESTDB" #!/usr/bin/python import MySQLdb # Open database connection db = MySQLdb.connect("localhost","testuser","test123","TESTDB" ) # prepare a cursor object using cursor() method cursor = db.cursor() # execute SQL query using execute() method. cursor.execute("SELECT VERSION()") # Fetch a single row using fetchone() method. data = cursor.fetchone() print "Database version : %s " % data # disconnect from server db.close() While running this script, it is producing the following result inmy Linux machine. Database version : 5.0.45 If a connectionis established withthe datasource, thena ConnectionObject is returned and saved into db for further use, otherwise db is set to None. Next, db object is used to create a cursor object, whichinturnis used to execute SQL queries. Finally, before coming out, it ensures that database connectionis closed and resources are released. Creating Database Table: Once a database connectionis established, we are ready to create tables or records into the database tables
- 3. using execute method of the created cursor. Example: First, let's create Database table EMPLOYEE: #!/usr/bin/python import MySQLdb # Open database connection db = MySQLdb.connect("localhost","testuser","test123","TESTDB" ) # prepare a cursor object using cursor() method cursor = db.cursor() # Drop table if it already exist using execute() method. cursor.execute("DROP TABLE IF EXISTS EMPLOYEE") # Create table as per requirement sql = """CREATE TABLE EMPLOYEE ( FIRST_NAME CHAR(20) NOT NULL, LAST_NAME CHAR(20), AGE INT, SEX CHAR(1), INCOME FLOAT )""" cursor.execute(sql) # disconnect from server db.close() INSERT Operation: INSERT operationis required whenyouwant to create your records into a database table. Example: Following is the example, whichexecutes SQL INSERT statement to create a record into EMPLOYEE table: #!/usr/bin/python import MySQLdb # Open database connection db = MySQLdb.connect("localhost","testuser","test123","TESTDB" ) # prepare a cursor object using cursor() method cursor = db.cursor() # Prepare SQL query to INSERT a record into the database. sql = """INSERT INTO EMPLOYEE(FIRST_NAME, LAST_NAME, AGE, SEX, INCOME) VALUES ('Mac', 'Mohan', 20, 'M', 2000)""" try: # Execute the SQL command cursor.execute(sql) # Commit your changes in the database db.commit() except: # Rollback in case there is any error db.rollback() # disconnect from server db.close() Above example canbe writtenas follows to create SQL queries dynamically:
- 4. #!/usr/bin/python import MySQLdb # Open database connection db = MySQLdb.connect("localhost","testuser","test123","TESTDB" ) # prepare a cursor object using cursor() method cursor = db.cursor() # Prepare SQL query to INSERT a record into the database. sql = "INSERT INTO EMPLOYEE(FIRST_NAME, LAST_NAME, AGE, SEX, INCOME) VALUES ('%s', '%s', '%d', '%c', '%d' )" % ('Mac', 'Mohan', 20, 'M', 2000) try: # Execute the SQL command cursor.execute(sql) # Commit your changes in the database db.commit() except: # Rollback in case there is any error db.rollback() # disconnect from server db.close() Example: Following code segment is another formof executionwhere youcanpass parameters directly: .................................. user_id = "test123" password = "password" con.execute('insert into Login values("%s", "%s")' % (user_id, password)) .................................. READ Operation: READ Operationonany databasse means to fetchsome usefulinformationfromthe database. Once our database connectionis established, we are ready to make a query into this database. We canuse either fetchone() method to fetchsingle record or fetchall() method to fetechmultiple values froma database table. fetchone(): This method fetches the next row of a query result set. A result set is anobject that is returned whena cursor object is used to query a table. fetchall(): This method fetches allthe rows ina result set. If some rows have already beenextracted fromthe result set, the fetchall() method retrieves the remaining rows fromthe result set. rowcount: This is a read-only attribute and returns the number of rows that were affected by an execute() method. Example: Following is the procedure to query allthe records fromEMPLOYEE table having salary more than1000: #!/usr/bin/python import MySQLdb
- 5. # Open database connection db = MySQLdb.connect("localhost","testuser","test123","TESTDB" ) # prepare a cursor object using cursor() method cursor = db.cursor() # Prepare SQL query to INSERT a record into the database. sql = "SELECT * FROM EMPLOYEE WHERE INCOME > '%d'" % (1000) try: # Execute the SQL command cursor.execute(sql) # Fetch all the rows in a list of lists. results = cursor.fetchall() for row in results: fname = row[0] lname = row[1] age = row[2] sex = row[3] income = row[4] # Now print fetched result print "fname=%s,lname=%s,age=%d,sex=%s,income=%d" % (fname, lname, age, sex, income ) except: print "Error: unable to fecth data" # disconnect from server db.close() This willproduce the following result: fname=Mac, lname=Mohan, age=20, sex=M, income=2000 Update Operation: UPDATE Operationonany databasse means to update one or more records, whichare already available inthe database. Following is the procedure to update allthe records having SEX as 'M'. Here, we willincrease AGE of allthe males by one year. Example: #!/usr/bin/python import MySQLdb # Open database connection db = MySQLdb.connect("localhost","testuser","test123","TESTDB" ) # prepare a cursor object using cursor() method cursor = db.cursor() # Prepare SQL query to UPDATE required records sql = "UPDATE EMPLOYEE SET AGE = AGE + 1 WHERE SEX = '%c'" % ('M') try: # Execute the SQL command cursor.execute(sql) # Commit your changes in the database db.commit() except: # Rollback in case there is any error db.rollback() # disconnect from server db.close() DELETE Operation:
- 6. DELETE operationis required whenyouwant to delete some records fromyour database. Following is the procedure to delete allthe records fromEMPLOYEE where AGE is more than20: Example: #!/usr/bin/python import MySQLdb # Open database connection db = MySQLdb.connect("localhost","testuser","test123","TESTDB" ) # prepare a cursor object using cursor() method cursor = db.cursor() # Prepare SQL query to DELETE required records sql = "DELETE FROM EMPLOYEE WHERE AGE > '%d'" % (20) try: # Execute the SQL command cursor.execute(sql) # Commit your changes in the database db.commit() except: # Rollback in case there is any error db.rollback() # disconnect from server db.close() Performing Transactions: Transactions are a mechanismthat ensures data consistency. Transactions should have the following four properties: Atomicity: Either a transactioncompletes or nothing happens at all. Consistency: A transactionmust start ina consistent state and leave the systemina consistent state. Isolation: Intermediate results of a transactionare not visible outside the current transaction. Durability: Once a transactionwas committed, the effects are persistent, evenafter a systemfailure. The PythonDB API 2.0 provides two methods to either commit or rollback a transaction. Example: Youalready have seenhow we have implemented transations. Here is againsimilar example: # Prepare SQL query to DELETE required records sql = "DELETE FROM EMPLOYEE WHERE AGE > '%d'" % (20) try: # Execute the SQL command cursor.execute(sql) # Commit your changes in the database db.commit() except: # Rollback in case there is any error db.rollback() COMMIT Operation: Commit is the operation, whichgives a greensignalto database to finalize the changes, and after this operation, no change canbe reverted back. Here is a simple example to callcommit method. db.commit()
- 7. ROLLBACK Operation: If youare not satisfied withone or more of the changes and youwant to revert back those changes completely, thenuse rollback() method. Here is a simple example to callrollback() method. db.rollback() Disconnecting Database: To disconnect Database connection, use close() method. db.close() If the connectionto a database is closed by the user withthe close() method, any outstanding transactions are rolled back by the DB. However, instead of depending onany of DB lower levelimplementationdetails, your applicationwould be better off calling commit or rollback explicitly. Handling Errors: There are many sources of errors. A few examples are a syntax error inanexecuted SQL statement, a connectionfailure, or calling the fetchmethod for analready canceled or finished statement handle. The DB API defines a number of errors that must exist ineachdatabase module. The following table lists these exceptions. Exception Description Warning Used for non-fatalissues. Must subclass StandardError. Error Base class for errors. Must subclass StandardError. InterfaceError Used for errors inthe database module, not the database itself. Must subclass Error. DatabaseError Used for errors inthe database. Must subclass Error. DataError Subclass of DatabaseError that refers to errors inthe data. OperationalError Subclass of DatabaseError that refers to errors suchas the loss of a connectionto the database. These errors are generally outside of the controlof the Pythonscripter. IntegrityError Subclass of DatabaseError for situations that would damage the relationalintegrity, suchas uniqueness constraints or foreignkeys. InternalError Subclass of DatabaseError that refers to errors internalto the database module, such as a cursor no longer being active. ProgrammingError Subclass of DatabaseError that refers to errors suchas a bad table name and other things that cansafely be blamed onyou. NotSupportedError Subclass of DatabaseError that refers to trying to callunsupported functionality. Your Pythonscripts should handle these errors, but before using any of the above exceptions, make sure your MySQLdb has support for that exception. Youcanget more informationabout themby reading the DB API 2.0 specification.