Joenothing-lst / nonebot_plugin_navicat

database plugin for nonebot2

nonebot_plugin_navicat

• 基于nonebot2

功能

• 对外暴露出数据库连接 支持mysql mongodb redis

开始使用

必须使用 pip

• 通过 pip 从 PyPI 安装

pip install nonebot-plugin-navicat

• 我全都要

pip install nonebot-plugin-navicat[all]

• 要使用mysql

pip install nonebot-plugin-navicat[mysql]

• 要使用postgresql

pip install nonebot-plugin-navicat[postgresql]

• 要使用sqlite

pip install nonebot-plugin-navicat[sqlite]

• 要使用mongodb

pip install nonebot-plugin-navicat[mongodb]

• 要使用redis

pip install nonebot-plugin-navicat[redis]

• 在 nonebot2 项目中设置 load_plugin()

nonebot.load_plugin('nonebot_plugin_navicat')

• 参照下文在 nonebot2 项目的环境文件 .env.* 中添加配置项

配置项

配置数据库连接

# mysql 如果有MYSQL_HOST则表示要进行mysql连接
MYSQL_HOST=
MYSQL_PORT=
MYSQL_USER=
MYSQL_PASSWORD=

# postgresql 如果有PGSQL_HOST则表示要进行postgresql连接
PGSQL_HOST=
PGSQL_PORT=
PGSQL_USER=
PGSQL_PASSWORD=

# sqlite 如果有SQLITE_HOST则表示要进行sqlite连接 这里是路径
SQLITE_HOST=

# mongodb 如果有MONGODB_HOST则表示要进行mongodb连接
MONGODB_HOST=
MONGODB_PORT=
MONGODB_USER=
MONGODB_PASSWORD=

# redis 如果有REDIS_HOST则表示要进行redis连接
REDIS_HOST=
REDIS_PORT=
REDIS_PASSWORD=
REDIS_DB=

# 以后会加入更多数据库支持

导出给其他插件

export = nonebot.require("nonebot_plugin_navicat")
export.mysql_pool # mysql的
export.pgsql_pool # postgresql的
export.sqlite_pool #sqlite的
export.mongodb_client # mongodb的
export.redis_client # redis的

直接查询数据库 (0.2.0中已删除)

• 危险功能! 在配置中启用NAVICAT_EXECUTE_SQL=true来开启
• 使用方法:发送super ${dbname} + sql来查询

super mysql
show databases

更新记录

• v0.2.0 使用 databases 代替直接连接,有了广泛的通用性
• 移除了直接命令行查询数据库的功能,迁移到了单独的一个插件里面 nonebot-plugin-super

特别感谢

• Mrs4s / go-cqhttp
• nonebot / nonebot2

优化建议

• bug report
• more databases support