はじめに
Pythonの標準ライブラリである"sqlite3"の備忘録．
動作環境
- Python 3.12.0
- SQLite3モジュール 2.6.0
- SQLite 3.42.0
コマンド
データベース作成
import sqlite3
dbFile = 'test.db'
con = sqlite3.connect(dbFile)
con.close()
カレントディレクトリに"test.db"が無ければ作成します．すでに"test.db"が作成されていれば，"test.db"に接続します．
テーブル作成
テーブル作成は以下の手順で行います．
1. データベースに接続
2. カーソルオブジェクトを作成
3. テーブルを作成するCREATE文を実行
4. データベースに情報をコミット
5. データベースの接続を切断
import sqlite3
dbFile = 'test.db'
# 1.データベースに接続
con = sqlite3.connect(dbFile)
# 2.sqliteを操作するカーソルオブジェクトを作成
cur = con.cursor()
# 3.CREATE文を実行
cur.execute("""CREATE TABLE persons(id, name，gender)""")
# 4.データベースに情報をコミット
con.commit()
# 5.データベースの接続を切断
cur.close()
con.close()
テーブルを作成する時の基本となる構文は下記の通りです．
CREATE TABLE テーブル名(カラム名1, カラム名2, ...);
dbファイルにテーブルが存在しない場合のみ作成するときは，"IF NOT EXISTS"を追記します．
CREATE TABLE IF NOT EXISTS テーブル名(カラム名1, カラム名2, ...);
テーブルにデータ登録（INSERT文）
テーブルに含まれる全てのカラムに値を指定してデータを追加する場合，以下の構文を使用します．
INSERT INTO テーブル名 VALUES(値1, 値2, ...);
テーブルに含まれる特定のカラムを指定してデータを追加する場合，以下の構文を使用します．
INSERT INTO テーブル名(カラム名) values(値1);
以下，サンプルコードです．
import sqlite3
dbFile = 'test.db'
# 1.データベースに接続
con = sqlite3.connect(dbFile)
# 2.sqliteを操作するカーソルオブジェクトを作成
cur = con.cursor()
# 3.テーブルにデータを登録する
# 全てのカラムに値を指定してデータを追加する場合
cur.execute("INSERT INTO persons VALUES('1', 'Sato', 'male');")
# 1つのカラムに値を指定してデータを追加する場合
cur.execute('INSERT INTO persons(name) values("Tanaka")')
# 4.データベースにデータをコミット
con.commit()
# 5.データベースの接続を切断
cur.close()
con.close()
テーブルに含まれる全てのカラムに値を指定して複数のデータを追加する場合，以下のように記述します．
import sqlite3
dbFile = 'test.db'
# 1.データベースに接続
con = sqlite3.connect(dbFile)
# 2.sqliteを操作するカーソルオブジェクトを作成
cur = con.cursor()
# テーブルにデータを登録する
data = (
['1', 'Sato', 'Male'],
['2', 'Tanaka', 'Male'],
['3', 'Yamada', 'Female']
)
sql = "INSERT INTO persons VALUES(?, ?, ?)"
cur.execute(sql, data)
# 4.データベースにデータをコミット
con.commit()
# 5.データベースの接続を切断
cur.close()
con.close()
dataはリスト型かタプル型変数を使用します．
テーブルのカラム数に合わせて括弧内の?の数を変更してください．
テーブルのデータ取得（SELECT文）
データを取得する際の基本となる構文は以下の通りです．
SELECT カラム名1, カラム名2, ... FROM テーブル名;
SELECT の後のカラム名を指定することで，特定のデータのみ取得することができます．全てのデータを取得したいときは，上記のスクリプトのように，カラム名の場所を"*"で記述します．
WHERE句を使うと取得するデータの条件を絞ることができます．紹介は割愛します．以下，サンプルコードです．
import sqlite3
dbFile = 'test.db'
# 1.データベースに接続
con = sqlite3.connect(dbFile)
# 2.sqliteを操作するカーソルオブジェクトを作成
cur = con.cursor()
# 3.テーブルの全データを取得
cur.execute('SELECT * FROM persons')
# 取得したデータを出力
for row in cur:
print(row)
# 4.データベースの接続を切断
cur.close()
con.close()
テーブルデータの更新（UPDATE文）
テーブルに格納されているデータを新しい値に更新する際の基本となる構文は以下の通りです．
UPDATE テーブル名 SET カラム名1 = 値1, カラム名2 = 値2, ... WHERE 条件式;
WHERE句の条件式を使用して，更新の対象となるデータを指定します．条件式に一致するデータが複数の場合，該当するデータ全てが更新されます．WHERE句を省略すると，指定したテーブル内の全てのデータが更新されます．
SETの後に更新したいカラム名と更新後の値を指定します．以下，サンプルコードです．
import sqlite3
dbFile = 'test.db'
# 1.データベースに接続
con = sqlite3.connect(dbFile)
# 2.sqliteを操作するカーソルオブジェクトを作成
cur = con.cursor()
# 3.テーブルにデータを登録する
data = (
['1', 'Sato', 'Male'],
['2', 'Tanaka', 'Male'],
['3', 'Yamada', 'Female']
)
sql = "INSERT INTO persons VALUES(?, ?, ?)"
cur.execute(sql, data)
# 4.データベースにデータをコミット
con.commit()
# 5.データを更新
cur.execute("UPDATE persons SET name = 'ojisan' WHERE gender = 'Male';")
con.commit()
# 6.データベースの接続を切断
cur.close()
con.close()
これで "gender" 列が "Male" のデータの "name" が "ojisan" になりました．
['1', 'Sato', 'Male'], ['1', 'ojisan', 'Male'],
['2', 'Tanaka', 'Male'], → ['2', 'ojisan', 'Male'],
['3', 'Yamada', 'Female'] ['3', 'Yamada', 'Female']
テーブルデータの削除（DELETE文）
テーブルからデータを削除する際の基本となる構文は以下の通りです．
DELETE FROM テーブル名 WHERE 条件式;
WHERE句の条件式を使用して，削除の対象となるデータを指定します．条件式に一致するデータが複数の場合は，複数のデータがまとめて削除されます．WHERE句を省略すると，指定したテーブル内の全てのデータが削除されます．
import sqlite3
dbFile = 'test.db'
# 1.データベースに接続
con = sqlite3.connect(dbFile)
# 2.sqliteを操作するカーソルオブジェクトを作成
cur = con.cursor()
# 3.データを削除する
cur.execute("DELETE FROM persons WHERE name = "ojisan";")
# 4.データベースにデータをコミット
con.commit()
# 5.データベースの接続を切断
cur.close()
con.close()
これで "persons" というテーブルからおじさん（"name" が "ojisan" のデータ）が抹消されました．
