一、工具介绍

  Archery是archer的分支项目，定位于SQL审核查询平台，旨在提升DBA的工作效率，支持多数据库的SQL上线和查询，同时支持丰富的MySQL运维功能，所有功能都兼容手机端操作。
功能清单

	查询	审核	执行	备份	数据字典	慢日志	会话管理	账号管理	参数管理	数据归档
MySQL	√	√	√	√	√	√	√	√	√	√
MsSQL	√	×	√	×	×	×	×	×	×	×
Redis	√	×	√	×	×	×	×	×	×	×
PgSQL	√	×	√	×	×	×	×	×	×	×
Oracle	√	×	√	√	×	×	×	×	×	×
MongoDB	√	√	√	×	×	×	×	×	×	×

二、安装

2.1 基础环境安装

安装Python和virtualenv

# 安装EPEL源
yum install epel-release 
# 安装python36、pip36
yum install python36 python36-pip
# virtualenv
pip3.6 install virtualenv -i https://mirrors.ustc.edu.cn/pypi/web/simple/ 

2.2 数据库驱动安装

SQL SERVER

# CentOS 6
curl https://packages.microsoft.com/config/rhel/6/prod.repo > /etc/yum.repos.d/mssql-release.repo
# CentOS 7
curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/mssql-release.repo
# 卸载冲突驱动
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel
# 安装驱动
sudo ACCEPT_EULA=Y yum install msodbcsql17
sudo ACCEPT_EULA=Y yum install mssql-tools
# 更新环境变量
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# 安装ODBC依赖
sudo yum install unixODBC-devel

ORACLE

yum install http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/getPackage/oracle-instantclient19.3-basiclite-19.3.0.0.0-1.x86_64.rpm

2.3 数据库安装

MySQL推荐版本>=5.6
Redis提供任务队列和缓存
MongoDB为Themis使用(已经在v1.7.0版本移除，如果需要请下载v1.7.0之前的版本)

2.4 安装Inception(MySQL审核、查询校验和数据脱敏)

goInception: https://github.com/hanchuanchuan/goInception
项目默认使用goInception做MySQL审核和执行，目前Inception已经停止维护，推荐切换到goInception
Inception: https://github.com/hhyo/inception
MySQL查询数据脱敏依赖Inception，需要使用脱敏功能的必须安装和配置

2.5 nginx安装

#创建yum源
touch /etc/yum.repos.d/nginx.repo
[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

#安装nginx，修改配置文件
#yum install nginx
#cat /etc/nginx/conf.d/nginx.conf
server{listen 9123; # 监听的端口server_name archery;client_max_body_size 20M; # 处理Request Entity Too Largeproxy_read_timeout 600s;  # 超时时间与Gunicorn超时时间设置一致，主要用于在线查询location / {proxy_pass http://127.0.0.1:8000;proxy_set_header Host $host:9123; # 解决重定向404的问题，和listen端口保持一致，如果是docker则和宿主机映射端口保持一致proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header X-Forwarded-Proto $scheme;}location /static {alias /usr/local/archery/archery-1.7.13/static; # 此处指向settings.py配置项STATIC_ROOT目录的绝对路径，用于nginx收集静态资源}error_page 404 /404.html;location = /40x.html {}error_page 500 502 503 504 /50x.html;location = /50x.html {}}

2.6 archery安装

vi archery/settings.py
安全修改
请务必修改配置文件中的SECRET_KEY信息，该key用于敏感信息加密基础配置
# 修改SECRET_KEY
# 关闭debug模式
DEBUG = False
# 设置ALLOWED_HOSTS，建议限制内网访问
ALLOWED_HOSTS = ['.example.com',  # Allow domain and subdomains'.example.com.',  # Also allow FQDN and subdomains
]
# 请求大小限制，如果提交SQL语句过大可以修改该值
DATA_UPLOAD_MAX_MEMORY_SIZE = 15728640
# 密码校验，用户注册和添加密码校验规则
AUTH_PASSWORD_VALIDATORS = [{'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',},{'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator','OPTIONS': {'min_length': 9, }},{'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',},{'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',},
]
MySQL配置
建议MySQL版本5.6以上DATABASES = {'default': {'ENGINE': 'django.db.backends.mysql','NAME': 'archery', # 数据库名称'USER': 'root', # 数据库用户'PASSWORD': '', # 数据库密码'HOST': '127.0.0.1', # 数据库HOST，如果是docker启动并且关联，可以使用容器名连接'PORT': '3306',  # 数据库端口'OPTIONS': {'init_command': "SET sql_mode='STRICT_TRANS_TABLES'", # SQL_MODE，为了兼容select * group by，可以按需调整'charset': 'utf8mb4'},'TEST': {'NAME': 'test_archery','CHARSET': 'utf8mb4',},}
}
Django-Q配置
默认配置即可，也可参考django-q文档修改Q_CLUSTER = {'name': 'archery','workers': 4,'recycle': 500,'timeout': 60,'compress': True,'cpu_affinity': 1,'save_limit': 0,'queue_limit': 50,'label': 'Django Q','django_redis': 'default','sync': False  # 本地调试可以修改为True，使用同步模式}
缓存配置
缓存使用redis，可参考 django_redis 文档 http://django-redis-chs.readthedocs.io/zh_CN/latest/CACHES = {"default": {"BACKEND": "django_redis.cache.RedisCache","LOCATION": "redis://127.0.0.1:6379/0", # redis://host:port/db"OPTIONS": {"CLIENT_CLASS": "django_redis.client.DefaultClient","PASSWORD": ""}}
}
启动准备
# 数据库初始化
python3 manage.py makemigrations sql
python3 manage.py migrate # 数据初始化
python3 manage.py dbshell<sql/fixtures/auth_group.sql
python3 manage.py dbshell<src/init_sql/mysql_slow_query_review.sql# 创建管理用户
python3 manage.py createsuperuser

runserver启动（仅作为本地测试）
source /opt/venv4archery/bin/activate
#启动Django-Q，需保持后台运行
python3 manage.py qcluster
#启动服务
python3 manage.py runserver 0.0.0.0:9123  --insecure   
Gunicorn+Nginx启动
# nginx配置示例  
server{listen 9123; # 监听的端口server_name archery;client_max_body_size 20M; # 处理Request Entity Too Largeproxy_read_timeout 600s;  # 超时时间与Gunicorn超时时间设置一致，主要用于在线查询location / {proxy_pass http://127.0.0.1:8000;proxy_set_header Host $host:9123; # 解决重定向404的问题，和listen端口保持一致，如果是docker则和宿主机映射端口保持一致proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header X-Forwarded-Proto $scheme;}location /static {alias /opt/archery/static; # 此处指向settings.py配置项STATIC_ROOT目录的绝对路径，用于nginx收集静态资源}error_page 404 /404.html;location = /40x.html {}error_page 500 502 503 504 /50x.html;location = /50x.html {}} 
# 启动  
source /opt/venv4archery/bin/activate
bash startup.sh
访问
http://$IP:9123/启动后配置
在启动后 Archery 有一些配置(如Inception , 资源组, 权限组等)需要按需配置, 请详细阅读 配置项说明 , 按照自己的需要进行配置。

三、总结

优点

• 支持多种数据源
• 功能完善

缺点

• 对于非MySQL的数据源功能支持较差
• 审核规则难以自定义修改