Ubuntu Python数据库连接怎样配置

Ubuntu 下 Python 数据库连接配置指南

一 准备与安装

万事开头难，配置的第一步是把环境准备好。别担心，跟着下面这几步走，基础环境很快就能搭建起来。

更新软件源并安装数据库（按需其一或多项）

• MySQL：打开终端，执行 sudo apt update && sudo apt install mysql-server。
• PostgreSQL：同样是先更新，再安装：sudo apt update && sudo apt install postgresql postgresql-contrib。
• SQLite：这个通常系统已经自带，如果需要开发头文件，可以运行 sudo apt install sqlite3 libsqlite3-dev。

安装 Python 驱动（与所用数据库匹配）

• MySQL：通过 pip 安装 mysql-connector-python 或 PyMySQL。
• PostgreSQL：安装 psycopg2 或更便捷的 psycopg2-binary。
• SQLite：Python 内置了 sqlite3 模块，无需额外安装，开箱即用。

初始化与安全（如安装的是 MySQL）

• 安装完成后，强烈建议执行 sudo mysql_secure_installation 来完成基础安全加固，比如设置 root 密码、移除匿名用户等操作。

二 数据库与账户配置

数据库服务装好了，接下来就是创建我们自己的数据库和用户。不同数据库的操作略有差异，这里分别说明。

PostgreSQL

• 首先，切换到 postgres 系统用户并进入交互终端：sudo -u postgres psql。
• 在 psql 命令行中，依次执行以下命令来创建数据库、用户并授权：
  • CREATE DATABASE yourdatabase;
  • CREATE USER yourusername WITH ENCRYPTED PASSWORD ‘yourpassword’;
  • GRANT ALL PRIVILEGES ON DATABASE yourdatabase TO yourusername;
  • 最后输入 \q 退出。

MySQL

• 使用 root 账户登录：mysql -u root -p。
• 创建一个数据库，并指定字符集以支持完整的 UTF-8（如表情符号）：CREATE DATABASE yourdatabase CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
• 创建用户并授权（以下示例仅允许从本机连接）：
  • CREATE USER ‘yourusername’@‘localhost’ IDENTIFIED BY ‘yourpassword’;
  • GRANT ALL PRIVILEGES ON yourdatabase.* TO ‘yourusername’@‘localhost’;
  • FLUSH PRIVILEGES;
• 如果需要远程访问，则需要创建用户如 ‘yourusername’@‘%’，并确保服务器的防火墙或云服务商的安全组放行了 3306 端口。另外，MySQL 8 常见的认证插件问题，可以用这条命令解决：ALTER USER ‘root’@‘localhost’ IDENTIFIED WITH mysql_native_password BY ‘yourpassword’;

三 连接示例

理论说再多，不如一行代码。下面分别给出三种数据库在 Python 中的连接和基本操作示例，你可以直接复制修改。

MySQL（使用 mysql-connector-python）

import mysql.connector
from mysql.connector import Error

try:
    conn = mysql.connector.connect(
        host=‘localhost’,
        port=3306,
        database=‘yourdatabase’,
        user=‘yourusername’,
        password=‘yourpassword’,
        charset=‘utf8mb4’
    )
    cur = conn.cursor()
    cur.execute(“SELECT DATABASE();”)
    print(cur.fetchone())
except Error as e:
    print(“MySQL error:”, e)
finally:
    if conn.is_connected():
        cur.close()
        conn.close()

PostgreSQL（使用 psycopg2）

import psycopg2

try:
    conn = psycopg2.connect(
        dbname=‘yourdatabase’,
        user=‘yourusername’,
        password=‘yourpassword’,
        host=‘localhost’,
        port=5432
    )
    cur = conn.cursor()
    cur.execute(“SELECT version();”)
    print(cur.fetchone())
except Exception as e:
    print(“PostgreSQL error:”, e)
finally:
    if conn:
        cur.close()
        conn.close()

SQLite（使用内置模块）

import sqlite3

conn = sqlite3.connect(‘yourdatabase.db’)
cur = conn.cursor()
cur.execute(‘’‘CREATE TABLE IF NOT EXISTS t(id INTEGER PRIMARY KEY, name TEXT)’‘’)
conn.commit()
cur.execute(“INSERT INTO t(name) VALUES (?)”, (“Alice”,))
for row in cur.execute(“SELECT * FROM t”):
    print(row)
conn.close()

四 常见问题与排查

配置过程很少一帆风顺，遇到问题别慌。下面这几个是高频“拦路虎”，附上了排查思路。

• Access denied / plugin auth_socket
  • 现象：root 用户在本地都连不上，或者只有系统用户能连。
  • 处理：在 MySQL 中执行 ALTER USER ‘root’@‘localhost’ IDENTIFIED WITH mysql_native_password BY ‘newpass’; 或者，更规范的做法是创建一个专用用户并授予目标数据库的权限。
• 1044 Access denied for user
  • 现象：不指定数据库能连，一指定就连不上。
  • 处理：检查用户权限，执行 GRANT ALL PRIVILEGES ON db_name.* TO ‘user’@‘host’; FLUSH PRIVILEGES; 确保授权到位。
• 2002 Can’t connect to MySQL server
  • 现象：连接被拒绝或超时。
  • 处理：首先确认服务是否在运行：sudo systemctl status mysql。然后检查 3306 端口是否在监听，以及服务器防火墙或云平台安全组规则是否放行。如果是远程连接，确保使用了正确的主机地址和允许远程登录的账户。
• 字符集乱码
  • 处理：确保数据库、表以及连接字符串三方统一使用 utf8mb4 字符集，在连接参数中加入 charset=‘utf8mb4’。