# python-aiomysql

**Repository Path**: chenbool/python-aiomysql

## Basic Information

- **Project Name**: python-aiomysql
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-12-26
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# python-aiomysql

#### 介绍

python-aiomysql 是一个基于 aiomysql 的轻量级异步 MySQL 封装库，提供简洁的 API 用于异步数据库操作，支持连接池管理、查询、增删改等常用操作。

#### 软件架构

- **aiomysql**: 异步 MySQL 驱动
- **asyncio**: 异步编程支持
- **连接池**: 高效的数据库连接池管理

#### 功能特性

- 异步连接池管理
- 字典格式结果返回
- 简洁的查询 API
- 自动连接释放

#### 安装教程

1. 安装依赖库

```bash
pip install aiomysql
```

2. 确保 MySQL 服务正常运行

#### 使用说明

**基本使用示例**

```python
import asyncio
from orm import getAmysqlobj

async def main():
    # 初始化数据库对象
    mysqlobj = await getAmysqlobj()
    
    # 查询操作
    result = await mysqlobj.query("SELECT Host, User FROM user")
    print(result)
    
    # 增删改操作
    success = await mysqlobj.execute("UPDATE user SET User=%s WHERE Host=%s", ('newuser', 'localhost'))

asyncio.run(main())
```

**ORM 类说明**

- `Pmysql`: 主数据库操作类
  - `initpool()`: 初始化连接池
  - `query()`: 执行查询操作
  - `execute()`: 执行增删改操作

#### 配置说明

在 `orm.py` 中修改数据库连接配置：

```python
__pool = await aiomysql.create_pool(
    minsize=5,          # 连接池最小值
    maxsize=10,         # 连接池最大值
    host='127.0.0.1',  # 数据库地址
    port=3306,          # 端口
    user='root',        # 用户名
    password='root',    # 密码
    db='mysql',         # 数据库名
    autocommit=True,    # 自动提交
)
```

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request