# mysql

**Repository Path**: opsx-tools/mysql

## Basic Information

- **Project Name**: mysql
- **Description**: MYSQL 命令行客户端
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-13
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opsx-mysql

MySQL 命令行工具，支持快速执行 SQL 和数据库操作。

## 特性

- 🚀 **快速执行**: 支持直接执行 SQL 语句
- 📊 **数据查询**: 查询、导出、格式化输出
- 🗄️ **数据库管理**: 列出数据库、表、查看表结构
- ⚡ **高性能**: 连接池、连接复用
- 🎯 **易于使用**: 简洁的 CLI 接口
- 💬 **交互模式**: 支持交互式 MySQL shell，支持 SQL 命令自动补全和历史记录

## 安装

### 快速下载（推荐）

自动检测平台并下载最新版本：

```bash
# 使用 wget
wget "https://gitee.com/opsx-tools/mysql/releases/download/latest/opsx-mysql-$(uname -s)-$(uname -m).tar.gz"

# 或使用 curl
curl -L -o opsx-mysql-$(uname -s)-$(uname -m).tar.gz \
  "https://gitee.com/opsx-tools/mysql/releases/download/latest/opsx-mysql-$(uname -s)-$(uname -m).tar.gz"
```

### 手动安装

```bash
# Linux/macOS
tar -xzf opsx-mysql-*.tar.gz
chmod +x opsx-mysql
sudo mv opsx-mysql /usr/local/bin/

# Windows
# 解压 zip 文件后直接运行
```

## 编译

```bash
go build -o opsx-mysql main.go
```

## 快速开始

### 直接执行 SQL

```bash
# 查询
opsx-mysql -u root -p "password" -h localhost -e "SELECT VERSION()"
opsx-mysql -u root -p "password" -h localhost -d mydb -e "SHOW TABLES"

# 执行
opsx-mysql -u root -p "password" -h localhost -d mydb -e "INSERT INTO users (name) VALUES ('test')"
```

### 子命令

```bash
# 查询数据
opsx-mysql query "SELECT * FROM users LIMIT 10" -u root -p "password" -d mydb

# 执行 SQL
opsx-mysql exec "UPDATE users SET name='test' WHERE id=1" -u root -p "password" -d mydb

# 列出表
opsx-mysql tables -u root -p "password" -d mydb

# 列出数据库
opsx-mysql databases -u root -p "password"

# 查看表结构
opsx-mysql describe users -u root -p "password" -d mydb

# 查看 MySQL 状态
opsx-mysql status -u root -p "password"
```

### 交互模式

```bash
# 进入交互式 MySQL shell（不加 -e 参数时自动进入）
opsx-mysql -u root -p "password" -h localhost -d mydb

# 在交互模式中：
# - 按 TAB 键自动补全 SQL 命令和关键字
# - 支持命令历史记录（上下箭头键）
# - 支持多行 SQL（以 ; 或 \g 结尾执行）
# - 输入 'help;' 或 '\h' 查看帮助
# - 输入 'exit;' 或 '\q' 退出

mysql> SELECT * FROM users LIMIT 10;
+----+------+
| id | name |
+----+------+
|  1 | test |
+----+------+
1 row in set (0.001 sec)

mysql> exit;
Bye
```

## 命令参数

- `-e, --execute`: 执行 SQL 语句
- `-h, --host`: 主机地址（默认: 127.0.0.1）
- `-P, --port`: 端口（默认: 3306）
- `-u, --user`: 用户名（默认: root）
- `-p, --password`: 密码
- `-d, --database`: 数据库名

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件