PostgreSQL - Python 介面

安裝

PostgreSQL 可以使用 psycopg2 模組與 Python 整合。psycopg2 是 Python 程式語言的 PostgreSQL 資料庫介面卡。psycopg2 的編寫目標是體積小、速度快且穩定可靠。您無需單獨安裝此模組，因為它預設隨 Python 2.5.x 及更高版本一起提供。

如果您機器上未安裝，則可以使用 yum 命令安裝，如下所示：

$yum install python-psycopg2

要使用 psycopg2 模組，您必須首先建立一個表示資料庫的 Connection 物件，然後可以選擇建立一個 cursor 物件，它將幫助您執行所有 SQL 語句。

Python psycopg2 模組 API

以下是重要的 psycopg2 模組例程，它們足以滿足您從 Python 程式中使用 PostgreSQL 資料庫的需求。如果您正在尋找更復雜的應用程式，則可以檢視 Python psycopg2 模組的官方文件。

序號	API & 描述
1	psycopg2.connect(database="testdb", user="postgres", password="cohondob", host="127.0.0.1", port="5432") 此 API 開啟到 PostgreSQL 資料庫的連線。如果資料庫成功開啟，則返回一個連線物件。
2	connection.cursor() 此例程建立一個遊標，它將在您使用 Python 進行的資料庫程式設計過程中使用。
3	cursor.execute(sql [, 可選引數]) 此例程執行 SQL 語句。SQL 語句可以是引數化的（即，使用佔位符而不是 SQL 字面量）。psycopg2 模組使用 %s 符號支援佔位符例如：cursor.execute("insert into people values (%s, %s)", (who, age))
4	cursor.executemany(sql, seq_of_parameters) 此例程對序列 sql 中找到的所有引數序列或對映執行 SQL 命令。
5	cursor.callproc(procname[, parameters]) 此例程執行具有給定名稱的儲存資料庫過程。引數序列必須包含過程期望的每個引數的一個條目。
6	cursor.rowcount 此只讀屬性返回上次 last execute*() 修改、插入或刪除的資料庫行的總數。
7	connection.commit() 此方法提交當前事務。如果您不呼叫此方法，則自上次呼叫 commit() 以來所做的任何操作都無法從其他資料庫連線中看到。
8	connection.rollback() 此方法回滾自上次呼叫 commit() 以來對資料庫的任何更改。
9	connection.close() 此方法關閉資料庫連線。請注意，這不會自動呼叫 commit()。如果您在不首先呼叫 commit() 的情況下關閉資料庫連線，則您的更改將丟失！
10	cursor.fetchone() 此方法獲取查詢結果集的下一行，返回單個序列，或者在沒有更多資料可用時返回 None。
11	cursor.fetchmany([size=cursor.arraysize]) 此例程獲取查詢結果的下一組行，返回一個列表。當沒有更多行可用時，將返回一個空列表。此方法嘗試獲取與 size 引數指示的數量相同的行。
12	cursor.fetchall() 此例程獲取查詢結果的所有（剩餘）行，返回一個列表。當沒有行可用時，將返回一個空列表。

連線到資料庫

以下 Python 程式碼顯示瞭如何連線到現有資料庫。如果資料庫不存在，則將建立它，最後將返回一個數據庫物件。

#!/usr/bin/python

import psycopg2

conn = psycopg2.connect(database="testdb", user = "postgres", password = "pass123", host = "127.0.0.1", port = "5432")

print "Opened database successfully"

在這裡，您還可以提供資料庫testdb作為名稱，如果資料庫成功開啟，則它將顯示以下訊息：

Open database successfully

建立表

以下 Python 程式將用於在先前建立的資料庫中建立表：

#!/usr/bin/python

import psycopg2

conn = psycopg2.connect(database = "testdb", user = "postgres", password = "pass123", host = "127.0.0.1", port = "5432")
print "Opened database successfully"

cur = conn.cursor()
cur.execute('''CREATE TABLE COMPANY
      (ID INT PRIMARY KEY     NOT NULL,
      NAME           TEXT    NOT NULL,
      AGE            INT     NOT NULL,
      ADDRESS        CHAR(50),
      SALARY         REAL);''')
print "Table created successfully"

conn.commit()
conn.close()

執行上述程式時，它將在您的test.db中建立 COMPANY 表，並將顯示以下訊息：

Opened database successfully
Table created successfully

INSERT 操作

以下 Python 程式顯示瞭如何在上面示例中建立的 COMPANY 表中建立記錄：

#!/usr/bin/python

import psycopg2

conn = psycopg2.connect(database = "testdb", user = "postgres", password = "pass123", host = "127.0.0.1", port = "5432")
print "Opened database successfully"

cur = conn.cursor()

cur.execute("INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) \
      VALUES (1, 'Paul', 32, 'California', 20000.00 )");

cur.execute("INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) \
      VALUES (2, 'Allen', 25, 'Texas', 15000.00 )");

cur.execute("INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) \
      VALUES (3, 'Teddy', 23, 'Norway', 20000.00 )");

cur.execute("INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) \
      VALUES (4, 'Mark', 25, 'Rich-Mond ', 65000.00 )");

conn.commit()
print "Records created successfully";
conn.close()

執行上述程式時，它將在 COMPANY 表中建立給定的記錄，並將顯示以下兩行：

Opened database successfully
Records created successfully

SELECT 操作

以下 Python 程式顯示瞭如何從上面示例中建立的 COMPANY 表中獲取和顯示記錄：

#!/usr/bin/python

import psycopg2

conn = psycopg2.connect(database = "testdb", user = "postgres", password = "pass123", host = "127.0.0.1", port = "5432")
print "Opened database successfully"

cur = conn.cursor()

cur.execute("SELECT id, name, address, salary  from COMPANY")
rows = cur.fetchall()
for row in rows:
   print "ID = ", row[0]
   print "NAME = ", row[1]
   print "ADDRESS = ", row[2]
   print "SALARY = ", row[3], "\n"

print "Operation done successfully";
conn.close()

執行上述程式時，將產生以下結果：

Opened database successfully
ID =  1
NAME =  Paul
ADDRESS =  California
SALARY =  20000.0

ID =  2
NAME =  Allen
ADDRESS =  Texas
SALARY =  15000.0

ID =  3
NAME =  Teddy
ADDRESS =  Norway
SALARY =  20000.0

ID =  4
NAME =  Mark
ADDRESS =  Rich-Mond
SALARY =  65000.0

Operation done successfully

UPDATE 操作

以下 Python 程式碼顯示瞭如何使用 UPDATE 語句更新任何記錄，然後從我們的 COMPANY 表中獲取和顯示更新的記錄：

#!/usr/bin/python

import psycopg2

conn = psycopg2.connect(database = "testdb", user = "postgres", password = "pass123", host = "127.0.0.1", port = "5432")
print "Opened database successfully"

cur = conn.cursor()

cur.execute("UPDATE COMPANY set SALARY = 25000.00 where ID = 1")
conn.commit()
print "Total number of rows updated :", cur.rowcount

cur.execute("SELECT id, name, address, salary  from COMPANY")
rows = cur.fetchall()
for row in rows:
   print "ID = ", row[0]
   print "NAME = ", row[1]
   print "ADDRESS = ", row[2]
   print "SALARY = ", row[3], "\n"

print "Operation done successfully";
conn.close()

執行上述程式時，將產生以下結果：

Opened database successfully
Total number of rows updated : 1
ID =  1
NAME =  Paul
ADDRESS =  California
SALARY =  25000.0

ID =  2
NAME =  Allen
ADDRESS =  Texas
SALARY =  15000.0

ID =  3
NAME =  Teddy
ADDRESS =  Norway
SALARY =  20000.0

ID =  4
NAME =  Mark
ADDRESS =  Rich-Mond
SALARY =  65000.0

Operation done successfully

DELETE 操作

以下 Python 程式碼顯示瞭如何使用 DELETE 語句刪除任何記錄，然後從我們的 COMPANY 表中獲取和顯示剩餘的記錄：

#!/usr/bin/python

import psycopg2

conn = psycopg2.connect(database = "testdb", user = "postgres", password = "pass123", host = "127.0.0.1", port = "5432")
print "Opened database successfully"

cur = conn.cursor()

cur.execute("DELETE from COMPANY where ID=2;")
conn.commit()
print "Total number of rows deleted :", cur.rowcount

cur.execute("SELECT id, name, address, salary  from COMPANY")
rows = cur.fetchall()
for row in rows:
   print "ID = ", row[0]
   print "NAME = ", row[1]
   print "ADDRESS = ", row[2]
   print "SALARY = ", row[3], "\n"

print "Operation done successfully";
conn.close()

執行上述程式時，將產生以下結果：

Opened database successfully
Total number of rows deleted : 1
ID =  1
NAME =  Paul
ADDRESS =  California
SALARY =  20000.0

ID =  3
NAME =  Teddy
ADDRESS =  Norway
SALARY =  20000.0

ID =  4
NAME =  Mark
ADDRESS =  Rich-Mond
SALARY =  65000.0

Operation done successfully

列印頁面