调试Archery连接SQL Server提示驱动错误

当我们在调试Archery的时候，连接SQL Server 会报错，而MySQL部分没有问题。报错信息如下：

Error: ('01000', "[01000] [unixODBC][Driver Manager]Can't open lib 'ODBC Driver 17 for SQL Server' : file not found (0) (SQLDriverConnect)")

记录下 我们是怎么定位问题、寻找技术文档帮助、和安装相关组件的。

1.定位关键代码

通过报错路径和设置断点，很快定位的报错代码。

其路径为 

/sql/engines/mssql.py

报错的方法是get_connection，具体代码

    def get_connection(self, db_name=None):
        connstr = """DRIVER=ODBC Driver 17 for SQL Server;SERVER={0},{1};UID={2};PWD={3};
client charset = UTF-8;connect timeout=10;CHARSET={4};""".format(self.host, self.port, self.user, self.password,
                                                                 self.instance.charset or 'UTF8')
        if self.conn:
            return self.conn
        self.conn = pyodbc.connect(connstr)
        return self.conn

相对比较简单，没啥逻辑。

2.寻找技术文档

主要还是 https://archerydms.com/ 官方文档

step 1 点击 【快速开始】

step 2 找到部署相关的文档

 step 3 选择 手动部署 部分

 Step 4  选择其中的SQL Server 部分 【安装 MS SQL Server 驱动(需要使用MsSQL的按需安装)】

 3.安装相关组件

上面的具体要求和步骤如下

# 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

如果yum源 或者 本地server 可以上外网，则安装要求之间运行安装即可。

下面我们看看，如果因为yum源和上网权限， server之间 yum不行怎么办？ 

我们把上面的执行拆解掉

step 1 因为 Server是 CentOS 7 ，所以，我们在可上Intent 的电脑上运行

https://packages.microsoft.com/config/rhel/7/prod.repo

下载 prod.repo 文件

step 2  用记事本方式 打开  prod.repo

里面的内容如下：

[packages-microsoft-com-prod]
name=packages-microsoft-com-prod
baseurl=https://packages.microsoft.com/rhel/7/prod/
enabled=1
gpgcheck=1
gpgkey=https://packages.microsoft.com/keys/microsoft.asc

step 3 打开访问其中的 baseurl

网址 https://packages.microsoft.com/rhel/7/prod/

看到其中是 各个 组件大全，包含各种组件包

step 4 在界面上Ctrl + F ，查找 到【msodbcsql17】 【mssql-tools】，找到 合适版本分别进行下载。

查找msodbcsql17

 查找mssql-tools

 

注意，因本地已安装 unixODBC-devel，所以，无需安装。只要安装上面的两个组件就可以了，其他任何操作都不需要了，即相当于 只执行建议中的

# 安装驱动
sudo ACCEPT_EULA=Y yum install msodbcsql17
sudo ACCEPT_EULA=Y yum install mssql-tools

step 4 将下载的rpm 文件 上传的服务器上，通过  yum  localinstall 插件名 命令分别安装即可。

step 5 安装需要的组件后，再次调试，报错消失了。

4.说明

梳理整理记录于此，希望遇到类似情况，有所帮助，减少不必要的探索和挣扎。