Paul DuBois paul@kitebird.com

Утрыманне

• MySQLdb усталёўкі
• Кароткія DB-API сцэнара
  • Даць сцэнара
  • Запуск сцэнара
• Больш шырокія DB-API сцэнара
  • Апрацоўка памылак
  • Метады за заявы
• Партатыўнасць Notes
• Рэсурсы
• Прыкладанне
• Прызнанне
• Гісторыя змен

Python з'яўляецца адным з найболей папулярных моў праграмавання Крыніца Адкрыць, у значнай меры дзякуючы яго родным выразнасць, а таксама розныя падтрымка модуляў, якія даступныя для пашыраць яго магчымасці. Адзін з гэтых модуляў DB-API, які, як імя мае на ўвазе, падае прыкладны праграмны інтэрфейс базы дадзеных. DB-API прызначаны для адносна незалежнымі ад пэўных падрабязнасцяў для любой базы дадзеных, якія дапамогуць вам напісаць доступу да базы дадзеных сцэнараў, якія з'яўляюцца партатыўнымі паміж рухавікамі.

-API дызайн DB аналагічна таму, які выкарыстоўваў Perl і Ruby DBI модуляў PHP PEAR DB класа, і JDBC інтэрфейсу Java: ён выкарыстоўвае двухузроўневую архітэктуру, у якой верхні ўзровень падае абстрактны інтэрфейс, які аднолькавы для ўсіх падтрымоўваных СКБД, і ніжэйшы ўзровень, які складаецца з драйвераў для пэўных рухавікоў, якія апрацоўваюць рухавік-залежныя дэталі. Гэта азначае, вядома, выкарыстоўваць DB-API для напісання сцэнараў Python, вы павінны мець драйвера для вашай пэўнай сістэмы базы дадзеных. Для MySQL, DB-API забяспечвае доступ да базы дадзеных з дапамогай драйвера MySQLdb. Гэты дакумент пачынаецца з абмеркавання ўсталёўкі драйвераў (у выпадку, калі вы не MySQLdb), затым пераходзіць на вечка, як пісаць DB-API сцэнараў.

MySQLdb усталёўкі

Каб напісаць MySQL скрыпты, якія выкарыстоўваюць DB-API, Python сам павінен быць усталяваны. Гэта амаль напэўна будзе дакладна, калі вы выкарыстоўваеце Unix, але гэта меней верагодна для Windows. Усталёўнікі для любой платформы можна знайсці на вэб-сайце Python (гл. "Рэсурсы" часткі ў канцы гэтага дакумента).

Пераканаецеся, што ваша версія Python з'яўляецца 2.3.4 ці пазнейшай версіі, а модуль MySQLdb усталяваны. Вы можаце праверыць абое гэтыя патрабаванні, запусціўшы Python у інтэрактыўным рэжыме з каманднага радка (штосьці % для Unix ці C:\> для Windows):

 
   %python 
   Python 2.4.3 (#1, Aug 29 2006, 14:45:33)
   [GCC 3.4.6 (Gentoo 3.4.6-r1, ssp-3.4.5-1.0, pie-8.7.9)] on linux2
   Type "help", "copyright", "credits" or "license" for more information.
   >>> import MySQLdb 

 
   >>> import MySQLdb 
   Traceback (most recent call last):
     File "<stdin>", line 1, in ?
   ImportError: No module named MySQLdb

 
   %python setup.py build 
   %python setup.py install 

Кароткія DB-API сцэнара

Сцэнары, што доступ праз MySQL DB-API выкарыстаннем MySQLdb як правіла, выконваюць наступныя дзеянні:

• Імпарт модуля MySQLdb
• Адкрыць злучэнне з серверам MySQL
• Рабіць заявы і атрымліваць іх вынікі
• Зачыніць злучэнне з серверам

Даць сцэнара

Выкарыстоўвайце тэкставы рэдактар для стварэння файла з імем server_version.py, які ўтрымоўвае наступны сцэнар. Гэты сцэнар выкарыстоўвае MySQLdb узаемадзейнічаць з серверам MySQL, хоць і ў адносна рудыментарных моды - усё гэта робіць, гэта папытаць сервер для сваёй версіі радка:

 
   # server_version.py - retrieve and display database server version
 
   import MySQLdb
 
   conn = MySQLdb.connect (host = "localhost",
                           user = "testuser",
                           passwd = "testpass",
                           db = "test")
   cursor = conn.cursor ()
   cursor.execute ("SELECT VERSION()")
   row = cursor.fetchone ()
   print "server version:", row[0]
   cursor.close ()
   conn.close ()

 
   conn = MySQLdb.connect (host = "localhost",
                           user = "testuser",
                           passwd = "testpass",
                           db = "test")

Пасля падлучэння аб'екта быў атрыманы, server_version.py выклікае яго курсор () метад для стварэння аб'екта курсора для апрацоўкі заяў. Сцэнар выкарыстоўвае гэты курсор на пытанне SELECT VERSION () заява, якое вяртае радок, якая змяшчае інфармацыю пра версію сервера:

 
   cursor = conn.cursor ()
   cursor.execute ("SELECT VERSION()")
   row = cursor.fetchone ()
   print "server version:", row[0]
   cursor.close ()

Нарэшце, сцэнар выклікае падлучэнне аб'екта блізка () для злучэння з серверам:

 
   conn.close ()

 
   %python server_version.py 
   server version: 5.1.12-beta-log

 
   #!/usr/bin/python

 
   %chmod +x server_version.py 
   %./server_version.py 

 
   C:\> server_version.py 

Больш шырокія DB-API сцэнара

server_version.py мае шэраг недахопаў. Напрыклад, ён не перахапляць выключэнні ці паказаць, што пайшло не так, калі адбываецца памылка, і яна не дапушчае магчымасць таго, што заява ён працуе, магчыма, не даў вынікаў. У гэтай частцы паказана, як вырашаць гэтыя праблемы з выкарыстаннем больш складаных сцэнараў, animal.py, які выкарыстоўвае табліцу, якая змяшчае назвы жывёл і катэгорыі:

 
   CREATE TABLE animal
   (
     name     CHAR(40),
     category CHAR(40)
   )

Animal.py сцэнар пачынаецца так (у тым ліку сістэмы #! Лініі, калі вы збіраецеся запусціць скрыпт на Unix):

 
   #!/usr/bin/python
   # animal.py - create animal table and
   # retrieve information from it
 
   import sys
   import MySQLdb

Апрацоўка памылак

Пасля імпарту неабходных модуляў, animal.py усталёўвае злучэнне з серверам, выкарыстоўваючы Connect () выкліку. Для забеспячэння магчымасці абрыву сувязі (напрыклад, так што вы можаце паказаць чыннік адмовы), неабходна злавіць выключэнні. Для апрацоўкі выключэнняў у Python, змясціць ваш код у паспрабаваць заява і ўключаць за выключэннем пункта, які ўтрымоўвае код апрацоўкі памылак. У выніку злучэння паслядоўнасць выглядае наступным чынам:

 
   try:
     conn = MySQLdb.connect (host = "localhost",
                             user = "testuser",
                             passwd = "testpass",
                             db = "test")
   except MySQLdb.Error, e:
     print "Error %d: %s" %(e.args[0], e.args[1])
     sys.exit (1)

Любая база дадзеных, злучаныя з ёй сцвярджэння могуць быць змешчаны ў аналагічных try/except структуры для ўлоўлівання і паведамленні пра памылкі, для сцісласці, пасля абмеркавання не паказвае код апрацоўкі выключэнняў. (Поўны тэкст animal.py паказаны ў прыкладанні.)

Метады за заявы

 
   cursor = conn.cursor ()
   cursor.execute ("DROP TABLE IF EXISTS animal")
   cursor.execute ("""
       CREATE TABLE animal
       (
         name     CHAR(40),
         category CHAR(40)
       )
     """)
   cursor.execute ("""
       INSERT INTO animal (name, category)
       VALUES
         ('snake', 'reptile'),
         ('frog', 'amphibian'),
         ('tuna', 'fish'),
         ('racoon', 'mammal')
     """)
   print "Number of rows inserted: %d" %cursor.rowcount

 
   cursor.execute ("SELECT name, category FROM animal")
   while (1):
     row = cursor.fetchone ()
     if row == None:
       break
     print "%s, %s" %(row[0], row[1])
   print "Number of rows returned: %d" %cursor.rowcount

 
   print "%s, %s" %row

 
   cursor.execute ("SELECT name, category FROM animal")
   rows = cursor.fetchall ()
   for row in rows:
     print "%s, %s" %(row[0], row[1])
   print "Number of rows returned: %d" %cursor.rowcount

 
   print "%d rows were returned" %len (rows)

 
   cursor.close ()
   cursor = conn.cursor (MySQLdb.cursors.DictCursor)
   cursor.execute ("SELECT name, category FROM animal")
   result_set = cursor.fetchall ()
   for row in result_set:
     print "%s, %s" %(row["name"], row["category"])
   print "Number of rows returned: %d" %cursor.rowcount

 
   cursor.execute ("""
         UPDATE animal SET name = 'turtle'
         WHERE name = 'snake'
       """)
   print "Number of rows updated: %d" %cursor.rowcount

 
   cursor.execute ("""
         UPDATE animal SET name = %s
         WHERE name = %s
       """, ("snake", "turtle"))
   print "Number of rows updated: %d" %cursor.rowcount

 
   cursor.close ()
   conn.commit ()
   conn.close ()

Партатыўнасць Notes

Калі вы жадаеце, каб порт MySQLdb аснове DB-API сцэнара для выкарыстання з розных баз дадзеных, крыніцы не-пераноснасці адбыцца ў любым месцы, што імя драйвера могуць быць скарыстаны:

• Аператар import, што імпарт модуля драйвера. Гэта павінна быць зменена на імпарт розных драйвераў.
• Connect () выкліку, які падлучаецца да сервера базы дадзеных. Connect () метад даступны праз імя драйвера, модулі, так што імя драйвера павінна быць зменена. Акрамя таго, звязацца () аргумент сінтаксіс можа вар'іравацца паміж кіроўцамі.
• Апрацоўка выключэнняў. Выключэнне клас з імем, акрамя як становішча высылаецца праз імя драйвера.

Рэсурсы

Сцэнараў, якія выкарыстоўваюцца для прыкладаў у гэтым дакуменце можа быць загружаны па наступным адрасе:

 
   http://www.kitebird.com/articles/
 

• Эндзі Смяцяр, аўтар модуля MySQLdb, ёсць сайт па адрасе:

   
     http://dustman.net/andy/python/
   
  

  Гэты сайт з'яўляецца лепшым месца для чытання дакументацыі MySQLdb і часта задаваныя пытанні анлайн. Ён таксама ўтрымоўвае спасылкі на Debian і Windows бінарныя дыстрыбутывы. Каб атрымаць зыходны код ці Linux RPM, наведаеце MySQLdb SourceForge рэпазітары па адрасе:

   
     http://sourceforge.net/projects/mysql-python
   
  

• MySQL Павараная кніга складаецца з Python DB-API сярод базе інтэрфейсаў праграмавання, што яна складаецца з:

   
     http://www.kitebird.com/mysql-cookbook
   http://www.oreilly.com/catalog/mysqlckbk/
   
  

• На вэб-сайце Python мае ўсталёўнікаў для працэсара мове Python, вы павінны быць запушчаны на сістэме, якая не ён ужо ўсталяваны:

   
     http://www.python.org/
   
  

• Базы дадзеных SIG (адмысловая група па інтарэсах) вобласць на вэб-сайце Python утрымоўвае дадатковую інфармацыю API-DB:

   
     http://www.python.org/sigs/db-sig/
   
  

• Жывёл табліцы, выкарыстоўванай animal.py сцэнар таксама выкарыстоўваецца ў БД дакумент PEAR на сайце Kitebird:

   
     http://www.kitebird.com/articles/
   
  

  Вы маглі б знайсці гэта павучальна параўнаць гэты дакумент з гэтым, каб убачыць, як DB-API і PEAR DB з'яўляюцца аднолькавымі ці рознымі ў іх падыходах да баз дадзеных.

Прыкладанне

Поўны зыходны код для animal.py сцэнара паказана тут:

   #!/usr/bin/python
   # animal.py - create animal table and
   # retrieve information from it
 
   import sys
   import MySQLdb
 
   # connect to the MySQL server
 
   try:
     conn = MySQLdb.connect (host = "localhost",
                             user = "testuser",
                             passwd = "testpass",
                             db = "test")
   except MySQLdb.Error, e:
     print "Error %d: %s" %(e.args[0], e.args[1])
     sys.exit (1)
 
   # create the animal table and populate it
 
   try:
     cursor = conn.cursor ()
     cursor.execute ("DROP TABLE IF EXISTS animal")
     cursor.execute ("""
         CREATE TABLE animal
         (
           name     CHAR(40),
           category CHAR(40)
         )
       """)
     cursor.execute ("""
         INSERT INTO animal (name, category)
         VALUES
           ('snake', 'reptile'),
           ('frog', 'amphibian'),
           ('tuna', 'fish'),
           ('racoon', 'mammal')
       """)
     print "Number of rows inserted: %d" %cursor.rowcount
 
   # perform a fetch loop using fetchone()
 
     cursor.execute ("SELECT name, category FROM animal")
     while (1):
       row = cursor.fetchone ()
       if row == None:
         break
       print "%s, %s" %(row[0], row[1])
     print "Number of rows returned: %d" %cursor.rowcount
 
   # perform a fetch loop using fetchall()
 
     cursor.execute ("SELECT name, category FROM animal")
     rows = cursor.fetchall ()
     for row in rows:
       print "%s, %s" %(row[0], row[1])
     print "Number of rows returned: %d" %cursor.rowcount
 
   # issue a statement that changes the name by including data values
   # literally in the statement string, then change the name back
   # by using placeholders
 
     cursor.execute ("""
           UPDATE animal SET name = 'turtle'
           WHERE name = 'snake'
         """)
     print "Number of rows updated: %d" %cursor.rowcount
 
     cursor.execute ("""
           UPDATE animal SET name = %s
           WHERE name = %s
         """, ("snake", "turtle"))
     print "Number of rows updated: %d" %cursor.rowcount
 
   # create a dictionary cursor so that column values
   # can be accessed by name rather than by position
 
     cursor.close ()
     cursor = conn.cursor (MySQLdb.cursors.DictCursor)
     cursor.execute ("SELECT name, category FROM animal")
     result_set = cursor.fetchall ()
     for row in result_set:
       print "%s, %s" %(row["name"], row["category"])
     print "Number of rows returned: %d" %cursor.rowcount
 
     cursor.close ()
 
   except MySQLdb.Error, e:
     print "Error %d: %s" %(e.args[0], e.args[1])
     sys.exit (1)
 
   conn.commit ()
   conn.close ()

Гісторыя змен

• 1,00 - Арыгінальная версія.
• 1,01, 2003-01-24 - малаважныя змены.
• 1,02, 2006-09-17 - Прынясіце да даты MySQLdb 1.2.1. Дадаць інфармацыю пра рэжым аўтаматычнай фіксацыі і Commit () метад.