MySQL 安裝及使用基本教學

MySQL安裝

資料來源：
https://www.learncodewithmike.com/2020/02/python-mysql.html
依步驟安裝MySQL
下載網站:https://www.mysql.com/downloads/

選擇Windows的安裝檔

下載MSI安裝檔

點擊Download按鈕後，在下一個畫面選擇「No thanks, just start my download.」即可
選擇Develop Default，開始進行安裝

過程中有一個步驟是需要設定MySQL資料庫的管理員密碼，如下圖：

設定完成後，在接下來的安裝步驟中，需要驗證密碼，如下圖：

安裝完成後，開啟MySQL的資料庫管理工具 MySQL Workbench，如下圖：

MySQL 使用

點擊local instance MySQL80

輸入下載時設定的密碼

建立資料庫

輸入資料庫名稱(kkbox)及選擇字元集為utf8，如下圖：

接著點選Apply，資料庫就建立完成。

建立資料表：
需在左邊側欄的地方，切換到Schemas(模式)頁籤，如下圖：

其中可以看到剛剛所建立的資料庫，點選後，選擇Tables(資料表)，右鍵新增資料表(Create Table)，如下圖：

接著輸入資料表名稱(charts)及定義欄位，如下圖：

輸入完成後，同樣點選右下角的Apply，即完成資料表的建立。

新增資料表資料

MySQL資料庫的環境建置完成後，要透過Python進行存取，需要安裝pymysql套件(Package)，可以利用 pip install pymysql 指令來達成。接著開啟Python專案，新增一個db.py檔，用來練習接下來的資料庫操作。

而Python專案要存取MySQL資料庫，除了引用pymysql模組(Module)外，還需要設定連線的參數，這邊利用Python字典(Dictionary)資料型態來進行設定，如下範例：

import pymysql
import charts
# 資料庫參數設定
db_settings = {
    "host": "127.0.0.1",
    "port": 3306,
    "user": "root",
    "password": "資料庫管理員密碼",
    "db": "kkbox",
    "charset": "utf8"
}

接著，將資料庫參數傳入pymysql模組(Module)的connect()方法(Method)中，建立Connection物件。另外，在連線的過程中，可能會發生例外錯誤，所以建議使用Python的try-except例外處理機制，如下範例：

import pymysql
import charts
# 資料庫設定
db_settings = {
    "host": "127.0.0.1",
    "port": 3306,
    "user": "root",
    "password": "資料庫管理員密碼",
    "db": "kkbox",
    "charset": "utf8"
}
try:
    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
except Exception as ex:
    print(ex)

與資料庫的連線建立完成後，要進行相關的操作，需要建立Cursor(指標)物件來執行，這邊使用Python的with陳述式，當資料庫存取完成後，自動釋放連線，如下範例：

import pymysql
import charts
# 資料庫設定
db_settings = {
    "host": "127.0.0.1",
    "port": 3306,
    "user": "root",
    "password": "資料庫管理員密碼",
    "db": "kkbox",
    "charset": "utf8"
}
try:
    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
    # 建立Cursor物件
    with conn.cursor() as cursor:
      #資料表相關操作
except Exception as ex:
    print(ex)

接著即可在with陳述式區塊中，撰寫與執行SQL語法，而新增資料至資料表中需執行INSERT的SQL語法，如下範例：

    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
    # 建立Cursor物件
    with conn.cursor() as cursor:
        # 新增資料SQL語法
        command = "INSERT INTO charts(id, name, artist)VALUES(%s, %s, %s)"
        # 取得華語單曲日榜
        charts = charts.get_charts_tracks("H_PilcVhX-E8N0qr1-")
        for chart in charts:
            cursor.execute(
                command, (chart["id"], chart["name"], chart["album"]["artist"]["name"]))
        # 儲存變更
        conn.commit()

在第12行以華語單曲日榜的ID為例，呼叫get_charts_tracks()函式取得資料，回傳結果的格式為多筆字典(Dictionary)的串列(List)，所以可以透過Python迴圈，利用Cursor(指標)物件執行新增資料的SQL語法，將每筆資料的id、歌曲名稱及歌手寫入資料庫中，最後透過Connection物件的commit()方法儲存。

開啟MySQL Workbench的檢視模式，即可看到執行結果，如下範例：

執行結果：

查詢資料表資料

將華語單曲日榜的資料成功寫入charts資料表後，要透過Python撈取所有的資料，需執行SELECT的SQL語法，最後透過Cursor(指標)物件的fetchall()方法(Method)取回，如下範例

    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
    # 建立Cursor物件
    with conn.cursor() as cursor:
        # 查詢資料SQL語法
        command = "SELECT * FROM charts"
        # 執行指令
        cursor.execute(command)
        # 取得所有資料
        result = cursor.fetchall()
        print(result)

如果只想取得單筆資料(第一筆)，則可以利用fetchone()方法，如下範例：

    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
    # 建立Cursor物件
    with conn.cursor() as cursor:
        # 新增資料指令
        command = "SELECT * FROM charts"
        # 執行指令
        cursor.execute(command)
        # 取得第一筆資料
        result = cursor.fetchone()
        print(result)

而要取得特定筆數的資料，可以透過fetchmany()方法，傳入所需的筆數，如下範例：

    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
    # 建立Cursor物件
    with conn.cursor() as cursor:
        # 新增資料指令
        command = "SELECT * FROM charts"
        # 執行指令
        cursor.execute(command)
        # 取得前五筆資料
        result = cursor.fetchmany(5)
        print(result)

上述的查詢操作，皆是取回資料表中所有的資料，那要執行條件式的資料篩選，則可以加上WHERE語法，並且利用元組(Tuple)資料型態指定條件值，如下範例：

    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
    # 建立Cursor物件
    with conn.cursor() as cursor:
        # 新增資料指令
        command = "SELECT * FROM charts WHERE name = %s"
        # 執行指令
        cursor.execute(command, ("太陽",))
        # 取得所有資料
        result = cursor.fetchall()
        print(result)

執行結果：

修改資料表資料

假設要修改charts資料表中，id為5XeeDbHfELRucAOX6n的歌曲名稱(name)為Learn Code With Mike，需執行UPDATE的SQL語法，並且將主鍵(id)值及要修改的值(name)進行設定，最後透過Connection物件的commit()方法儲存。如下範例：

    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
    # 建立Cursor物件
    with conn.cursor() as cursor:
        # 修改資料SQL語法
        command = "UPDATE charts SET name = %s WHERE id = %s"
        # 執行指令
        cursor.execute(command, ("Learn Code With Mike", "5XeeDbHfELRucAOX6n"))
      
        #儲存變更
        conn.commit()

刪除資料表資料

如果要刪除charts資料表中，id為-ovxsQyee7WVLKuikC的資料，需執行DELETE的SQL語法，並且設定主鍵(id)值，最後透過Connection物件的commit()方法儲存。

    # 建立Connection物件
    conn = pymysql.connect(**db_settings)
    # 建立Cursor物件
    with conn.cursor() as cursor:
        # 刪除特定資料指令
        command = "DELETE FROM charts WHERE id = %s"
        # 執行指令
        cursor.execute(command, ("-ovxsQyee7WVLKuikC",))
        #儲存變更
        conn.commit()