自定义数据库配置

MrDoc 默认使用 `SQLite`数据库作为数据存储的数据库，如果你使用`Sqlite` 数据库，则无需另外配置数据库。

对于非高并发写入使用，推荐使用 Django 自带的 `Sqlite` 数据库，本文档站点（https://doc.mrodc.pro) 即是使用 `SQLite` 作为后端数据库。

## 使用其他数据库

### 安装数据库依赖

>i **信息提示**
>
> 官方 Docker 镜像已包含 MySQL、PostgreSQL数据库依赖，Docker 部署方式无需额外安装

如果有配置其他数据库的需求，请首先参照 `Django` 官方文档中支持的数据库的说明：

[https://docs.djangoproject.com/zh-hans/4.2/ref/databases/](https://docs.djangoproject.com/zh-hans/4.2/ref/databases/)

- PostgreSQL 数据库请安装`psycopg`，PostgreSQL >= 12
- MySQL 数据库请安装`mysqlclient`，MySQL >= 8.0
- Oracle 数据库请安装`cx_Oracle`，Oracle >= 19c

安装好相应数据库的 `Python` 绑定库。

### 进行数据库配置

然后在觅思文档项目的`config` 目录下打开 `config.ini` 文件，填写相应的数据数信息：

```
# engine，指定数据库类型，接受 sqlite、mysql、oracle、postgresql
engine = sqlite
# name 表示数据库的名称
# name = db_name
# user 表示数据库用户名
# user = db_user
# password 表示数据库用户密码
# password = db_pwd
# host 表示数据库主机地址
# host = db_host
# port 表示数据库端口
# port = db_port
```

>d 请注意：请务必使用 Django 官方推荐的后端数据库连接器，否则可能会有未知的错误产生！  
> 下述操作务必在项目运行之前操作，否则可能会有数据丢失的风险！

### 初始化数据库

然后执行数据库初始化的两条命令：

```
python manage.py makemigrations
```

和：

```
python manage.py migrate
```

## MySQL 示例

### 安装 mysqlclient

```
pip install mysqlclient
```

### 配置数据库连接信息

打开配置文件 /MrDoc/config/config.ini，修改`[database]`项下相关的信息为：

```
[database]
engine = mysql
name = 数据库名
user = 数据库用户名
password = 数据库用户密码
host = 数据库的连接地址
port = 数据库的连接端口
```

### 初始化数据库

执行命令：

```
python manage.py makemigrations
```

和命令：

```
python manage.py migrate
```