為什么要使用ODBC連接SQL Server?
ODBC是什么?
ODBC是什么?我也不知道,用摘抄一個互聯(lián)網(wǎng)上的話來解釋:ODBC英文全稱為:Open Database Connectivity。用于在不同的操作系統(tǒng)和數(shù)據(jù)庫管理系統(tǒng)之間進(jìn)行數(shù)據(jù)訪問的標(biāo)準(zhǔn)化接口。它提供了一組函數(shù)和API,使得應(yīng)用程序可以通過統(tǒng)一的方式訪問不同類型的數(shù)據(jù)源。大多數(shù)數(shù)據(jù)源都有適用的 ODBC 驅(qū)動程序。
那么ODBC和ADO.NET以及JDBC的關(guān)系是什么?讓GPT來回答一下吧:
ODBC(Open Database Connectivity)和ADO.NET(ActiveX Data Objects .NET)是 Microsoft 開發(fā)的數(shù)據(jù)庫訪問接口。而 JDBC(Java Database Connectivity)則是由 Sun Microsystems 開發(fā)的 Java 數(shù)據(jù)庫訪問標(biāo)準(zhǔn)。
ODBC 和 JDBC 都提供了一種通用的方式來訪問數(shù)據(jù)庫,允許開發(fā)人員使用標(biāo)準(zhǔn) SQL 語句來操作各種不同類型的數(shù)據(jù)庫。ADO.NET則是微軟針對 .NET 平臺開發(fā)的數(shù)據(jù)庫訪問接口,提供了與 ODBC 類似的功能,但更加面向?qū)ο螅哂懈玫男阅芎涂蓴U展性。
為什么要使用ODBC而不使用EFCore?
我也想使用EFCore或者其他的ORM框架,但是走不通!首先場景是這樣子的,我們業(yè)務(wù)中有一個地方需要去連接甲方的數(shù)據(jù)庫,然后查詢數(shù)據(jù),這個時候我們是使用的System.Data.SqlClient+Dapper來執(zhí)行SQL查詢的,可是一直報錯,大概信息就是類似下面這些
// 因為修改了好幾次,所以信息我已經(jīng)對不上了,大概出現(xiàn)了下面的這些
Connection Timeout Expired. The timeout period elapsed during the post-login phase. The connection could have timed out while waiting for server to complete the login process and respond; Or it could have timed out while attempting to create multiple active connections. The duration spent while attempting to connect to this server was - [Pre-Login] initialization=3; handshake=10; [Login] initialization=0; authentication=0; [Post-Login] complete=14074;
或者
Microsoft.Data.SqlClient.SqlException (0x80131904): A connection was successfully established with the server, but then an error occurred during the pre-login handshake.
(provider: SSL Provider, error: 31 - Encryption(ssl/tls) handshake failed)
System.IO.EndOfStreamException: End of stream reached
或者
SSL Handshake failed with OpenSSL error - SSL_ERROR_SSL。
遇到這個問題,我們首先想在連接字符串上操作去修復(fù)解決這個問題,但是最后沒有解決,我們想在公司復(fù)現(xiàn),首先直接在我自己電腦本地連接sqlserver2019是沒有問題的,然后沒辦法又在服務(wù)器安裝了sqlserver2008也沒有問題(這里我還傻不拉幾想著使用容器部署一個sqlserver2008快,然后信了一個博客老哥的鬼話去拉取他的鏡像,結(jié)果拉取下來是2019版本的,后來查閱資料才知道sqlserver2008哪里有什么鏡像),然后又模擬正式環(huán)境容器化部署,然后終于復(fù)現(xiàn)了上面的錯誤,然后就開始嘗試,我們也在網(wǎng)絡(luò)上查閱了資料,終于在一個文章上看到sqlserver2008不支持TLS1.2,然后按照那個文檔的方法去降低容器TSL版本,比如dockerfile增加
RUN sed -i 's/MinProtocol = TLSv1.2/MinProtocol = TLSv1/g' /etc/ssl/openssl.cnf
RUN sed -i 's/MinProtocol = TLSv1.2/MinProtocol = TLSv1/g' /usr/lib/ssl/openssl.cnf
結(jié)果還是不行,錯誤變了,繼續(xù)查閱文章,然后終于找到【嘿dotNet】公眾號老哥的一個博客,他在2019年遇到了這個問題,我將他總結(jié)性的那部分摘抄出來
.net core 的System.Data.SqlClient支持的最低SqlServer版本是2008 r2 SP3,小于這個版本的就會報這個錯。
來源:https://github.com/dotnet/corefx/issues/9719
結(jié)論:.netcore 連接使用sqlserver遇到以上報錯1、報錯2的同學(xué),需注意:**.net core 的System.Data.SqlClient支持的最低SqlServer版本是2008 r2 SP3**請先檢查數(shù)據(jù)庫版本。
呼~這個鬼問題浪費了我整整兩天+(3個熬夜)
文章地址:https://www.cnblogs.com/xiaxiaolu/p/10309064.html
雖然這個文章的評論中也提到了升級數(shù)據(jù)庫版本可以解決,但是?甲方那邊升級數(shù)據(jù)庫肯定不現(xiàn)實的,那只好考慮換個組件什么的?我也嘗試了EFCore依賴的包Microsoft.Data.SqlClient也是不行,所以這個時候就咨詢其他部門(java)那邊連接正常不?他們回復(fù)沒有問題,然后就產(chǎn)生了要不再搞個java服務(wù)去連接的念頭???這多尷尬,連接微軟家的數(shù)據(jù)庫還需要去麻煩其他語言???
領(lǐng)導(dǎo)說再找找資料 。。。然后就找到了Microsoft ODBC Driver for SQL Server
開始操作
在Nuget上搜索odbc,排名第一個的一個包是微軟和dotnetframework維護(hù)的,最近一次更新在幾天前,還是8.0.0版本怪新,那就根據(jù)文檔去操作吧,這里需要注意的是使用ODBC去操作數(shù)據(jù)庫是需要手動安裝驅(qū)動的,比如我本地調(diào)試需要去下載驅(qū)動安裝
下面來演示一個連接的小示例,新建一個控制臺項目名字叫做MsSqlNetCoreOdbc(這里我直接創(chuàng)建.Net6的控制臺項目),然后安裝nuget包
<ItemGroup>
<PackageReference Include="System.Data.Odbc" Version="6.0.1" />
</ItemGroup>
編寫如下代碼
using System.Data.Odbc;
try
{
var str = "Server=xxxx;Database=dbName;Uid=sa;Pwd=123xxxx;Encrypt=no;driver=ODBC Driver 18 for SQL Server";
await using var connection = new OdbcConnection(str);
connection.Open();
string sqlQuery = "Select @@version";
var command = new OdbcCommand(sqlQuery, connection);
var reader = command.ExecuteScalar();
Console.WriteLine(reader.ToString());
Console.WriteLine("conn success");
Console.WriteLine("over");
}
catch (Exception ex)
{
Console.WriteLine($"message:{ex.Message} stackTrace:{ex.StackTrace}");
}
Console.ReadLine();
這里光看這個示例的話,和之前使用System.Data.SqlClient的改動確實不大,換了一個包,使用OdbcConnection創(chuàng)建DbConnection(需要注意的是如果你要使用到參數(shù)化等就需要注意了,它的參數(shù)化不是@key,而是?key? 我??)
這里在安裝好驅(qū)動的情況下直接運行代碼啟動調(diào)試,會輸出下面的信息
Microsoft SQL Server 2008 R2 (RTM) - 10.50.1600.1 (X64)
Apr 2 2010 15:48:46
Copyright (c) Microsoft Corporation
Enterprise Edition (64-bit) on Windows NT 6.2 <X64> (Build 9200: ) (Hypervisor)
conn success
over
然后就要容器化部署測試是否可行了,那么按照官網(wǎng)的文章以及互聯(lián)網(wǎng)上的資料去拼湊嘗試給容器安裝驅(qū)動,官網(wǎng)文章地址在最下面 ,比如看他Ubuntu的示例
if ! [[ "18.04 20.04 22.04 23.04" == *"$(lsb_release -rs)"* ]];
then
echo "Ubuntu $(lsb_release -rs) is not currently supported.";
exit;
fi
curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
curl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list
sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y apt-get install -y mssql-tools18
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install -y unixodbc-dev
嘗試去容器化部署吧,選中控制臺項目右鍵添加dockerfile文件,并且做下面的修改
? 降低容器tls版本
? 安裝odbc操作驅(qū)動
最后dockerfile需要增加以下內(nèi)容
RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list && apt-get update && \
apt-get install -y unixodbc unixodbc-dev curl
RUN curl https://packages.microsoft.com/keys/microsoft.asc | tee /etc/apt/trusted.gpg.d/microsoft.asc && curl https://packages.microsoft.com/config/debian/11/prod.list > /etc/apt/sources.list.d/mssql-release.list && \
apt-get update && \
ACCEPT_EULA=Y apt-get install -y msodbcsql18 && \
apt-get clean -y && \
rm -rf /var/lib/apt/lists/*
COPY ./MSSQL_NetCore_Odbc/odbcinst.ini /etc/odbcinst.ini
RUN sed -i 's/MinProtocol = TLSv1.2/MinProtocol = TLSv1/g' /etc/ssl/openssl.cnf
RUN sed -i 's/MinProtocol = TLSv1.2/MinProtocol = TLSv1/g' /usr/lib/ssl/openssl.cnf
其中odbcinst.ini內(nèi)容為
[ODBC Driver 18 for SQL Server]
Description=Microsoft ODBC Driver 18 for SQL Server
Driver=/opt/microsoft/msodbcsql18/lib64/libmsodbcsql-18.3.so.2.1
UsageCount=1
然后重新啟動生成容器,發(fā)現(xiàn)已經(jīng)連接成功,輸出信息如下
圖片
連接成功,結(jié)束
參考資料
Microsoft ODBC Driver for SQL Server:https://learn.microsoft.com/zh-cn/sql/connect/odbc/microsoft-odbc-driver-for-sql-server?view=sql-server-ver16
SSL Handshake failed with OpenSSL error - SSL_ERROR_SSL:https://www.cnblogs.com/printertool/p/14084385.html
https://www.cnblogs.com/yuanzhongkui/p/4022557.html 連接sqlsever
Connection open error . Connection Timeout Expired. The timeout period elapsed during the post-login phase.
驅(qū)動下載地址:https://learn.microsoft.com/zh-cn/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16